hareai 0.1.0

package/README.md

@@ -0,0 +1,202 @@
+# hareai
+
+Build AI agents on Cloudflare's edge network.
+
+## Installation
+
+```bash
+npm install hareai
+# or
+bun add hareai
+```
+
+### Peer Dependencies
+
+```bash
+npm install ai zod agents
+```
+
+## Quick Start
+
+### 1. Create a Simple Agent
+
+```ts
+import { createSimpleAgent, createWorkersAIModel } from 'hareai'
+import { getSystemTools } from 'hareai/tools'
+
+export default {
+  async fetch(request: Request, env: Env) {
+    const tools = getSystemTools({
+      env,
+      workspaceId: 'my-workspace',
+      userId: 'user-123'
+    })
+
+    const agent = createSimpleAgent({
+      model: createWorkersAIModel({
+        modelId: '@cf/meta/llama-3.3-70b-instruct-fp8-fast',
+        ai: env.AI
+      }),
+      tools,
+      systemPrompt: 'You are a helpful assistant.'
+    })
+
+    const response = await agent.chat('Hello!')
+    return new Response(response.text)
+  }
+}
+```
+
+### 2. Use Durable Object Agents (Stateful)
+
+```ts
+import { HareAgent, routeToHareAgent } from 'hareai/workers'
+
+// Export the Durable Object class
+export { HareAgent }
+
+export default {
+  async fetch(request: Request, env: Env) {
+    return routeToHareAgent({
+      request,
+      env,
+      agentId: 'my-agent'
+    })
+  }
+}
+```
+
+### 3. Create Custom Tools
+
+```ts
+import { createTool, success, failure } from 'hareai/tools'
+import { z } from 'zod'
+
+const weatherTool = createTool({
+  id: 'get_weather',
+  description: 'Get current weather for a location',
+  inputSchema: z.object({
+    city: z.string().describe('City name'),
+    units: z.enum(['celsius', 'fahrenheit']).default('celsius')
+  }),
+  execute: async (params, context) => {
+    try {
+      const weather = await fetchWeather(params.city, params.units)
+      return success({ temperature: weather.temp, conditions: weather.conditions })
+    } catch (error) {
+      return failure(`Failed to fetch weather: ${error.message}`)
+    }
+  }
+})
+```
+
+## Entry Points
+
+| Import Path | Description |
+|-------------|-------------|
+| `hareai` | Main entry - universal exports (HareEdgeAgent, tools, types) |
+| `hareai/workers` | Workers-only exports (HareAgent, HareMcpAgent with Durable Objects) |
+| `hareai/tools` | All 59+ tools organized by category |
+| `hareai/types` | Complete type definitions |
+
+## Available Tools (59+)
+
+### Cloudflare Native (17)
+- **KV**: `kv_get`, `kv_put`, `kv_delete`, `kv_list`
+- **R2**: `r2_get`, `r2_put`, `r2_delete`, `r2_list`, `r2_head`
+- **SQL**: `sql_query`, `sql_execute`, `sql_batch`
+- **HTTP**: `http_request`, `http_get`, `http_post`
+- **Search**: `ai_search`, `ai_search_answer`
+
+### AI Tools (8)
+`sentiment`, `summarize`, `translate`, `image_generate`, `classify`, `ner`, `embedding`, `question_answer`
+
+### Utility Tools (9)
+`datetime`, `json`, `text`, `math`, `uuid`, `hash`, `base64`, `url`, `delay`
+
+### Data Tools (7)
+`rss`, `scrape`, `regex`, `crypto`, `json_schema`, `csv`, `template`
+
+### Validation Tools (6)
+`validate_email`, `validate_phone`, `validate_url`, `validate_credit_card`, `validate_ip`, `validate_json`
+
+### Transform Tools (5)
+`markdown`, `diff`, `qrcode`, `compression`, `color`
+
+### Sandbox Tools (3)
+`code_execute`, `code_validate`, `sandbox_file`
+
+### Memory Tools (2)
+`store_memory`, `recall_memory` (Vectorize)
+
+### Integration Tools (2)
+`zapier`, `webhook`
+
+## Wrangler Configuration
+
+```toml
+# wrangler.toml
+name = "my-agent"
+main = "src/index.ts"
+
+[durable_objects]
+bindings = [
+  { name = "HARE_AGENT", class_name = "HareAgent" }
+]
+
+[[migrations]]
+tag = "v1"
+new_classes = ["HareAgent"]
+
+[ai]
+binding = "AI"
+
+[[kv_namespaces]]
+binding = "KV"
+id = "your-kv-id"
+
+[[d1_databases]]
+binding = "DB"
+database_name = "hare"
+database_id = "your-d1-id"
+```
+
+## TypeScript Types
+
+```ts
+import type {
+  HareAgentState,
+  ToolContext,
+  Tool,
+  AnyTool,
+  AgentConfig
+} from 'hareai/types'
+```
+
+## API Reference
+
+### Agent Classes
+
+- **`HareEdgeAgent`** - Universal agent (works anywhere)
+- **`HareAgent`** - Cloudflare Durable Object agent with state persistence
+- **`HareMcpAgent`** - MCP server agent for external AI clients
+
+### Tool Factories
+
+- **`createTool(config)`** - Create a type-safe tool
+- **`getSystemTools(context)`** - Get all 59+ built-in tools
+- **`getToolsByCategory({ category, context })`** - Get tools by category
+
+### AI Model Providers
+
+- **`createWorkersAIModel({ modelId, ai })`** - Create Workers AI model
+- **`generateEmbedding({ text, model, ai })`** - Generate embeddings
+
+### Memory Store
+
+- **`createMemoryStore({ db })`** - Create D1-backed conversation memory
+- **`D1MemoryStore`** - Direct memory store class
+
+## License
+
+MIT

