LangGraph Build Context Planner

Orchestrates LangGraph builds and dev runs that rely on out-of-tree local dependencies, ensuring container paths stay aligned with debugger and watch-mode expectations.

Capabilities

Additional build contexts for external modules

• Given a config at ./examples/plugins/langgraph.json and local dependencies ["../shared/extensions", "/opt/data/connectors"], create_build_plan returns contexts keyed extensions and connectors, maps them to the provided paths, and places them under /app/local_deps/<key> in the generated Dockerfile and Compose output. @test

Remapped import targets

• When the config references ./src/graph.py:graph and a custom auth handler at ../auth/custom.py:auth, the build plan updates runtime mapping so Compose YAML points to /app/local_deps/auth/custom.py:auth while keeping the primary graph at /app/src/graph.py. @test

Dev watch and debugger controls

• Launching dev mode with watch=True, debugger_port=5678, and wait_for_client=True produces a command string that enables rebuild-on-change for the config plus every extra dependency path, binds the debugger port, and blocks until a debugger attaches before serving traffic. @test

Implementation

@generates

API

from dataclasses import dataclass
from pathlib import Path
from typing import Dict, List, Optional

@dataclass
class BuildPlan:
    dockerfile: str
    compose_yaml: str
    contexts: Dict[str, Path]
    remapped_paths: Dict[str, Path]

def create_build_plan(config_path: Path, local_dependencies: List[Path], image_tag: str) -> BuildPlan:
    ...

def render_dev_command(
    plan: BuildPlan,
    watch: bool = False,
    debugger_port: Optional[int] = None,
    wait_for_client: bool = False,
    open_browser: bool = True,
) -> str:
    ...

Dependencies { .dependencies }

langgraph-cli { .dependency }

CLI tooling for validating configurations, remapping local paths into container-friendly locations, generating Docker assets, and running dev/watch/debug flows.

@satisfied-by