@agentuity/react 0.0.69 → 0.0.70

package/dist/api.d.ts

@@ -0,0 +1,196 @@
+import type { InferInput, InferOutput } from '@agentuity/core';
+import type { RouteRegistry } from './types';
+/**
+ * Extract route keys from RouteRegistry (e.g., 'GET /users', 'POST /users')
+ */
+export type RouteKey = keyof RouteRegistry;
+/**
+ * Extract HTTP method from route key
+ */
+export type ExtractMethod<TRoute extends RouteKey> = TRoute extends `${infer Method} ${string}` ? Method : never;
+/**
+ * Extract input type for a specific route
+ */
+export type RouteInput<TRoute extends RouteKey> = TRoute extends keyof RouteRegistry ? RouteRegistry[TRoute] extends {
+    inputSchema: any;
+} ? InferInput<RouteRegistry[TRoute]['inputSchema']> : never : never;
+/**
+ * Extract output type for a specific route
+ * Returns void if no outputSchema is defined (e.g., 204 No Content)
+ */
+export type RouteOutput<TRoute extends RouteKey> = TRoute extends keyof RouteRegistry ? RouteRegistry[TRoute] extends {
+    outputSchema: infer TSchema;
+} ? TSchema extends undefined | never ? void : InferOutput<TSchema> : void : void;
+/**
+ * Common options shared by all UseAPI configurations
+ */
+type UseAPICommonOptions<TRoute extends RouteKey> = {
+    /** Additional query parameters */
+    query?: URLSearchParams | Record<string, string>;
+    /** Additional request headers */
+    headers?: Record<string, string>;
+    /** Whether to execute the request immediately on mount (default: true for GET, false for others) */
+    enabled?: boolean;
+    /** How long data stays fresh before refetching (ms, default: 0 - always stale) */
+    staleTime?: number;
+    /** Refetch interval in milliseconds (default: disabled) */
+    refetchInterval?: number;
+    /** Callback when request succeeds */
+    onSuccess?: (data: RouteOutput<TRoute>) => void;
+    /** Callback when request fails */
+    onError?: (error: Error) => void;
+} & (ExtractMethod<TRoute> extends 'GET' ? {
+    /** GET requests cannot have input (use query params instead) */
+    input?: never;
+} : {
+    /** Input data for the request (required for POST/PUT/PATCH/DELETE) */
+    input?: RouteInput<TRoute>;
+});
+/**
+ * Options with route property (e.g., { route: 'GET /users' })
+ */
+type UseAPIOptionsWithRoute<TRoute extends RouteKey> = UseAPICommonOptions<TRoute> & {
+    /** Route key (e.g., 'GET /users', 'POST /users') */
+    route: TRoute;
+    /** Method cannot be specified when using route */
+    method?: never;
+    /** Path cannot be specified when using route */
+    path?: never;
+};
+/**
+ * Options with method and path properties (e.g., { method: 'GET', path: '/users' })
+ */
+type UseAPIOptionsWithMethodPath<TRoute extends RouteKey> = UseAPICommonOptions<TRoute> & {
+    /** HTTP method (e.g., 'GET', 'POST') */
+    method: ExtractMethod<TRoute>;
+    /** Request path (e.g., '/users') */
+    path: string;
+    /** Route cannot be specified when using method/path */
+    route?: never;
+};
+/**
+ * Options for useAPI hook with smart input typing based on HTTP method
+ * Supports either route OR {method, path} but not both
+ */
+export type UseAPIOptions<TRoute extends RouteKey> = UseAPIOptionsWithRoute<TRoute> | UseAPIOptionsWithMethodPath<TRoute>;
+/**
+ * Base return value from useAPI hook (without data property or execute)
+ */
+interface UseAPIResultBase {
+    /** Error if request failed */
+    error: Error | null;
+    /** Whether request is currently in progress */
+    isLoading: boolean;
+    /** Whether request has completed successfully at least once */
+    isSuccess: boolean;
+    /** Whether request has failed */
+    isError: boolean;
+    /** Whether data is currently being fetched (including refetches) */
+    isFetching: boolean;
+    /** Reset state to initial values */
+    reset: () => void;
+}
+/**
+ * Return value for GET requests (auto-executing)
+ */
+type UseAPIResultQuery<TRoute extends RouteKey> = UseAPIResultBase & (RouteOutput<TRoute> extends void ? {
+    /** No data property - route returns no content (204 No Content) */
+    data?: never;
+    /** Manually trigger a refetch */
+    refetch: () => Promise<void>;
+} : {
+    /** Response data (undefined until loaded) */
+    data: RouteOutput<TRoute> | undefined;
+    /** Manually trigger a refetch */
+    refetch: () => Promise<void>;
+});
+/**
+ * Return value for POST/PUT/PATCH/DELETE requests (manual execution)
+ */
+type UseAPIResultMutation<TRoute extends RouteKey> = UseAPIResultBase & (RouteOutput<TRoute> extends void ? {
+    /** No data property - route returns no content (204 No Content) */
+    data?: never;
+    /** Invoke the mutation with required input */
+    invoke: RouteInput<TRoute> extends never ? () => Promise<void> : (input: RouteInput<TRoute>) => Promise<void>;
+} : {
+    /** Response data (undefined until invoked) */
+    data: RouteOutput<TRoute> | undefined;
+    /** Invoke the mutation with required input */
+    invoke: RouteInput<TRoute> extends never ? () => Promise<RouteOutput<TRoute>> : (input: RouteInput<TRoute>) => Promise<RouteOutput<TRoute>>;
+});
+/**
+ * Return value from useAPI hook
+ * - GET requests: Auto-executes, returns refetch()
+ * - POST/PUT/PATCH/DELETE: Manual execution, returns execute(input)
+ */
+export type UseAPIResult<TRoute extends RouteKey> = ExtractMethod<TRoute> extends 'GET' ? UseAPIResultQuery<TRoute> : UseAPIResultMutation<TRoute>;
+/**
+ * Type-safe API client hook with TanStack Query-inspired features.
+ *
+ * Provides automatic type inference for route inputs and outputs based on
+ * the RouteRegistry generated from your routes.
+ *
+ * **Smart input typing:**
+ * - GET requests: `input` is `never` (use `query` params instead)
+ * - POST/PUT/PATCH/DELETE: `input` is properly typed from route schema
+ *
+ * @template TRoute - Route key from RouteRegistry (e.g., 'GET /users')
+ *
+ * @example Simple GET request with string
+ * ```typescript
+ * const { data, isLoading } = useAPI('GET /users');
+ * ```
+ *
+ * @example GET request with route property
+ * ```typescript
+ * const { data, isLoading } = useAPI({
+ *   route: 'GET /users',
+ *   query: { search: 'alice' }, // ✅ Use query params for GET
+ *   // input: { ... }, // ❌ TypeScript error - GET cannot have input!
+ *   staleTime: 5000,
+ * });
+ * ```
+ *
+ * @example GET request with method and path
+ * ```typescript
+ * const { data, isLoading } = useAPI({
+ *   method: 'GET',
+ *   path: '/users',
+ *   query: { search: 'alice' },
+ * });
+ * ```
+ *
+ * @example POST request with manual invocation
+ * ```typescript
+ * const { invoke, data, isLoading } = useAPI('POST /users');
+ *
+ * // Invoke manually with input
+ * await invoke({ name: 'Alice', email: 'alice@example.com' }); // ✅ Fully typed!
+ * // data now contains the created user
+ * ```
+ *
+ * @example GET with query parameters
+ * ```typescript
+ * const { data } = useAPI({
+ *   route: 'GET /search',
+ *   query: { q: 'react', limit: '10' },
+ * });
+ * ```
+ *
+ * @example DELETE with no response body (204 No Content)
+ * ```typescript
+ * const { invoke, isSuccess } = useAPI('DELETE /users/:id');
+ *
+ * // Invoke when needed
+ * await invoke({ reason: 'Account closed' });
+ *
+ * // result.data doesn't exist! ❌ TypeScript error
+ * // Use isSuccess instead ✅
+ * if (isSuccess) {
+ *   console.log('User deleted');
+ * }
+ * ```
+ */
+export declare function useAPI<TRoute extends RouteKey>(routeOrOptions: TRoute | UseAPIOptions<TRoute>): UseAPIResult<TRoute>;
+export {};
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAI/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC;AAE3C;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,MAAM,SAAS,QAAQ,IAAI,MAAM,SAAS,GAAG,MAAM,MAAM,IAAI,MAAM,EAAE,GAC5F,MAAM,GACN,KAAK,CAAC;AAET;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,MAAM,SAAS,QAAQ,IAAI,MAAM,SAAS,MAAM,aAAa,GACjF,aAAa,CAAC,MAAM,CAAC,SAAS;IAAE,WAAW,EAAE,GAAG,CAAA;CAAE,GACjD,UAAU,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC,GAChD,KAAK,GACN,KAAK,CAAC;AAET;;;GAGG;AACH,MAAM,MAAM,WAAW,CAAC,MAAM,SAAS,QAAQ,IAAI,MAAM,SAAS,MAAM,aAAa,GAClF,aAAa,CAAC,MAAM,CAAC,SAAS;IAAE,YAAY,EAAE,MAAM,OAAO,CAAA;CAAE,GAC5D,OAAO,SAAS,SAAS,GAAG,KAAK,GAChC,IAAI,GACJ,WAAW,CAAC,OAAO,CAAC,GACrB,IAAI,GACL,IAAI,CAAC;AAER;;GAEG;AACH,KAAK,mBAAmB,CAAC,MAAM,SAAS,QAAQ,IAAI;IACnD,kCAAkC;IAClC,KAAK,CAAC,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,oGAAoG;IACpG,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qCAAqC;IACrC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IAChD,kCAAkC;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,SAAS,KAAK,GACrC;IACA,gEAAgE;IAChE,KAAK,CAAC,EAAE,KAAK,CAAC;CACd,GACA;IACA,sEAAsE;IACtE,KAAK,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;CAC3B,CAAC,CAAC;AAEL;;GAEG;AACH,KAAK,sBAAsB,CAAC,MAAM,SAAS,QAAQ,IAAI,mBAAmB,CAAC,MAAM,CAAC,GAAG;IACpF,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,gDAAgD;IAChD,IAAI,CAAC,EAAE,KAAK,CAAC;CACb,CAAC;AAEF;;GAEG;AACH,KAAK,2BAA2B,CAAC,MAAM,SAAS,QAAQ,IAAI,mBAAmB,CAAC,MAAM,CAAC,GAAG;IACzF,wCAAwC;IACxC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,KAAK,CAAC,EAAE,KAAK,CAAC;CACd,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,MAAM,SAAS,QAAQ,IAC9C,sBAAsB,CAAC,MAAM,CAAC,GAC9B,2BAA2B,CAAC,MAAM,CAAC,CAAC;AAEvC;;GAEG;AACH,UAAU,gBAAgB;IACzB,8BAA8B;IAC9B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,+CAA+C;IAC/C,SAAS,EAAE,OAAO,CAAC;IACnB,+DAA+D;IAC/D,SAAS,EAAE,OAAO,CAAC;IACnB,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,UAAU,EAAE,OAAO,CAAC;IACpB,oCAAoC;IACpC,KAAK,EAAE,MAAM,IAAI,CAAC;CAClB;AAED;;GAEG;AACH,KAAK,iBAAiB,CAAC,MAAM,SAAS,QAAQ,IAAI,gBAAgB,GACjE,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,IAAI,GAC9B;IACA,mEAAmE;IACnE,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,iCAAiC;IACjC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B,GACA;IACA,6CAA6C;IAC7C,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACtC,iCAAiC;IACjC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B,CAAC,CAAC;AAEN;;GAEG;AACH,KAAK,oBAAoB,CAAC,MAAM,SAAS,QAAQ,IAAI,gBAAgB,GACpE,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,IAAI,GAC9B;IACA,mEAAmE;IACnE,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,8CAA8C;IAC9C,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,SAAS,KAAK,GACrC,MAAM,OAAO,CAAC,IAAI,CAAC,GACnB,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD,GACA;IACA,8CAA8C;IAC9C,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACtC,8CAA8C;IAC9C,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,SAAS,KAAK,GACrC,MAAM,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAClC,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;CAC/D,CAAC,CAAC;AAEN;;;;GAIG;AACH,MAAM,MAAM,YAAY,CAAC,MAAM,SAAS,QAAQ,IAC/C,aAAa,CAAC,MAAM,CAAC,SAAS,KAAK,GAAG,iBAAiB,CAAC,MAAM,CAAC,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAwBhG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkEG;AACH,wBAAgB,MAAM,CAAC,MAAM,SAAS,QAAQ,EAC7C,cAAc,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,GAC5C,YAAY,CAAC,MAAM,CAAC,CA8QtB"}