package/dist/chunk-KTWGHY3T.js

@@ -0,0 +1,102 @@
+// src/index.ts
+import {
+  createAgentFromConfig,
+  createAgentHeaders,
+  createEdgeAgent,
+  createHareEdgeAgent,
+  createMemoryStore,
+  createSimpleAgent,
+  createWorkersAIModel,
+  D1MemoryStore,
+  DEFAULT_HARE_AGENT_STATE,
+  DEFAULT_MCP_AGENT_STATE,
+  EdgeAgent,
+  EMBEDDING_MODELS,
+  generateEmbedding,
+  generateEmbeddings,
+  getAgentIdFromRequest,
+  getAvailableModels,
+  getWorkersAIModelId,
+  HareEdgeAgent,
+  isWebSocketRequest,
+  loadAgentTools,
+  routeHttpToAgent,
+  routeToHareAgent,
+  routeToMcpAgent,
+  routeWebSocketToAgent,
+  toAgentMessages,
+  WORKERS_AI_MODELS
+} from "@hare/agent";
+import {
+  createRegistry,
+  createTool,
+  delegateTo,
+  delegateToWithValidation,
+  failure,
+  getSystemTools,
+  getSystemToolsMap,
+  getToolsByCategory,
+  isSystemTool,
+  SYSTEM_TOOL_IDS,
+  success,
+  TOOL_COUNTS,
+  ToolRegistry
+} from "@hare/tools";
+import {
+  AgentConfigSchema,
+  AgentSchema,
+  AgentStatusSchema,
+  ApiErrorSchema,
+  ApiSuccessSchema,
+  ToolConfigSchema,
+  ToolTypeSchema
+} from "@hare/types";
+
+export {
+  createAgentFromConfig,
+  createAgentHeaders,
+  createEdgeAgent,
+  createHareEdgeAgent,
+  createMemoryStore,
+  createSimpleAgent,
+  createWorkersAIModel,
+  D1MemoryStore,
+  DEFAULT_HARE_AGENT_STATE,
+  DEFAULT_MCP_AGENT_STATE,
+  EdgeAgent,
+  EMBEDDING_MODELS,
+  generateEmbedding,
+  generateEmbeddings,
+  getAgentIdFromRequest,
+  getAvailableModels,
+  getWorkersAIModelId,
+  HareEdgeAgent,
+  isWebSocketRequest,
+  loadAgentTools,
+  routeHttpToAgent,
+  routeToHareAgent,
+  routeToMcpAgent,
+  routeWebSocketToAgent,
+  toAgentMessages,
+  WORKERS_AI_MODELS,
+  createRegistry,
+  createTool,
+  delegateTo,
+  delegateToWithValidation,
+  failure,
+  getSystemTools,
+  getSystemToolsMap,
+  getToolsByCategory,
+  isSystemTool,
+  SYSTEM_TOOL_IDS,
+  success,
+  TOOL_COUNTS,
+  ToolRegistry,
+  AgentConfigSchema,
+  AgentSchema,
+  AgentStatusSchema,
+  ApiErrorSchema,
+  ApiSuccessSchema,
+  ToolConfigSchema,
+  ToolTypeSchema
+};

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { AgentConfig, AgentOptions, AgentRouteConfig, AgentStreamResponse, AgentTool, ChatPayload, ClientMessage, ConversationMessage, CreateAgentFromConfigInput, CreateSimpleAgentInput, CreateWorkersAIModelInput, D1MemoryStore, DEFAULT_HARE_AGENT_STATE, DEFAULT_MCP_AGENT_STATE, EMBEDDING_MODELS, EdgeAgent, EmbeddingModelId, GenerateEmbeddingInput, GenerateEmbeddingsInput, GetMessagesInput, GetOrCreateConversationInput, HareAgentEnv, HareAgentState, HareEdgeAgent, LoadAgentToolsInput, McpAgentState, MemoryStore, MessageRole, RouteHttpToAgentInput, RouteToHareAgentInput, RouteToMcpAgentInput, RouteWebSocketToAgentInput, SaveMessageInput, SchedulePayload, ScheduledTask, SearchMessagesInput, ServerMessage, ToolExecutePayload, WORKERS_AI_MODELS, WorkersAIModelId, createAgentFromConfig, createAgentHeaders, createEdgeAgent, createHareEdgeAgent, createMemoryStore, createSimpleAgent, createWorkersAIModel, generateEmbedding, generateEmbeddings, getAgentIdFromRequest, getAvailableModels, getWorkersAIModelId, isWebSocketRequest, loadAgentTools, routeHttpToAgent, routeToHareAgent, routeToMcpAgent, routeWebSocketToAgent, toAgentMessages } from '@hare/agent';
+export { AnyTool, HareEnv, SYSTEM_TOOL_IDS, SystemToolId, TOOL_COUNTS, Tool, ToolCategory, ToolContext, ToolDefinition, ToolRegistry, ToolResult, createRegistry, createTool, delegateTo, delegateToWithValidation, failure, getSystemTools, getSystemToolsMap, getToolsByCategory, isSystemTool, success } from '@hare/tools';
+export { Agent, AgentConfigSchema, AgentConfig as AgentConfigType, AgentSchema, AgentStatus, AgentStatusSchema, ApiError, ApiErrorSchema, ApiSuccess, ApiSuccessSchema, ToolConfig, ToolConfigSchema, ToolType, ToolTypeSchema } from '@hare/types';
+import '@hare/agent/workers';

