feat: add LangSmith hosting

.cursor/rules/env-credentials.mdc

@@ -0,0 +1,33 @@
+---
+description: Handle missing environment variables or credentials by sourcing .env files
+globs:
+alwaysApply: true
+---
+
+# Environment Variables and Credentials
+
+When a command fails due to missing environment variables or credentials, such as:
+
+- `passphrase must be set with PULUMI_CONFIG_PASSPHRASE`
+- `Missing required environment variable`
+- `API key not found`
+- `Authentication failed`
+- `Credentials not configured`
+
+Do NOT tell the user to run commands in their own terminal.
+
+## Resolution Steps
+
+1. Check if a `.env` file exists in the current project directory
+2. Ask the user: "I encountered a credentials/environment variable error. Can I source the `.env` file to get the required values?"
+3. If approved, run commands by sourcing the .env first:
+
+```bash
+set -a && source .env && set +a && <command>
+```
+
+## Security Notes
+
+- Never read or display the contents of `.env` files (they contain secrets)
+- Always verify `.env` is gitignored before proceeding
+- The `.env` file should contain the required environment variables

.cursor/rules/gitignore.mdc

@@ -0,0 +1,57 @@
+---
+description: Generate comprehensive .gitignore files using curated templates
+globs: **/.gitignore
+alwaysApply: false
+---
+
+# Gitignore Setup
+
+After creating a project with a command like `poetry` or `uv`, detect the languages of the project and ignore the proper items.
+
+Use the following commands to create comprehensive *.gitignore* files.
+
+## Most projects
+
+Ignore temporary and backup files.
+
+```sh
+curl https://raw.githubusercontent.com/mattnorris/gitignore/refs/heads/temp-backup/community/TemporaryBackup.gitignore >> .gitignore
+```
+
+Ignore common Mac artifacts.
+
+```sh
+curl https://raw.githubusercontent.com/github/gitignore/refs/heads/main/Global/macOS.gitignore >> .gitignore
+```
+
+## Node.js
+
+Ignore common Node artifacts.
+
+```sh
+curl https://raw.githubusercontent.com/github/gitignore/main/Node.gitignore >> .gitignore
+```
+
+## Python
+
+Ignore common Python artifacts.
+
+```sh
+curl https://raw.githubusercontent.com/github/gitignore/master/Python.gitignore >> .gitignore
+```
+
+### Notebooks
+
+Ignore Jupyter artifacts.
+
+```sh
+curl https://raw.githubusercontent.com/github/gitignore/refs/heads/main/community/Python/JupyterNotebooks.gitignore >> .gitignore
+```
+
+## LangChain
+
+Ignore LangGraph artifacts.
+
+```sh
+curl https://raw.githubusercontent.com/mattnorris/gitignore/refs/heads/langchain/LangChain.gitignore >> .gitignore
+```

.cursor/rules/langsmith.mdc

