anthropics/claude-agent-sdk-typescript
Claude Agent Sdk Typescript
This project is a TypeScript software development kit designed for building and orchestrating autonomous agents that interact with codebases and system environments. It provides a programmatic interface for constructing agents capable of executing complex workflows, such as automated code refactoring, file system manipulation, and shell command execution, by leveraging large language models.
The framework distinguishes itself through a focus on secure, governed agent operations. It includes granular access control systems that allow developers to define specific permissions for tools and external services, ensuring that automated tasks remain within defined security policies. The architecture supports hierarchical delegation, enabling primary agents to spawn and coordinate specialized subagents for focused tasks, while maintaining stateful session persistence to allow for the resumption of previous work.
The SDK provides comprehensive observability and control over the agent lifecycle. Developers can utilize event-driven hooks to intercept, validate, or modify agent behavior at runtime, and stream real-time execution progress and task notifications to host applications. The environment is designed for consistency and security, featuring isolated execution contexts and configurable system instructions that govern how agents interpret and act upon their environment.
Features
- Agentic LLM Frameworks - Provides a TypeScript SDK for building and orchestrating autonomous agents that interact with codebases and system environments using large language models.
- Autonomous Agents - Provides a framework for building intelligent agents that interpret codebases and execute complex workflows using large language models.
- Agent Governance Platforms - Provides granular access control systems to ensure automated agents operate safely within sensitive development environments.
- Agent Construction Frameworks - Provides a programmatic interface for constructing autonomous agents that interpret codebases and execute complex workflows.
- Agentic Task Orchestration - Coordinates multi-agent systems and manages complex development workflows through a programmatic interface for tool execution and task planning.
- Agentic Workflow Orchestration - Coordinates autonomous agents to perform complex tasks like codebase analysis and file editing through a structured interface.
- Hierarchical Task Delegation - Enables primary agents to manage complex workflows by spawning and coordinating specialized subagents.
- Agent Configurations - Allows defining custom system instructions to govern how agents interpret and act upon their environment.
- Parent Agent Sub-Agent Delegation - Supports hierarchical delegation by allowing primary agents to spawn and coordinate specialized subagents.
- Agent Tool Integrations - Allows linking external tool servers to grant agents direct access to specialized functions beyond built-in capabilities.
- Autonomous Agent Orchestration - Provides a toolkit for hooking into agent events, persisting sessions, and isolating execution environments.
- Agent Tool Integrations - Maps natural language requests to structured programmatic tool invocations for external service interaction.
- Shell Command Execution - Allows triggering shell commands and scripts from within an agent workflow to interact with the local environment.
- Programmatic Code Refactoring - Uses programmatic agents to read, modify, and update source code files for complex refactoring tasks.
- Agent Action Restrictions - Provides granular access control to restrict which tools an agent can use, ensuring sensitive actions are blocked or require explicit approval.
- Agentic Session Persistence - Stores conversation history and agent context in a persistent format to allow resumption of previous work.
- Agent Sandboxing Policies - Restricts agent interactions with the filesystem and external tools to ensure secure execution within isolated environments.
- AI Agent Permissions - Enables granular definition of access policies for tools and external services to ensure automated tasks remain within defined security boundaries.
- Codebase File Manipulation - Enables programmatic reading, writing, and modification of source code files to perform automated refactoring within a codebase.
- AI Agent Execution Monitors - Streams real-time execution progress, task notifications, and usage metrics to provide visibility into agent activity during runtime.
