langchain-agentcore-codeinterpreter 0.0.1__tar.gz

langchain_agentcore_codeinterpreter-0.0.1/.gitignore

@@ -0,0 +1,186 @@
+.vs/
+.vscode/
+.idea/
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Google GitHub Actions credentials files created by:
+# https://github.com/google-github-actions/auth
+#
+# That action recommends adding this gitignore to prevent accidentally committing keys.
+gha-creds-*.json
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+.mypy_cache_test/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+docs/docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+notebooks/
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv*
+venv*
+env/
+ENV/
+env.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# macOS display setting files
+.DS_Store
+
+# Wandb directory
+wandb/
+
+# asdf tool versions
+.tool-versions
+
+# ruff
+/.ruff_cache/
+.ruff_cache/
+
+*.pkl
+*.bin
+
+# integration test artifacts
+data_map*
+\[('_type', 'fake'), ('stop', None)]
+
+# Replit files
+*replit*
+
+node_modules
+docs/.yarn/
+docs/node_modules/
+docs/.docusaurus/
+docs/.cache-loader/
+docs/_dist
+docs/api_reference/*api_reference.rst
+docs/api_reference/_build
+docs/api_reference/*/
+!docs/api_reference/_static/
+!docs/api_reference/templates/
+!docs/api_reference/themes/
+docs/docs/build
+docs/docs/node_modules
+docs/docs/yarn.lock
+_dist
+docs/docs/templates
+
+prof
+.kiro/*

langchain_agentcore_codeinterpreter-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) LangChain, Inc.
+
+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.

langchain_agentcore_codeinterpreter-0.0.1/Makefile

@@ -0,0 +1,84 @@
+######################
+# NON FILE TARGETS
+######################
+.PHONY: all format lint test tests integration_tests help coverage_tests coverage_integration_tests coverage_report coverage_html
+
+######################
+# ALL TARGETS
+######################
+
+all: help ## Default target = help
+
+.EXPORT_ALL_VARIABLES:
+UV_FROZEN = true
+
+######################
+# TEST CASES
+######################
+
+# Define a variable for the test file path.
+test test_watch tests: TEST_FILE ?= tests/unit_tests/
+integration_test integration_tests: TEST_FILE = tests/integration_tests/
+
+# Define a variable for Python and notebook files.
+PYTHON_FILES=.
+
+tests: ## Run all unit tests
+	env -u AWS_ACCESS_KEY_ID -u AWS_SECRET_ACCESS_KEY -u AWS_SESSION_TOKEN uv run --group test pytest --disable-socket --allow-unix-socket $(TEST_FILE)
+
+test:  ## Run individual unit test: make test TEST_FILE=tests/unit_tests/test.py
+	env -u AWS_ACCESS_KEY_ID -u AWS_SECRET_ACCESS_KEY -u AWS_SESSION_TOKEN uv run --group test pytest --disable-socket --allow-unix-socket $(TEST_FILE)
+
+integration_tests: ## Run all integration tests
+	uv run --group test --group test_integration pytest -n auto $(TEST_FILE)
+
+integration_test: ## Run individual integration test: make integration_test TEST_FILE=tests/integration_tests/integ_test.py
+	uv run --group test --group test_integration pytest -n auto $(TEST_FILE)
+
+coverage_tests: ## Run unit tests with coverage
+	env -u AWS_ACCESS_KEY_ID -u AWS_SECRET_ACCESS_KEY -u AWS_SESSION_TOKEN uv run --group test pytest --cov=langchain_agentcore_codeinterpreter --cov-report=html --cov-report=term-missing --cov-branch tests/unit_tests/
+
+coverage_integration_tests: ## Run integration tests with coverage
+	uv run --group test --group test_integration pytest --cov=langchain_agentcore_codeinterpreter --cov-report=html --cov-report=term-missing --cov-branch tests/integration_tests/
+
+coverage_report: ## Generate coverage report
+	uv run --group test coverage report
+
+coverage_html: ## Generate HTML coverage report
+	uv run --group test coverage html
+
+######################
+# LINTING AND FORMATTING
+######################
+
+# Define a variable for Python and notebook files.
+PYTHON_FILES=.
+MYPY_CACHE=.mypy_cache
+lint format: PYTHON_FILES=.
+lint_diff format_diff: PYTHON_FILES=$(shell git diff --relative=libs/agentcore-codeinterpreter --name-only --diff-filter=d main | grep -E '\.py$$|\.ipynb$$')
+lint_package: PYTHON_FILES=langchain_agentcore_codeinterpreter
+lint_tests: PYTHON_FILES=tests
+lint_tests: MYPY_CACHE=.mypy_cache_test
+
+lint lint_diff lint_package lint_tests: ## Run linter
+	[ "$(PYTHON_FILES)" = "" ] || uv run --all-groups ruff check $(PYTHON_FILES)
+	[ "$(PYTHON_FILES)" = "" ] || uv run --all-groups ruff format $(PYTHON_FILES) --diff
+	[ "$(PYTHON_FILES)" = "" ] || mkdir -p $(MYPY_CACHE) && uv run --all-groups mypy $(PYTHON_FILES) --cache-dir $(MYPY_CACHE)
+
+format format_diff: ## Run code formatter
+	[ "$(PYTHON_FILES)" = "" ] || uv run --all-groups ruff format $(PYTHON_FILES)
+	[ "$(PYTHON_FILES)" = "" ] || uv run --all-groups ruff check --fix $(PYTHON_FILES)
+
+######################
+# DEPENDENCIES
+######################
+
+check_imports: $(shell find langchain_agentcore_codeinterpreter -name '*.py') ## Check missing imports
+	uv run --all-groups python ./scripts/check_imports.py $^
+
+######################
+# HELP
+######################
+
+help: ## Print this help
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-30s\033[0m %s\n", $$1, $$2}'

langchain_agentcore_codeinterpreter-0.0.1/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.4
+Name: langchain-agentcore-codeinterpreter
+Version: 0.0.1
+Summary: Amazon Bedrock AgentCore Code Interpreter sandbox integration for Deep Agents
+Project-URL: Source Code, https://github.com/langchain-ai/langchain-aws/tree/main/libs/agentcore-codeinterpreter
+Project-URL: Repository, https://github.com/langchain-ai/langchain-aws
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agentcore,aws,bedrock,code-interpreter,deepagents,langchain,sandbox
+Requires-Python: <4.0,>=3.11
+Requires-Dist: bedrock-agentcore>=1.1.4
+Requires-Dist: boto3>=1.42.42
+Requires-Dist: deepagents>=0.1.0
+Description-Content-Type: text/markdown
+
+# langchain-agentcore-codeinterpreter
+
+[![PyPI - Version](https://img.shields.io/pypi/v/langchain-agentcore-codeinterpreter?label=%20)](https://pypi.org/project/langchain-agentcore-codeinterpreter/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/langchain-agentcore-codeinterpreter)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-agentcore-codeinterpreter)](https://pypistats.org/packages/langchain-agentcore-codeinterpreter)
+
+Amazon Bedrock AgentCore Code Interpreter sandbox integration for [Deep Agents](https://github.com/langchain-ai/deepagents).
+
+This package provides `AgentCoreSandbox` — a [`SandboxBackendProtocol`](https://docs.langchain.com/oss/deepagents/sandboxes) implementation that wraps AgentCore's [Code Interpreter](https://docs.aws.amazon.com/bedrock/latest/userguide/agentcore-code-interpreter.html), a secure, isolated MicroVM environment for executing code. The caller manages the interpreter lifecycle (`start()` / `stop()`); the sandbox backend handles command execution and file operations.
+
+> **Note:** For the LangChain `BaseTool` integration (used with `create_react_agent` and LangGraph agents), see [`langchain-aws[tools]`](https://github.com/langchain-ai/langchain-aws). This package is specifically for the Deep Agents `BaseSandbox` protocol.
+
+## Prerequisites
+
+**1. AWS credentials** configured via one of the following methods:
+
+```bash
+# Option 1: Long-lived IAM credentials
+export AWS_ACCESS_KEY_ID="your-access-key"
+export AWS_SECRET_ACCESS_KEY="your-secret-key"
+export AWS_REGION="us-west-2"
+
+# Option 2: Temporary credentials (IAM roles, SSO, STS AssumeRole)
+export AWS_ACCESS_KEY_ID="your-access-key"
+export AWS_SECRET_ACCESS_KEY="your-secret-key"
+export AWS_SESSION_TOKEN="your-session-token"
+export AWS_REGION="us-west-2"
+
+# Option 3: AWS CLI profile (picks up ~/.aws/credentials + ~/.aws/config)
+aws configure
+# or for SSO:
+aws configure sso
+aws sso login --profile your-profile
+```
+
+Any method supported by the [boto3 credential chain](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html) works, including EC2 instance profiles, ECS task roles, and environment variables.
+
+**2. IAM permissions** — your credentials must allow `bedrock-agentcore:InvokeCodeInterpreter` (or the equivalent action for your region). See the [AgentCore Code Interpreter docs](https://docs.aws.amazon.com/bedrock/latest/userguide/agentcore-code-interpreter.html) for the required IAM policy.
+
+**3. Region availability** — Code Interpreter is available in select AWS regions. `us-west-2` is a safe default. Pass the region to `CodeInterpreter(region=...)`.
+
+## Quick Install
+
+```bash
+pip install langchain-agentcore-codeinterpreter
+```
+
+## Usage
+
+### Standalone
+
+```python
+from bedrock_agentcore.tools.code_interpreter_client import CodeInterpreter
+
+from langchain_agentcore_codeinterpreter import AgentCoreSandbox
+
+interpreter = CodeInterpreter(region="us-west-2")
+interpreter.start()
+
+backend = AgentCoreSandbox(interpreter=interpreter)
+
+result = backend.execute("echo hello")
+print(result.output)  # "hello"
+
+interpreter.stop()
+```
+
+### With Deep Agents
+
+```python
+from bedrock_agentcore.tools.code_interpreter_client import CodeInterpreter
+from deepagents import create_deep_agent
+
+from langchain_agentcore_codeinterpreter import AgentCoreSandbox
+from langchain_aws import ChatBedrockConverse
+
+interpreter = CodeInterpreter(region="us-west-2")
+interpreter.start()
+
+model = ChatBedrockConverse(
+  model="us.anthropic.claude-sonnet-4-6",
+  region_name="us-west-2",
+)
+backend = AgentCoreSandbox(interpreter=interpreter)
+agent = create_deep_agent(
+    model=model,
+    backend=backend,
+    system_prompt="You are a coding assistant with sandbox access.",
+)
+
+try:
+    result = agent.invoke(
+        {
+            "messages": [
+                {"role": "user", "content": "Create and run a hello world script"}
+            ]
+        }
+    )
+    print(result["messages"][-1].content)
+finally:
+    interpreter.stop()
+```
+
+### File operations
+
+```python
+# Upload files
+backend.upload_files([
+    ("data.csv", b"name,value\nalice,42\nbob,17"),
+    ("analyze.py", b"import csv\nprint('ready')"),
+])
+
+# Download files
+results = backend.download_files(["data.csv"])
+for r in results:
+    if r.content is not None:
+        print(f"{r.path}: {r.content.decode()}")
+    else:
+        print(f"Failed: {r.path}: {r.error}")
+```
+
+## Session behavior
+
+AgentCore sessions cannot be reconnected after `interpreter.stop()` is called. Each `start()` creates a fresh, isolated MicroVM. Sessions auto-expire after a configurable timeout (default 15 minutes, maximum 8 hours).
+
+## Contributing
+
+See the [langchain-aws contributing guide](https://github.com/langchain-ai/langchain-aws/blob/main/.github/CONTRIBUTING.md).
+
+```bash
+cd libs/agentcore-codeinterpreter
+
+# Run unit tests (no network, no AWS credentials needed)
+make tests
+
+# Run linter
+make lint
+
+# Run integration tests (requires AWS credentials)
+make integration_tests
+```

langchain_agentcore_codeinterpreter-0.0.1/README.md

@@ -0,0 +1,141 @@
+# langchain-agentcore-codeinterpreter
+
+[![PyPI - Version](https://img.shields.io/pypi/v/langchain-agentcore-codeinterpreter?label=%20)](https://pypi.org/project/langchain-agentcore-codeinterpreter/#history)
+[![PyPI - License](https://img.shields.io/pypi/l/langchain-agentcore-codeinterpreter)](https://opensource.org/licenses/MIT)
+[![PyPI - Downloads](https://img.shields.io/pepy/dt/langchain-agentcore-codeinterpreter)](https://pypistats.org/packages/langchain-agentcore-codeinterpreter)
+
+Amazon Bedrock AgentCore Code Interpreter sandbox integration for [Deep Agents](https://github.com/langchain-ai/deepagents).
+
+This package provides `AgentCoreSandbox` — a [`SandboxBackendProtocol`](https://docs.langchain.com/oss/deepagents/sandboxes) implementation that wraps AgentCore's [Code Interpreter](https://docs.aws.amazon.com/bedrock/latest/userguide/agentcore-code-interpreter.html), a secure, isolated MicroVM environment for executing code. The caller manages the interpreter lifecycle (`start()` / `stop()`); the sandbox backend handles command execution and file operations.
+
+> **Note:** For the LangChain `BaseTool` integration (used with `create_react_agent` and LangGraph agents), see [`langchain-aws[tools]`](https://github.com/langchain-ai/langchain-aws). This package is specifically for the Deep Agents `BaseSandbox` protocol.
+
+## Prerequisites
+
+**1. AWS credentials** configured via one of the following methods:
+
+```bash
+# Option 1: Long-lived IAM credentials
+export AWS_ACCESS_KEY_ID="your-access-key"
+export AWS_SECRET_ACCESS_KEY="your-secret-key"
+export AWS_REGION="us-west-2"
+
+# Option 2: Temporary credentials (IAM roles, SSO, STS AssumeRole)
+export AWS_ACCESS_KEY_ID="your-access-key"
+export AWS_SECRET_ACCESS_KEY="your-secret-key"
+export AWS_SESSION_TOKEN="your-session-token"
+export AWS_REGION="us-west-2"
+
+# Option 3: AWS CLI profile (picks up ~/.aws/credentials + ~/.aws/config)
+aws configure
+# or for SSO:
+aws configure sso
+aws sso login --profile your-profile
+```
+
+Any method supported by the [boto3 credential chain](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html) works, including EC2 instance profiles, ECS task roles, and environment variables.
+
+**2. IAM permissions** — your credentials must allow `bedrock-agentcore:InvokeCodeInterpreter` (or the equivalent action for your region). See the [AgentCore Code Interpreter docs](https://docs.aws.amazon.com/bedrock/latest/userguide/agentcore-code-interpreter.html) for the required IAM policy.
+
+**3. Region availability** — Code Interpreter is available in select AWS regions. `us-west-2` is a safe default. Pass the region to `CodeInterpreter(region=...)`.
+
+## Quick Install
+
+```bash
+pip install langchain-agentcore-codeinterpreter
+```
+
+## Usage
+
+### Standalone
+
+```python
+from bedrock_agentcore.tools.code_interpreter_client import CodeInterpreter
+
+from langchain_agentcore_codeinterpreter import AgentCoreSandbox
+
+interpreter = CodeInterpreter(region="us-west-2")
+interpreter.start()
+
+backend = AgentCoreSandbox(interpreter=interpreter)
+
+result = backend.execute("echo hello")
+print(result.output)  # "hello"
+
+interpreter.stop()
+```
+
+### With Deep Agents
+
+```python
+from bedrock_agentcore.tools.code_interpreter_client import CodeInterpreter
+from deepagents import create_deep_agent
+
+from langchain_agentcore_codeinterpreter import AgentCoreSandbox
+from langchain_aws import ChatBedrockConverse
+
+interpreter = CodeInterpreter(region="us-west-2")
+interpreter.start()
+
+model = ChatBedrockConverse(
+  model="us.anthropic.claude-sonnet-4-6",
+  region_name="us-west-2",
+)
+backend = AgentCoreSandbox(interpreter=interpreter)
+agent = create_deep_agent(
+    model=model,
+    backend=backend,
+    system_prompt="You are a coding assistant with sandbox access.",
+)
+
+try:
+    result = agent.invoke(
+        {
+            "messages": [
+                {"role": "user", "content": "Create and run a hello world script"}
+            ]
+        }
+    )
+    print(result["messages"][-1].content)
+finally:
+    interpreter.stop()
+```
+
+### File operations
+
+```python
+# Upload files
+backend.upload_files([
+    ("data.csv", b"name,value\nalice,42\nbob,17"),
+    ("analyze.py", b"import csv\nprint('ready')"),
+])
+
+# Download files
+results = backend.download_files(["data.csv"])
+for r in results:
+    if r.content is not None:
+        print(f"{r.path}: {r.content.decode()}")
+    else:
+        print(f"Failed: {r.path}: {r.error}")
+```
+
+## Session behavior
+
+AgentCore sessions cannot be reconnected after `interpreter.stop()` is called. Each `start()` creates a fresh, isolated MicroVM. Sessions auto-expire after a configurable timeout (default 15 minutes, maximum 8 hours).
+
+## Contributing
+
+See the [langchain-aws contributing guide](https://github.com/langchain-ai/langchain-aws/blob/main/.github/CONTRIBUTING.md).
+
+```bash
+cd libs/agentcore-codeinterpreter
+
+# Run unit tests (no network, no AWS credentials needed)
+make tests
+
+# Run linter
+make lint
+
+# Run integration tests (requires AWS credentials)
+make integration_tests
+```

langchain_agentcore_codeinterpreter-0.0.1/langchain_agentcore_codeinterpreter/__init__.py

@@ -0,0 +1,5 @@
+"""Amazon Bedrock AgentCore Code Interpreter sandbox integration for Deep Agents."""
+
+from langchain_agentcore_codeinterpreter.sandbox import AgentCoreSandbox
+
+__all__ = ["AgentCoreSandbox"]