package/dist/api.js

@@ -0,0 +1,325 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { useCallback, useContext, useEffect, useRef, useState } from 'react';
+import { AgentuityContext } from './context';
+import { deserializeData } from './serialization';
+import { buildUrl } from './url';
+/**
+ * Parse route key into method and path
+ */
+function parseRouteKey(routeKey) {
+    const parts = routeKey.split(' ');
+    if (parts.length !== 2) {
+        throw new Error(`Invalid route key format: "${routeKey}". Expected "METHOD /path"`);
+    }
+    return { method: parts[0], path: parts[1] };
+}
+/**
+ * Convert query object to URLSearchParams
+ */
+function toSearchParams(query) {
+    if (!query)
+        return undefined;
+    if (query instanceof URLSearchParams)
+        return query;
+    return new URLSearchParams(query);
+}
+/**
+ * Type-safe API client hook with TanStack Query-inspired features.
+ *
+ * Provides automatic type inference for route inputs and outputs based on
+ * the RouteRegistry generated from your routes.
+ *
+ * **Smart input typing:**
+ * - GET requests: `input` is `never` (use `query` params instead)
+ * - POST/PUT/PATCH/DELETE: `input` is properly typed from route schema
+ *
+ * @template TRoute - Route key from RouteRegistry (e.g., 'GET /users')
+ *
+ * @example Simple GET request with string
+ * ```typescript
+ * const { data, isLoading } = useAPI('GET /users');
+ * ```
+ *
+ * @example GET request with route property
+ * ```typescript
+ * const { data, isLoading } = useAPI({
+ *   route: 'GET /users',
+ *   query: { search: 'alice' }, // ✅ Use query params for GET
+ *   // input: { ... }, // ❌ TypeScript error - GET cannot have input!
+ *   staleTime: 5000,
+ * });
+ * ```
+ *
+ * @example GET request with method and path
+ * ```typescript
+ * const { data, isLoading } = useAPI({
+ *   method: 'GET',
+ *   path: '/users',
+ *   query: { search: 'alice' },
+ * });
+ * ```
+ *
+ * @example POST request with manual invocation
+ * ```typescript
+ * const { invoke, data, isLoading } = useAPI('POST /users');
+ *
+ * // Invoke manually with input
+ * await invoke({ name: 'Alice', email: 'alice@example.com' }); // ✅ Fully typed!
+ * // data now contains the created user
+ * ```
+ *
+ * @example GET with query parameters
+ * ```typescript
+ * const { data } = useAPI({
+ *   route: 'GET /search',
+ *   query: { q: 'react', limit: '10' },
+ * });
+ * ```
+ *
+ * @example DELETE with no response body (204 No Content)
+ * ```typescript
+ * const { invoke, isSuccess } = useAPI('DELETE /users/:id');
+ *
+ * // Invoke when needed
+ * await invoke({ reason: 'Account closed' });
+ *
+ * // result.data doesn't exist! ❌ TypeScript error
+ * // Use isSuccess instead ✅
+ * if (isSuccess) {
+ *   console.log('User deleted');
+ * }
+ * ```
+ */
+export function useAPI(routeOrOptions) {
+    // Normalize to options object
+    const options = typeof routeOrOptions === 'string'
+        ? { route: routeOrOptions }
+        : routeOrOptions;
+    const context = useContext(AgentuityContext);
+    const { input, query, headers, enabled, staleTime = 0, refetchInterval, onSuccess, onError, } = options;
+    if (!context) {
+        throw new Error('useAPI must be used within AgentuityProvider');
+    }
+    // Extract method and path from either route OR {method, path}
+    let method;
+    let path;
+    if ('route' in options && options.route) {
+        const parsed = parseRouteKey(options.route);
+        method = parsed.method;
+        path = parsed.path;
+    }
+    else if ('method' in options && 'path' in options && options.method && options.path) {
+        method = options.method;
+        path = options.path;
+    }
+    else {
+        throw new Error('useAPI requires either route OR {method, path}');
+    }
+    const [data, setData] = useState(undefined);
+    const [error, setError] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [isFetching, setIsFetching] = useState(false);
+    const [isSuccess, setIsSuccess] = useState(false);
+    const [isError, setIsError] = useState(false);
+    const lastFetchTimeRef = useRef(0);
+    // Track mounted state to prevent state updates after unmount
+    const mountedRef = useRef(true);
+    useEffect(() => {
+        mountedRef.current = true;
+        return () => {
+            mountedRef.current = false;
+        };
+    }, []);
+    const fetchData = useCallback(async () => {
+        if (!mountedRef.current)
+            return;
+        const now = Date.now();
+        const lastFetchTime = lastFetchTimeRef.current;
+        // Check if data is still fresh based on last fetch time
+        const isFresh = staleTime > 0 && lastFetchTime !== 0 && now - lastFetchTime < staleTime;
+        if (isFresh) {
+            return;
+        }
+        setIsFetching(true);
+        // isLoading = only for first load (or after reset)
+        if (lastFetchTime === 0) {
+            setIsLoading(true);
+        }
+        setError(null);
+        setIsError(false);
+        try {
+            const url = buildUrl(context.baseUrl || '', path, undefined, toSearchParams(query));
+            const requestInit = {
+                method,
+                headers: {
+                    'Content-Type': 'application/json',
+                    ...headers,
+                },
+            };
+            // Add body for non-GET requests
+            if (method !== 'GET' && input !== undefined) {
+                requestInit.body = JSON.stringify(input);
+            }
+            const response = await fetch(url, requestInit);
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            let responseData;
+            // Handle 204 No Content - no response body expected
+            if (response.status === 204) {
+                responseData = undefined;
+            }
+            else {
+                const contentType = response.headers.get('Content-Type') || '';
+                if (contentType.includes('application/json')) {
+                    responseData = await response.json();
+                }
+                else {
+                    const text = await response.text();
+                    responseData = deserializeData(text);
+                }
+            }
+            if (!mountedRef.current)
+                return;
+            // Use JSON memoization to prevent re-renders when data hasn't changed
+            setData((prev) => {
+                const newData = responseData;
+                if (prev !== undefined && JSON.stringify(prev) === JSON.stringify(newData)) {
+                    return prev;
+                }
+                return newData;
+            });
+            setIsSuccess(true);
+            lastFetchTimeRef.current = Date.now();
+            onSuccess?.(responseData);
+        }
+        catch (err) {
+            if (!mountedRef.current)
+                return;
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            setIsError(true);
+            onError?.(error);
+        }
+        finally {
+            if (mountedRef.current) {
+                setIsLoading(false);
+                setIsFetching(false);
+            }
+        }
+    }, [context.baseUrl, path, method, input, query, headers, staleTime, onSuccess, onError]);
+    const reset = useCallback(() => {
+        setData(undefined);
+        setError(null);
+        setIsLoading(false);
+        setIsFetching(false);
+        setIsSuccess(false);
+        setIsError(false);
+        lastFetchTimeRef.current = 0;
+    }, []);
+    // For GET requests: auto-fetch and provide refetch
+    if (method === 'GET') {
+        const refetch = useCallback(async () => {
+            await fetchData();
+        }, [fetchData]);
+        // Auto-fetch on mount if enabled (default: true for GET)
+        const shouldAutoFetch = enabled ?? true;
+        useEffect(() => {
+            if (shouldAutoFetch) {
+                fetchData();
+            }
+        }, [shouldAutoFetch, fetchData]);
+        // Refetch interval
+        useEffect(() => {
+            if (!refetchInterval || refetchInterval <= 0)
+                return;
+            const interval = setInterval(() => {
+                fetchData();
+            }, refetchInterval);
+            return () => clearInterval(interval);
+        }, [refetchInterval, fetchData]);
+        return {
+            data,
+            error,
+            isLoading,
+            isSuccess,
+            isError,
+            isFetching,
+            refetch,
+            reset,
+        };
+    }
+    // For POST/PUT/PATCH/DELETE: provide invoke method (manual invocation)
+    const invoke = useCallback(async (invokeInput) => {
+        // Use invokeInput parameter if provided
+        const effectiveInput = invokeInput !== undefined ? invokeInput : input;
+        setIsFetching(true);
+        setIsLoading(true);
+        setError(null);
+        setIsError(false);
+        try {
+            const url = buildUrl(context.baseUrl || '', path, undefined, toSearchParams(query));
+            const requestInit = {
+                method,
+                headers: {
+                    'Content-Type': 'application/json',
+                    ...headers,
+                },
+            };
+            if (effectiveInput !== undefined) {
+                requestInit.body = JSON.stringify(effectiveInput);
+            }
+            const response = await fetch(url, requestInit);
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            let responseData;
+            if (response.status === 204) {
+                responseData = undefined;
+            }
+            else {
+                const contentType = response.headers.get('Content-Type') || '';
+                if (contentType.includes('application/json')) {
+                    responseData = await response.json();
+                }
+                else {
+                    const text = await response.text();
+                    responseData = deserializeData(text);
+                }
+            }
+            if (!mountedRef.current)
+                return responseData;
+            setData(responseData);
+            setIsSuccess(true);
+            lastFetchTimeRef.current = Date.now();
+            onSuccess?.(responseData);
+            return responseData;
+        }
+        catch (err) {
+            if (!mountedRef.current)
+                throw err;
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            setIsError(true);
+            onError?.(error);
+            throw error;
+        }
+        finally {
+            if (mountedRef.current) {
+                setIsLoading(false);
+                setIsFetching(false);
+            }
+        }
+    }, [context.baseUrl, path, method, query, headers, input, onSuccess, onError]);
+    return {
+        data,
+        error,
+        isLoading,
+        isSuccess,
+        isError,
+        isFetching,
+        invoke,
+        reset,
+    };
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAKpD,CAAC"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAQpD,CAAC"}