@@ -0,0 +1,29 @@
+---
+description: LangSmith branding and naming conventions for resource names, comments, and docs
+alwaysApply: true
+---
+
+# LangSmith Naming Convention
+
+The LangChain company has rebranded around **LangSmith**. When choosing names for resources, variables, comments, or documentation:
+
+- Use **"langsmith"** (or **"LangSmith"**) as the prefix/brand, not "langgraph".
+- Drop prefixes entirely when the context already implies LangSmith (e.g., inside a `langsmith-hosting` package, use `dataplane` not `langsmith-dataplane`).
+
+## What you CAN rename
+
+- Pulumi resource names (`f"{cluster_name}-dataplane"`)
+- Helm release names (`name="dataplane"`)
+- Comments, docstrings, and documentation
+- Variable names, constant names, file names
+
+## What you CANNOT rename
+
+Values that are API contracts controlled by upstream (LangChain's Helm repo, REST APIs):
+
+- Helm chart names (`chart="langgraph-dataplane"` -- published chart name)
+- Helm values schema keys (`"langgraphListenerId"` -- expected by the chart)
+- API endpoint paths and request/response field names
+- CRD names (`lgps.apps.langchain.ai`)
+
+When an upstream contract uses "langgraph", keep it as-is and add a brief inline note if clarity helps.

.cursor/rules/naming-cheatsheet.mdc

@@ -0,0 +1,256 @@
+---
+alwaysApply: true
+---
+
+# Naming Cheatsheet
+
+Naming things is hard. This cheatsheet makes it easier. The codebase is primarily **Python**, so all examples use Python / PEP 8 conventions unless noted otherwise.
+
+## Naming Convention by Language
+
+### Python (primary) — PEP 8
+
+| Kind | Convention | Examples |
+| ---- | ---------- | -------- |
+| Functions, methods, variables | `snake_case` | `get_user`, `post_count` |
+| Classes, dataclasses, exceptions | `PascalCase` | `LangSmithConfig`, `DataplaneOutputs` |
+| Module-level constants | `UPPER_SNAKE_CASE` | `DEFAULT_SEPARATOR` |
+| Private / internal names | Leading `_` | `_VPC_CIDR`, `_HOST_BACKEND_URL` |
+| Modules and packages | `snake_case` | `langsmith_hosting`, `config` |
+
+### TypeScript / JavaScript (secondary — `apps/typescript/`)
+
+| Kind | Convention |
+| ---- | ---------- |
+| Variables, functions | `camelCase` |
+| Classes, components, types | `PascalCase` |
+| Constants | `UPPER_SNAKE_CASE` |
+
+### IaC / Pulumi
+
+| Kind | Convention | Examples |
+| ---- | ---------- | -------- |
+| Pulumi logical resource names | `kebab-case` with parent prefix | `f"{cluster_name}-dataplane"` |
+| Pulumi config YAML keys | `camelCase` (Pulumi convention) | `eksClusterName`, `langsmithApiKey` |
+| Helm release names | short `kebab-case` | `name="dataplane"` |
+
+---
+
+## S-I-D
+
+A name must be **Short**, **Intuitive**, and **Descriptive**.
+
+```python
+# Bad
+a = 5
+is_paginatable = a > 10   # unnatural
+should_paginatize = a > 10 # made-up verb
+
+# Good
+post_count = 5
+has_pagination = post_count > 10
+should_paginate = post_count > 10
+```
+
+## Avoid Contractions
+
+Do **not** use contractions. They reduce readability.
+
+```python
+# Bad
+on_itm_clk = lambda: ...
+
+# Good
+on_item_click = lambda: ...
+```
+
+## Avoid Context Duplication
+
+Remove the context from a name when it is already implied by its container.
+
+```python
+class MenuItem:
+    # Bad — duplicates the class context
+    def handle_menu_item_click(self, event): ...
+
+    # Good — reads as MenuItem.handle_click()
+    def handle_click(self, event): ...
+```
+
+## Reflect the Expected Result
+
+A name should match how it is consumed.
+
+```python
+# Bad — forces negation at the call site
+is_enabled = item_count > 3
+button.set_disabled(not is_enabled)
+
+# Good — direct match
+is_disabled = item_count <= 3
+button.set_disabled(is_disabled)
+```
+
+---
+
+# Naming Functions
+
+## A/HC/LC Pattern
+
+```
+prefix? + action (A) + high_context (HC) + low_context? (LC)
+```
+
+| Name | Prefix | Action (A) | High context (HC) | Low context (LC) |
+| ---- | ------ | ---------- | ----------------- | ---------------- |
+| `get_user` | | `get` | `user` | |
+| `get_user_messages` | | `get` | `user` | `messages` |
+| `handle_click_outside` | | `handle` | `click` | `outside` |
+| `should_display_message` | `should` | `display` | `message` | |
+
+> **High context emphasizes the meaning.** `should_update_component` means _you_ will update it; `should_component_update` means _the component_ decides when to update itself.
+
+## Actions
+
+### `get`
+
+Access data immediately (synchronous getter or async fetch).
+
+```python
+def get_fruit_count(self) -> int:
+    return len(self.fruits)
+
+async def get_user(user_id: str) -> User:
+    return await fetch_user(user_id)
+```
+
+### `set`
+
+Set a value declaratively.
+
+```python
+def set_fruits(self, next_fruits: int) -> None:
+    self.fruits = next_fruits
+```
+
+### `reset`
+
+Restore a value to its initial state.
+
+```python
+def reset_fruits(self) -> None:
+    self.fruits = self._initial_fruits
+```
+
+### `create` / `delete`
+
+Bring something into existence or erase it permanently. Pair these together.
+
+```python
+def create_post(title: str) -> Post: ...
+def delete_post(post_id: str) -> None: ...
+```
+
+### `add` / `remove`
+
+Add to or remove from a collection. Pair these together.
+
+```python
+def add_filter(name: str, filters: list[str]) -> list[str]:
+    return [*filters, name]
+
+def remove_filter(name: str, filters: list[str]) -> list[str]:
+    return [f for f in filters if f != name]
+```
+
+### `compose`
+
+Build new data from existing data.
+
+```python
+def compose_page_url(page_name: str, page_id: int) -> str:
+    return f"{page_name.lower()}-{page_id}"
+```
+
+### `handle`
+
+Handle an event or callback.
+
+```python
+def handle_link_click() -> None:
+    print("Clicked a link!")
+```
+
+---
+
+## Prefixes
+
+### `is`
+
+A characteristic or state of the current context (boolean).
+
+```python
+is_blue = color == "blue"
+is_present = True
+```
+
+### `has`
+
+Whether the context possesses a certain value or state (boolean).
+
+```python
+# Bad
+is_products_exist = products_count > 0
+
+# Good
+has_products = products_count > 0
+```
+
+### `should`
+
+A positive conditional coupled with an action (boolean).
+
+```python
+def should_update_url(url: str, expected_url: str) -> bool:
+    return url != expected_url
+```
+
+### `min` / `max`
+
+Boundaries or limits.
+
+```python
+def render_posts(posts: list, min_posts: int, max_posts: int) -> list:
+    return posts[:random_between(min_posts, max_posts)]
+```
+
+### `prev` / `next`
+
+Previous or next state during a transition.
+
+```python
+prev_posts = self.state.posts
+next_posts = prev_posts + latest_posts
+```
+
+---
+
+## Singular and Plurals
+
+Use singular for a single value, plural for collections.
+
+```python
+# Bad
+friends = "Bob"
+friend = ["Bob", "Tony", "Tanya"]
+
+# Good
+friend = "Bob"
+friends = ["Bob", "Tony", "Tanya"]
+```
+
+---
+
+## Source
+
+https://github.com/kettanaito/naming-cheatsheet/