package/dist/index.js

@@ -0,0 +1,96 @@
+import {
+  AgentConfigSchema,
+  AgentSchema,
+  AgentStatusSchema,
+  ApiErrorSchema,
+  ApiSuccessSchema,
+  D1MemoryStore,
+  DEFAULT_HARE_AGENT_STATE,
+  DEFAULT_MCP_AGENT_STATE,
+  EMBEDDING_MODELS,
+  EdgeAgent,
+  HareEdgeAgent,
+  SYSTEM_TOOL_IDS,
+  TOOL_COUNTS,
+  ToolConfigSchema,
+  ToolRegistry,
+  ToolTypeSchema,
+  WORKERS_AI_MODELS,
+  createAgentFromConfig,
+  createAgentHeaders,
+  createEdgeAgent,
+  createHareEdgeAgent,
+  createMemoryStore,
+  createRegistry,
+  createSimpleAgent,
+  createTool,
+  createWorkersAIModel,
+  delegateTo,
+  delegateToWithValidation,
+  failure,
+  generateEmbedding,
+  generateEmbeddings,
+  getAgentIdFromRequest,
+  getAvailableModels,
+  getSystemTools,
+  getSystemToolsMap,
+  getToolsByCategory,
+  getWorkersAIModelId,
+  isSystemTool,
+  isWebSocketRequest,
+  loadAgentTools,
+  routeHttpToAgent,
+  routeToHareAgent,
+  routeToMcpAgent,
+  routeWebSocketToAgent,
+  success,
+  toAgentMessages
+} from "./chunk-KTWGHY3T.js";
+export {
+  AgentConfigSchema,
+  AgentSchema,
+  AgentStatusSchema,
+  ApiErrorSchema,
+  ApiSuccessSchema,
+  D1MemoryStore,
+  DEFAULT_HARE_AGENT_STATE,
+  DEFAULT_MCP_AGENT_STATE,
+  EMBEDDING_MODELS,
+  EdgeAgent,
+  HareEdgeAgent,
+  SYSTEM_TOOL_IDS,
+  TOOL_COUNTS,
+  ToolConfigSchema,
+  ToolRegistry,
+  ToolTypeSchema,
+  WORKERS_AI_MODELS,
+  createAgentFromConfig,
+  createAgentHeaders,
+  createEdgeAgent,
+  createHareEdgeAgent,
+  createMemoryStore,
+  createRegistry,
+  createSimpleAgent,
+  createTool,
+  createWorkersAIModel,
+  delegateTo,
+  delegateToWithValidation,
+  failure,
+  generateEmbedding,
+  generateEmbeddings,
+  getAgentIdFromRequest,
+  getAvailableModels,
+  getSystemTools,
+  getSystemToolsMap,
+  getToolsByCategory,
+  getWorkersAIModelId,
+  isSystemTool,
+  isWebSocketRequest,
+  loadAgentTools,
+  routeHttpToAgent,
+  routeToHareAgent,
+  routeToMcpAgent,
+  routeWebSocketToAgent,
+  success,
+  toAgentMessages
+};

