deepagentsdk 0.9.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 deepagentsdk 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/README.md

@@ -0,0 +1,159 @@
+# AI SDK Deep Agent
+
+<p align="center">
+  <img src="assets/www-hero.png" alt="AI SDK Deep Agent" width="100%" />
+</p>
+
+[![npm version](https://badge.fury.io/js/deepagentsdk.svg)](https://www.npmjs.com/package/deepagentsdk)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/chrispangg/ai-sdk-deepagent)
+[![Documentation](https://img.shields.io/badge/docs-ai--sdk--deepagent-blue)](https://deepagentsdk.vercel.app/docs)
+
+> **Note:** This package requires [Bun](https://bun.sh) runtime. It uses Bun-specific features and TypeScript imports.
+
+A TypeScript library for building controllable AI agents using [Vercel AI SDK](https://ai-sdk.dev/). This is a reimplementation of [deepagentsjs](https://github.com/langchain-ai/deepagentsjs) without any LangChain/LangGraph dependencies.
+
+## What is Deep Agent?
+
+Using an LLM to call tools in a loop is the simplest form of an agent. This architecture, however, can yield agents that are "shallow" and fail to plan and act over longer, more complex tasks.
+
+Deep Agent addresses these limitations through four core architectural components:
+
+| Component | Purpose | Implementation |
+|-----------|---------|----------------|
+| **Planning Tool** | Long-term task breakdown and tracking | `write_todos` for maintaining task lists |
+| **Sub Agents** | Task delegation and specialization | `task` tool for spawning specialized agents |
+| **File System Access** | Persistent state and information storage | Virtual filesystem with `read_file`, `write_file`, `edit_file` |
+| **Detailed Prompts** | Context-aware instructions | Sophisticated prompting strategies |
+
+## Installation
+
+This package requires Bun runtime:
+
+```bash
+# Install Bun if you haven't already
+curl -fsSL https://bun.sh/install | bash
+
+# Install the package
+bun add deepagentsdk
+
+# Or install globally for CLI usage
+bun add -g deepagentsdk
+```
+
+**Why Bun?** This package publishes TypeScript source directly and uses Bun-specific optimizations for better performance.
+
+## Quick Start
+
+```typescript
+import { createDeepAgent } from 'deepagentsdk';
+import { anthropic } from '@ai-sdk/anthropic';
+
+const agent = createDeepAgent({
+  model: anthropic('claude-sonnet-4-5-20250929'),
+  systemPrompt: 'You are an expert researcher.',
+});
+
+const result = await agent.generate({
+  prompt: 'Research the topic of quantum computing and write a report',
+});
+
+console.log(result.text);
+console.log('Todos:', result.state.todos);
+console.log('Files:', Object.keys(result.state.files));
+```
+
+## Features
+
+### Structured Output
+
+Deep agents can return typed, validated objects using Zod schemas alongside text responses:
+
+```typescript
+import { z } from 'zod';
+
+const agent = createDeepAgent({
+  model: anthropic('claude-sonnet-4-5-20250929'),
+  output: {
+    schema: z.object({
+      summary: z.string(),
+      keyPoints: z.array(z.string()),
+    }),
+    description: 'Research findings',
+  },
+});
+
+const result = await agent.generate({
+  prompt: "Research latest AI developments",
+});
+
+console.log(result.output?.summary);      // string
+console.log(result.output?.keyPoints);    // string[]
+```
+
+### Streaming with Events
+
+Stream responses with real-time events for tool calls, file operations, and more:
+
+```typescript
+for await (const event of agent.streamWithEvents({
+  prompt: 'Build a todo app',
+})) {
+  switch (event.type) {
+    case 'text':
+      process.stdout.write(event.text);
+      break;
+    case 'tool-call':
+      console.log(`Calling: ${event.toolName}`);
+      break;
+    case 'file-written':
+      console.log(`Written: ${event.path}`);
+      break;
+  }
+}
+```
+
+### Built-in Tools
+
+- **Planning**: `write_todos` for task management
+- **Filesystem**: `read_file`, `write_file`, `edit_file`, `ls`, `glob`, `grep`
+- **Web**: `web_search`, `http_request`, `fetch_url` (requires Tavily API key)
+- **Execute**: Shell command execution with `LocalSandbox` backend
+- **Subagents**: Spawn specialized agents for complex subtasks
+
+## Documentation
+
+For comprehensive guides, API reference, and examples, visit **[deepagentsdk.vercel.app/docs](https://deepagentsdk.vercel.app/docs)**
+
+### Key Documentation Sections
+
+- **[Get Started](https://deepagentsdk.vercel.app/docs/get-started)** - Installation and basic setup
+- **[Guides](https://deepagentsdk.vercel.app/docs/guides)** - In-depth tutorials on:
+  - Configuration options (models, backends, middleware)
+  - Custom tools and subagents
+  - Agent memory and persistence
+  - Prompt caching and conversation summarization
+  - Web tools and API integration
+- **[Reference](https://deepagentsdk.vercel.app/docs/reference)** - Complete API documentation
+
+## CLI
+
+The interactive CLI is built with [Ink](https://github.com/vadimdemedes/ink):
+
+```bash
+# Run without installing (recommended)
+bunx deepagentsdk
+
+# Or install globally
+bun add -g deepagentsdk
+deep-agent
+
+# With options
+bunx deepagentsdk --model anthropic/claude-haiku-4-5-20251001
+```
+
+**API Keys**: Load from environment variables (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `TAVILY_API_KEY`) or `.env` file.
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "deepagentsdk",
+  "version": "0.9.2",
+  "description": "Deep Agent implementation using Vercel AI SDK - build controllable AI agents with planning, filesystem, and subagent capabilities",
+  "main": "./src/index.ts",
+  "module": "./src/index.ts",
+  "types": "./src/index.ts",
+  "type": "module",
+  "bin": {
+    "deep-agent": "./src/cli/index.tsx"
+  },
+  "exports": {
+    ".": {
+      "import": "./src/index.ts",
+      "types": "./src/index.ts"
+    },
+    "./cli": {
+      "import": "./src/cli/index.ts"
+    }
+  },
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "bun test test/",
+    "test:integration": "bun test test-integration/",
+    "test:all": "bun run test && bun run test:integration",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run typecheck",
+    "cli": "bun src/cli/index.tsx"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chrispangg/ai-sdk-deepagent.git"
+  },
+  "homepage": "https://github.com/chrispangg/ai-sdk-deepagent#readme",
+  "bugs": {
+    "url": "https://github.com/chrispangg/ai-sdk-deepagent/issues"
+  },
+  "dependencies": {
+    "@ai-sdk/anthropic": "^3.0.0-beta.83",
+    "@ai-sdk/openai": "^3.0.0-beta.96",
+    "@ai-sdk/react": "^3.0.0-beta.153",
+    "@inkjs/ui": "^1.0.0",
+    "@mozilla/readability": "^0.6.0",
+    "@tavily/core": "^0.6.1",
+    "ai": "^6.0.0-beta.150",
+    "fast-glob": "^3.3.3",
+    "ink": "^5.1.0",
+    "jsdom": "^25.0.1",
+    "micromatch": "^4.0.8",
+    "react": "^18.2.0",
+    "react-devtools-core": "^5.3.2",
+    "turndown": "^7.2.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@langfuse/otel": "^4.5.1",
+    "@langfuse/tracing": "^4.5.1",
+    "@opentelemetry/api-logs": "^0.208.0",
+    "@opentelemetry/instrumentation": "^0.208.0",
+    "@opentelemetry/sdk-logs": "^0.208.0",
+    "@opentelemetry/sdk-node": "^0.208.0",
+    "@types/bun": "latest",
+    "@types/jsdom": "^21.1.7",
+    "@types/micromatch": "^4.0.9",
+    "@types/react": "^18.3.18",
+    "@types/turndown": "^5.0.5",
+    "@vercel/otel": "^2.1.0",
+    "install": "^0.13.0",
+    "langfuse-vercel": "^3.38.6",
+    "typescript": "^5.7.3"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "deep-agents",
+    "vercel-ai-sdk",
+    "llm",
+    "typescript",
+    "bun",
+    "anthropic",
+    "openai",
+    "ai-sdk"
+  ],
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "license": "MIT"
+}