allem-sdk 0.1.1 → 0.1.3

package/README.md

@@ -3,16 +3,17 @@
 </p>
 
 <p align="center">
+  <a href="https://www.npmjs.com/package/allem-sdk"><img src="https://img.shields.io/npm/v/allem-sdk.svg" alt="npm version" /></a>
   <a href="https://github.com/kingofmit/allem-sdk/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License" /></a>
   <img src="https://img.shields.io/badge/react-19-61dafb" alt="React 19" />
   <img src="https://img.shields.io/badge/typescript-strict-blue" alt="TypeScript" />
   <img src="https://img.shields.io/badge/AI_SDK-v6-black" alt="AI SDK v6" />
-  <img src="https://img.shields.io/badge/tests-44_passing-brightgreen" alt="Tests" />
+  <img src="https://img.shields.io/badge/tests-53_passing-brightgreen" alt="Tests" />
 </p>
 
 # allem-sdk
 
-The complete Allem SDK for React — hooks, AI, forms, analytics, and auth in a single install.
+The complete Allem SDK for React. Hooks, AI, forms, analytics, and auth in a single install.
 
 ## Installation
 
@@ -25,6 +26,7 @@ Or install individual packages:
 ```bash
 npm install @allem-sdk/hooks       # React hooks
 npm install @allem-sdk/ai          # AI chat & completions
+npm install @allem-sdk/agents      # Agentic AI with tool calling
 npm install @allem-sdk/forms       # Form management
 npm install @allem-sdk/analytics   # Analytics tracking
 npm install @allem-sdk/auth        # Authentication
@@ -47,19 +49,20 @@ import { useDebounce, useAllemChat, useForm, useAuth } from "allem-sdk";
 
 | Package | Description |
 |---------|-------------|
-| [`@allem-sdk/hooks`](https://www.npmjs.com/package/@allem-sdk/hooks) | 8 essential React hooks — useDebounce, useLocalStorage, useMediaQuery, and more |
-| [`@allem-sdk/ai`](https://www.npmjs.com/package/@allem-sdk/ai) | AI hooks built on Vercel AI SDK v6 — multi-provider chat & completions |
+| [`@allem-sdk/hooks`](https://www.npmjs.com/package/@allem-sdk/hooks) | 8 essential React hooks: useDebounce, useLocalStorage, useMediaQuery, and more |
+| [`@allem-sdk/ai`](https://www.npmjs.com/package/@allem-sdk/ai) | AI hooks built on Vercel AI SDK v6 with multi-provider chat & completions |
+| [`@allem-sdk/agents`](https://www.npmjs.com/package/@allem-sdk/agents) | Agentic AI with tool calling, status tracking, and typed tool definitions |
 | [`@allem-sdk/forms`](https://www.npmjs.com/package/@allem-sdk/forms) | Lightweight form management with 9 built-in validators |
-| [`@allem-sdk/analytics`](https://www.npmjs.com/package/@allem-sdk/analytics) | Provider-agnostic analytics — works with Mixpanel, Segment, PostHog, etc. |
-| [`@allem-sdk/auth`](https://www.npmjs.com/package/@allem-sdk/auth) | Authentication helpers — session management, protected routes |
+| [`@allem-sdk/analytics`](https://www.npmjs.com/package/@allem-sdk/analytics) | Provider-agnostic analytics. Works with Mixpanel, Segment, PostHog, etc. |
+| [`@allem-sdk/auth`](https://www.npmjs.com/package/@allem-sdk/auth) | Authentication helpers with session management and protected routes |
 
 ## Features
 
-- **SSR-safe** — works with Next.js, Vite, and Remix out of the box
-- **TypeScript strict** — full type safety with exported types
-- **Zero lock-in** — adapter pattern for AI, analytics, and auth providers
-- **Tree-shakeable** — ESM + CJS builds, import only what you need
-- **Lightweight** — no heavy dependencies, just React hooks
+- **SSR-safe** works with Next.js, Vite, and Remix out of the box
+- **TypeScript strict** with full type safety and exported types
+- **Zero lock-in** via adapter pattern for AI, analytics, and auth providers
+- **Tree-shakeable** ESM + CJS builds, import only what you need
+- **Lightweight** with no heavy dependencies, just React hooks
 
 ## Part of Allem SDK
 

package/dist/agents.d.mts

@@ -0,0 +1,6 @@
+export * from '@allem-sdk/agents';
+import '@allem-sdk/ai';
+import '@allem-sdk/analytics';
+import '@allem-sdk/auth';
+import '@allem-sdk/forms';
+import '@allem-sdk/hooks';

package/dist/agents.d.ts

@@ -0,0 +1,6 @@
+export * from '@allem-sdk/agents';
+import '@allem-sdk/ai';
+import '@allem-sdk/analytics';
+import '@allem-sdk/auth';
+import '@allem-sdk/forms';
+import '@allem-sdk/hooks';

package/dist/agents.js

@@ -0,0 +1,25 @@
+"use client";
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/agents.ts
+var agents_exports = {};
+module.exports = __toCommonJS(agents_exports);
+__reExport(agents_exports, require("@allem-sdk/agents"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("@allem-sdk/agents")
+});

package/dist/agents.mjs

@@ -0,0 +1,4 @@
+"use client";
+
+// src/agents.ts
+export * from "@allem-sdk/agents";

package/dist/ai.d.mts

@@ -1,5 +1 @@
 export * from '@allem-sdk/ai';
-import '@allem-sdk/analytics';
-import '@allem-sdk/auth';
-import '@allem-sdk/forms';
-import '@allem-sdk/hooks';

package/dist/ai.d.ts

@@ -1,5 +1 @@
 export * from '@allem-sdk/ai';
-import '@allem-sdk/analytics';
-import '@allem-sdk/auth';
-import '@allem-sdk/forms';
-import '@allem-sdk/hooks';

package/dist/index.d.mts

@@ -1,5 +1,6 @@
 export { useClickOutside, useCopyToClipboard, useDebounce, useIntersectionObserver, useLocalStorage, useMediaQuery, useToggle, useWindowSize } from '@allem-sdk/hooks';
 export * from '@allem-sdk/ai';
+export { AgentProvider, AgentProviderProps, AgentStatus, AgentStep, AgentToolCall, AgentToolRegistration, AllemAgentHandlerConfig, AllemToolConfig, UseAllemAgentOptions, UseAllemAgentReturn, createAllemAgentHandler, createAllemTool, useAgentTools, useAllemAgent } from '@allem-sdk/agents';
 export { FieldConfig, FormConfig, FormErrors, FormTouched, UseFieldOptions, UseFieldReturn, UseFormReturn, ValidationRule, custom, email, max, maxLength, min, minLength, pattern, required, url, useField, useForm } from '@allem-sdk/forms';
 export { AnalyticsAdapter, AnalyticsProvider, AnalyticsProviderProps, useIdentify, usePageView, useTrack } from '@allem-sdk/analytics';
 export { AuthAdapter, AuthProvider, AuthProviderProps, AuthSession, AuthStatus, AuthUser, ProtectedRoute, ProtectedRouteProps, UseAuthReturn, UseSessionReturn, useAuth, useSession } from '@allem-sdk/auth';

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { useClickOutside, useCopyToClipboard, useDebounce, useIntersectionObserver, useLocalStorage, useMediaQuery, useToggle, useWindowSize } from '@allem-sdk/hooks';
 export * from '@allem-sdk/ai';
+export { AgentProvider, AgentProviderProps, AgentStatus, AgentStep, AgentToolCall, AgentToolRegistration, AllemAgentHandlerConfig, AllemToolConfig, UseAllemAgentOptions, UseAllemAgentReturn, createAllemAgentHandler, createAllemTool, useAgentTools, useAllemAgent } from '@allem-sdk/agents';
 export { FieldConfig, FormConfig, FormErrors, FormTouched, UseFieldOptions, UseFieldReturn, UseFormReturn, ValidationRule, custom, email, max, maxLength, min, minLength, pattern, required, url, useField, useForm } from '@allem-sdk/forms';
 export { AnalyticsAdapter, AnalyticsProvider, AnalyticsProviderProps, useIdentify, usePageView, useTrack } from '@allem-sdk/analytics';
 export { AuthAdapter, AuthProvider, AuthProviderProps, AuthSession, AuthStatus, AuthUser, ProtectedRoute, ProtectedRouteProps, UseAuthReturn, UseSessionReturn, useAuth, useSession } from '@allem-sdk/auth';

package/dist/index.js

@@ -22,9 +22,12 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  AgentProvider: () => import_agents.AgentProvider,
   AnalyticsProvider: () => import_analytics.AnalyticsProvider,
   AuthProvider: () => import_auth.AuthProvider,
   ProtectedRoute: () => import_auth.ProtectedRoute,
+  createAllemAgentHandler: () => import_agents.createAllemAgentHandler,
+  createAllemTool: () => import_agents.createAllemTool,
   custom: () => import_forms.custom,
   email: () => import_forms.email,
   max: () => import_forms.max,
@@ -34,6 +37,8 @@ __export(index_exports, {
   pattern: () => import_forms.pattern,
   required: () => import_forms.required,
   url: () => import_forms.url,
+  useAgentTools: () => import_agents.useAgentTools,
+  useAllemAgent: () => import_agents.useAllemAgent,
   useAuth: () => import_auth.useAuth,
   useClickOutside: () => import_hooks.useClickOutside,
   useCopyToClipboard: () => import_hooks.useCopyToClipboard,
@@ -53,14 +58,18 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 var import_hooks = require("@allem-sdk/hooks");
 __reExport(index_exports, require("@allem-sdk/ai"), module.exports);
+var import_agents = require("@allem-sdk/agents");
 var import_forms = require("@allem-sdk/forms");
 var import_analytics = require("@allem-sdk/analytics");
 var import_auth = require("@allem-sdk/auth");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AgentProvider,
   AnalyticsProvider,
   AuthProvider,
   ProtectedRoute,
+  createAllemAgentHandler,
+  createAllemTool,
   custom,
   email,
   max,
@@ -70,6 +79,8 @@ var import_auth = require("@allem-sdk/auth");
   pattern,
   required,
   url,
+  useAgentTools,
+  useAllemAgent,
   useAuth,
   useClickOutside,
   useCopyToClipboard,

package/dist/index.mjs

@@ -12,6 +12,13 @@ import {
   useWindowSize
 } from "@allem-sdk/hooks";
 export * from "@allem-sdk/ai";
+import {
+  useAllemAgent,
+  AgentProvider,
+  useAgentTools,
+  createAllemAgentHandler,
+  createAllemTool
+} from "@allem-sdk/agents";
 import {
   useForm,
   useField,
@@ -38,9 +45,12 @@ import {
   ProtectedRoute
 } from "@allem-sdk/auth";
 export {
+  AgentProvider,
   AnalyticsProvider,
   AuthProvider,
   ProtectedRoute,
+  createAllemAgentHandler,
+  createAllemTool,
   custom,
   email,
   max,
@@ -50,6 +60,8 @@ export {
   pattern,
   required,
   url,
+  useAgentTools,
+  useAllemAgent,
   useAuth,
   useClickOutside,
   useCopyToClipboard,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "allem-sdk",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "The complete Allem SDK — hooks, AI, forms, analytics, and auth for React",
   "license": "MIT",
   "author": "Ahmed Allem (https://kingallem.com)",
@@ -37,6 +37,11 @@
       "types": "./dist/auth.d.ts",
       "import": "./dist/auth.mjs",
       "require": "./dist/auth.js"
+    },
+    "./agents": {
+      "types": "./dist/agents.d.ts",
+      "import": "./dist/agents.mjs",
+      "require": "./dist/agents.js"
     }
   },
   "files": [
@@ -45,10 +50,11 @@
   "sideEffects": false,
   "dependencies": {
     "@allem-sdk/hooks": "0.1.1",
-    "@allem-sdk/ai": "0.1.1",
     "@allem-sdk/forms": "0.1.1",
+    "@allem-sdk/analytics": "0.1.1",
     "@allem-sdk/auth": "0.1.1",
-    "@allem-sdk/analytics": "0.1.1"
+    "@allem-sdk/agents": "0.2.1",
+    "@allem-sdk/ai": "0.1.1"
   },
   "devDependencies": {
     "@types/react": "^19.0.0",
@@ -85,6 +91,7 @@
     "react",
     "hooks",
     "ai",
+    "agents",
     "forms",
     "analytics",
     "auth",