package/dist/tools.d.ts

@@ -0,0 +1 @@
+export * from '@hare/tools';

package/dist/tools.js

@@ -0,0 +1,2 @@
+// src/tools.ts
+export * from "@hare/tools";

package/dist/types.d.ts

@@ -0,0 +1,3 @@
+export { ChatPayload, ClientMessage, HareAgentState, McpAgentState, SchedulePayload, ScheduledTask, ServerMessage, ToolExecutePayload } from '@hare/agent';
+export { AnyTool, ExecutableTool, HareEnv, SystemToolId, Tool, ToolCategory, ToolContext, ToolDefinition, ToolResult } from '@hare/tools';
+export * from '@hare/types';

package/dist/types.js

@@ -0,0 +1,2 @@
+// src/types.ts
+export * from "@hare/types";

package/dist/workers.d.ts

@@ -0,0 +1,4 @@
+export { HareAgent, HareAgentEnv, HareMcpAgent, McpAgentEnv } from '@hare/agent/workers';
+export { AgentConfig, AgentOptions, AgentRouteConfig, AgentStreamResponse, AgentTool, ChatPayload, ClientMessage, ConversationMessage, CreateAgentFromConfigInput, CreateSimpleAgentInput, CreateWorkersAIModelInput, D1MemoryStore, DEFAULT_HARE_AGENT_STATE, DEFAULT_MCP_AGENT_STATE, EMBEDDING_MODELS, EdgeAgent, EmbeddingModelId, GenerateEmbeddingInput, GenerateEmbeddingsInput, GetMessagesInput, GetOrCreateConversationInput, HareAgentState, HareEdgeAgent, LoadAgentToolsInput, McpAgentState, MemoryStore, MessageRole, RouteHttpToAgentInput, RouteToHareAgentInput, RouteToMcpAgentInput, RouteWebSocketToAgentInput, SaveMessageInput, SchedulePayload, ScheduledTask, SearchMessagesInput, ServerMessage, ToolExecutePayload, WORKERS_AI_MODELS, WorkersAIModelId, createAgentFromConfig, createAgentHeaders, createEdgeAgent, createHareEdgeAgent, createMemoryStore, createSimpleAgent, createWorkersAIModel, generateEmbedding, generateEmbeddings, getAgentIdFromRequest, getAvailableModels, getWorkersAIModelId, isWebSocketRequest, loadAgentTools, routeHttpToAgent, routeToHareAgent, routeToMcpAgent, routeWebSocketToAgent, toAgentMessages } from '@hare/agent';
+export { AnyTool, HareEnv, SYSTEM_TOOL_IDS, SystemToolId, TOOL_COUNTS, Tool, ToolCategory, ToolContext, ToolDefinition, ToolRegistry, ToolResult, createRegistry, createTool, delegateTo, delegateToWithValidation, failure, getSystemTools, getSystemToolsMap, getToolsByCategory, isSystemTool, success } from '@hare/tools';
+export { Agent, AgentConfigSchema, AgentConfig as AgentConfigType, AgentSchema, AgentStatus, AgentStatusSchema, ApiError, ApiErrorSchema, ApiSuccess, ApiSuccessSchema, ToolConfig, ToolConfigSchema, ToolType, ToolTypeSchema } from '@hare/types';