package/dist/env.js

@@ -2,6 +2,9 @@ export const getProcessEnv = (key) => {
     if (typeof process !== 'undefined' && process.env) {
         return process.env[key];
     }
+    if (typeof import.meta.env !== 'undefined') {
+        return import.meta.env[key];
+    }
     return undefined;
 };
 //# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAW,EAAsB,EAAE;IAChE,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACnD,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC,CAAC"}
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAW,EAAsB,EAAE;IAChE,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACnD,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,WAAW,EAAE,CAAC;QAC5C,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC,CAAC"}

package/dist/eventstream.d.ts

@@ -1,13 +1,26 @@
 import type { InferOutput } from '@agentuity/core';
-import type { AgentName, AgentRegistry } from './types';
+import type { SSERouteRegistry } from './types';
 type onMessageHandler<T = unknown> = (data: T) => void;
-interface EventStreamArgs {
+/**
+ * Extract SSE route keys (e.g., '/events', '/notifications')
+ */
+export type SSERouteKey = keyof SSERouteRegistry;
+/**
+ * Extract output type for an SSE route (SSE is typically one-way server->client)
+ */
+export type SSERouteOutput<TRoute extends SSERouteKey> = TRoute extends keyof SSERouteRegistry ? SSERouteRegistry[TRoute] extends {
+    outputSchema: infer TSchema;
+} ? TSchema extends undefined | never ? void : InferOutput<TSchema> : void : void;
+/**
+ * Options for EventStream hooks
+ */
+export interface EventStreamOptions {
     /**
      * Optional query parameters to append to the EventStream URL
      */
     query?: URLSearchParams;
     /**
-     * Optional subpath to append to the agent path (such as /agent/:agent_name/:subpath)
+     * Optional subpath to append to the EventStream path
      */
     subpath?: string;
     /**
@@ -15,22 +28,48 @@ interface EventStreamArgs {
      */
     signal?: AbortSignal;
 }
-interface EventStreamResponse<TOutput> {
-    connected: boolean;
+interface EventStreamResponseInternal<TOutput> {
+    /** Whether EventStream is currently connected */
+    isConnected: boolean;
+    /** Most recent data received from EventStream */
     data?: TOutput;
+    /** Error if connection or message failed */
     error: Error | null;
+    /** Whether an error has occurred */
+    isError: boolean;
+    /** Set handler for incoming messages (use data property instead) */
     setHandler: (handler: onMessageHandler<TOutput>) => void;
+    /** EventStream connection state (CONNECTING=0, OPEN=1, CLOSED=2) */
     readyState: number;
+    /** Close the EventStream connection */
     close: () => void;
+    /** Reset state to initial values */
     reset: () => void;
 }
-export declare const useEventStream: <TOutput>(path: string, options?: EventStreamArgs) => EventStreamResponse<TOutput>;
-interface UseAgentEventStreamResponse<TOutput> extends Omit<EventStreamResponse<TOutput>, 'setHandler'> {
-    /**
-     * Data received from the agent via EventStream
-     */
-    data?: TOutput;
-}
-export declare const useAgentEventStream: <TName extends AgentName, TOutput = TName extends keyof AgentRegistry ? InferOutput<AgentRegistry[TName]["outputSchema"]> : never>(agent: TName, options?: EventStreamArgs) => UseAgentEventStreamResponse<TOutput>;
+/**
+ * Type-safe EventStream (SSE) hook for connecting to SSE routes.
+ *
+ * Provides automatic type inference for route outputs based on
+ * the SSERouteRegistry generated from your routes.
+ *
+ * @template TRoute - SSE route key from SSERouteRegistry (e.g., '/events', '/notifications')
+ *
+ * @example Simple SSE connection
+ * ```typescript
+ * const { isConnected, data } = useEventStream('/events');
+ *
+ * // data is fully typed based on route output schema!
+ * ```
+ *
+ * @example SSE with query parameters
+ * ```typescript
+ * const { isConnected, data } = useEventStream('/notifications', {
+ *   query: new URLSearchParams({ userId: '123' })
+ * });
+ * ```
+ */
+export declare function useEventStream<TRoute extends SSERouteKey>(route: TRoute, options?: EventStreamOptions): Omit<EventStreamResponseInternal<SSERouteOutput<TRoute>>, 'setHandler'> & {
+    data?: SSERouteOutput<TRoute>;
+};
 export {};
 //# sourceMappingURL=eventstream.d.ts.map

package/dist/eventstream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eventstream.d.ts","sourceRoot":"","sources":["../src/eventstream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAIxD,KAAK,gBAAgB,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAEvD,UAAU,eAAe;IACxB;;OAEG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,UAAU,mBAAmB,CAAC,OAAO;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,CAAC,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,KAAK,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,eAAO,MAAM,cAAc,GAAI,OAAO,EACrC,MAAM,MAAM,EACZ,UAAU,eAAe,KACvB,mBAAmB,CAAC,OAAO,CA+I7B,CAAC;AAEF,UAAU,2BAA2B,CAAC,OAAO,CAC5C,SAAQ,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IACxD;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CACf;AAED,eAAO,MAAM,mBAAmB,GAC/B,KAAK,SAAS,SAAS,EACvB,OAAO,GAAG,KAAK,SAAS,MAAM,aAAa,GACxC,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,CAAC,GACjD,KAAK,EAER,OAAO,KAAK,EACZ,UAAU,eAAe,KACvB,2BAA2B,CAAC,OAAO,CAmBrC,CAAC"}
+{"version":3,"file":"eventstream.d.ts","sourceRoot":"","sources":["../src/eventstream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAMnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,KAAK,gBAAgB,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,gBAAgB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,MAAM,SAAS,WAAW,IAAI,MAAM,SAAS,MAAM,gBAAgB,GAC3F,gBAAgB,CAAC,MAAM,CAAC,SAAS;IAAE,YAAY,EAAE,MAAM,OAAO,CAAA;CAAE,GAC/D,OAAO,SAAS,SAAS,GAAG,KAAK,GAChC,IAAI,GACJ,WAAW,CAAC,OAAO,CAAC,GACrB,IAAI,GACL,IAAI,CAAC;AAER;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC;;OAEG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,UAAU,2BAA2B,CAAC,OAAO;IAC5C,iDAAiD;IACjD,WAAW,EAAE,OAAO,CAAC;IACrB,iDAAiD;IACjD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,4CAA4C;IAC5C,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,UAAU,EAAE,CAAC,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IACzD,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,oCAAoC;IACpC,KAAK,EAAE,MAAM,IAAI,CAAC;CAClB;AA8JD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,MAAM,SAAS,WAAW,EACxD,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,kBAAkB,GAC1B,IAAI,CAAC,2BAA2B,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,GAAG;IAC5E,IAAI,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;CAC9B,CAkBA"}