package/dist/workers.js

@@ -0,0 +1,101 @@
+import {
+  AgentConfigSchema,
+  AgentSchema,
+  AgentStatusSchema,
+  ApiErrorSchema,
+  ApiSuccessSchema,
+  D1MemoryStore,
+  DEFAULT_HARE_AGENT_STATE,
+  DEFAULT_MCP_AGENT_STATE,
+  EMBEDDING_MODELS,
+  EdgeAgent,
+  HareEdgeAgent,
+  SYSTEM_TOOL_IDS,
+  TOOL_COUNTS,
+  ToolConfigSchema,
+  ToolRegistry,
+  ToolTypeSchema,
+  WORKERS_AI_MODELS,
+  createAgentFromConfig,
+  createAgentHeaders,
+  createEdgeAgent,
+  createHareEdgeAgent,
+  createMemoryStore,
+  createRegistry,
+  createSimpleAgent,
+  createTool,
+  createWorkersAIModel,
+  delegateTo,
+  delegateToWithValidation,
+  failure,
+  generateEmbedding,
+  generateEmbeddings,
+  getAgentIdFromRequest,
+  getAvailableModels,
+  getSystemTools,
+  getSystemToolsMap,
+  getToolsByCategory,
+  getWorkersAIModelId,
+  isSystemTool,
+  isWebSocketRequest,
+  loadAgentTools,
+  routeHttpToAgent,
+  routeToHareAgent,
+  routeToMcpAgent,
+  routeWebSocketToAgent,
+  success,
+  toAgentMessages
+} from "./chunk-KTWGHY3T.js";
+
+// src/workers.ts
+import { HareAgent, HareMcpAgent } from "@hare/agent/workers";
+export {
+  AgentConfigSchema,
+  AgentSchema,
+  AgentStatusSchema,
+  ApiErrorSchema,
+  ApiSuccessSchema,
+  D1MemoryStore,
+  DEFAULT_HARE_AGENT_STATE,
+  DEFAULT_MCP_AGENT_STATE,
+  EMBEDDING_MODELS,
+  EdgeAgent,
+  HareAgent,
+  HareEdgeAgent,
+  HareMcpAgent,
+  SYSTEM_TOOL_IDS,
+  TOOL_COUNTS,
+  ToolConfigSchema,
+  ToolRegistry,
+  ToolTypeSchema,
+  WORKERS_AI_MODELS,
+  createAgentFromConfig,
+  createAgentHeaders,
+  createEdgeAgent,
+  createHareEdgeAgent,
+  createMemoryStore,
+  createRegistry,
+  createSimpleAgent,
+  createTool,
+  createWorkersAIModel,
+  delegateTo,
+  delegateToWithValidation,
+  failure,
+  generateEmbedding,
+  generateEmbeddings,
+  getAgentIdFromRequest,
+  getAvailableModels,
+  getSystemTools,
+  getSystemToolsMap,
+  getToolsByCategory,
+  getWorkersAIModelId,
+  isSystemTool,
+  isWebSocketRequest,
+  loadAgentTools,
+  routeHttpToAgent,
+  routeToHareAgent,
+  routeToMcpAgent,
+  routeWebSocketToAgent,
+  success,
+  toAgentMessages
+};

package/package.json

@@ -0,0 +1,91 @@
+{
+	"name": "hareai",
+	"version": "0.1.0",
+	"description": "Hare SDK - Build AI agents on Cloudflare's edge network",
+	"keywords": [
+		"cloudflare",
+		"workers",
+		"ai",
+		"agent",
+		"sdk",
+		"llm",
+		"tools",
+		"mcp"
+	],
+	"license": "MIT",
+	"type": "module",
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		},
+		"./tools": {
+			"import": "./dist/tools.js",
+			"types": "./dist/tools.d.ts"
+		},
+		"./types": {
+			"import": "./dist/types.js",
+			"types": "./dist/types.d.ts"
+		},
+		"./workers": {
+			"import": "./dist/workers.js",
+			"types": "./dist/workers.d.ts"
+		}
+	},
+	"main": "./dist/index.js",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": [
+		"dist",
+		"README.md"
+	],
+	"scripts": {
+		"build": "tsup",
+		"prepublishOnly": "bun run build",
+		"lint": "biome check .",
+		"typecheck": "tsc --noEmit"
+	},
+	"dependencies": {
+		"@hare/agent": "workspace:*",
+		"@hare/tools": "workspace:*",
+		"@hare/types": "workspace:*"
+	},
+	"devDependencies": {
+		"@cloudflare/workers-types": "^4.20251224.0",
+		"@hare/typescript-config": "workspace:*",
+		"@modelcontextprotocol/sdk": "^1.25.1",
+		"agents": "^0.3.0",
+		"ai": "^6.0.3",
+		"drizzle-orm": "^0.45.1",
+		"tsup": "^8",
+		"typescript": "^5",
+		"zod": "^4.2.1"
+	},
+	"peerDependencies": {
+		"@modelcontextprotocol/sdk": "^1.23.0",
+		"agents": "^0.3.0",
+		"ai": "^6.0.0",
+		"drizzle-orm": "^0.45.1",
+		"zod": "^4.0.0"
+	},
+	"peerDependenciesMeta": {
+		"@modelcontextprotocol/sdk": {
+			"optional": true
+		},
+		"drizzle-orm": {
+			"optional": true
+		}
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/andrew-bierman/hare.git",
+		"directory": "packages/sdk"
+	},
+	"homepage": "https://github.com/andrew-bierman/hare",
+	"bugs": {
+		"url": "https://github.com/andrew-bierman/hare/issues"
+	}
+}