welt-io-langgraph 0.3.0__tar.gz

welt_io_langgraph-0.3.0/.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+*.py[cod]
+*.so
+dist/
+.venv*/
+.coverage
+.pytest_cache/
+.ruff_cache/
+src/welt_io_langgraph/_version.py
+.claude/

welt_io_langgraph-0.3.0/CONTRIBUTING.md

@@ -0,0 +1,48 @@
+# Contributing
+
+We welcome contributions! Please follow these guidelines when submitting pull requests.
+
+## Recommended setup
+
+After cloning, enable the git hooks:
+
+```bash
+mise run enable-git-hooks
+```
+
+This wires `./validate.sh` to `pre-commit`, plus DCO and Conventional Commits checks to `commit-msg`, so the requirements below run automatically on each commit.
+
+## Before Submitting a PR
+
+### 1. Run Validation
+
+```bash
+./validate.sh
+```
+
+Runs the project's validation pipeline.
+
+### 2. Sign Commits with DCO
+
+All commits must be signed with DCO. Use `git commit -s` to sign your commits.
+
+- Use your real name (no pseudonyms)
+- All commits in a PR must be signed
+- If the DCO check fails, see the check details page for instructions on fixing unsigned commits
+
+For more about DCO: https://developercertificate.org/
+
+### 3. Follow Conventional Commits
+
+Commit subjects (first line) must follow `<type>(<scope>)?!?: <description>`. Allowed types: `feat`, `fix`, `chore`, `docs`. Append `!` for breaking changes.
+
+```
+feat: add dark-mode toggle
+fix(auth): handle expired token
+chore: bump dependencies
+feat!: drop legacy API
+```
+
+Other types (`refactor`, `ci`, `test`, etc.) are intentionally rejected — use `chore:` instead.
+
+For more about Conventional Commits: https://www.conventionalcommits.org/

welt_io_langgraph-0.3.0/LICENSE

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

welt_io_langgraph-0.3.0/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.4
+Name: welt-io-langgraph
+Version: 0.3.0
+Summary: The LangGraph (Python) adapter for Welt's wire contract
+Project-URL: Repository, https://github.com/iwamot/welt-io-langgraph
+Project-URL: Issues, https://github.com/iwamot/welt-io-langgraph/issues
+Author: Takashi Iwamoto
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agentcore,bedrock,langgraph,slack,welt
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# welt-io-langgraph
+
+[![pypi](https://img.shields.io/pypi/v/welt-io-langgraph.svg)](https://pypi.org/project/welt-io-langgraph/)
+[![python](https://img.shields.io/pypi/pyversions/welt-io-langgraph.svg)](https://pypi.org/project/welt-io-langgraph/)
+
+The [LangGraph](https://docs.langchain.com/oss/python/langgraph/overview) (Python) adapter for [Welt](https://github.com/iwamot/welt)'s wire contract.
+
+## Install
+
+```bash
+uv add welt-io-langgraph
+```
+
+## Usage
+
+See [`examples/agent`](examples/agent) — the smallest complete agent built on this package (text streaming, tool use, file output, file input, and human-approval tools). The sections below explain the adapters it wires in.
+
+## API
+
+The wire between Welt and the agent is JSON, specified by [Welt's wire contract](https://github.com/iwamot/welt/blob/main/docs/wire.md) — plain LangGraph values do not fit it in either direction. Two functions adapt the inbound payload, three the outbound stream. The adapters target LangGraph 1.x and LangChain 1.x, whose messages carry [standard content blocks](https://docs.langchain.com/oss/python/langchain/messages).
+
+### Inbound
+
+#### `decode_messages(messages)`
+
+Turns Welt's Converse-shaped messages — built from the Slack thread, file bytes base64-encoded — into role/content message dicts that feed the graph input (`{"messages": decoded}`) as-is:
+
+| Converse block | Standard content block |
+|---|---|
+| Text | Text |
+| Image | Image |
+| Document | File (the document's name carried as `filename`) |
+| Video | Video |
+
+Each file-carrying block gets the media type LangChain models expect in place of the Converse format token, and the base64 data stays base64 — standard content blocks need no decoding. Malformed entries are skipped.
+
+#### `decode_interrupt_responses(responses)`
+
+Turns Welt's resume payload — a mapping of interrupt id to the answer a human chose — into the mapping `Command(resume=...)` takes, answering every pending interrupt at once:
+
+```python
+agent.astream(
+    Command(resume=decode_interrupt_responses(payload["interrupt_responses"])),
+    config,
+    stream_mode=["messages", "updates", "custom"],
+)
+```
+
+The interrupt ids are LangGraph's own, as emitted by `renderable_events`; the config must point at the interrupted thread, which the host app stashes when an interrupt event goes by (see the [example agent](examples/agent)).
+
+### Outbound
+
+#### `renderable_events(stream)`
+
+Reduces the `(mode, payload)` items of `astream(..., stream_mode=["messages", "updates", "custom"])` — whose values Welt does not render — to the events Welt renders:
+
+| LangGraph emits | On the wire | In the Slack thread |
+|---|---|---|
+| Token deltas | `data` | The streamed reply |
+| Tool calls and tool messages | `current_tool_use` / `tool_result` | "Using tool" indicators (tool output stays off the wire) |
+| Image / file / video content blocks a tool or the model returns | `file` | An uploaded file ([size limits](https://github.com/iwamot/welt/blob/main/docs/wire.md#limits)) |
+| Pending [interrupts](https://docs.langchain.com/oss/python/langgraph/interrupts) | `interrupt` | Buttons and/or a text field |
+
+A run that stops for human input ends its stream with one `interrupt` event per pending interrupt; agents that do not use interrupts see no change.
+
+#### `file_event(name, data)`
+
+Builds the same `file` event from a filename and raw bytes, for attaching arbitrary files of your own. Yield it from the host app alongside the reduced stream, or pass it to LangGraph's custom stream writer to attach a file from inside a tool — `renderable_events` passes it through by itself:
+
+```python
+writer = get_stream_writer()
+writer(file_event("report.csv", csv_bytes))
+```
+
+#### `interrupt_reason(message, options=..., input=...)`
+
+Builds the structured reason Welt renders as a message with the specified widgets — choice buttons (`options`), a free-text field (`input`), or both. The specs are [the wire's own shapes](https://github.com/iwamot/welt/blob/main/docs/wire.md#interrupt); omitted fields keep Welt's defaults, and a typo becomes an immediate `ValueError` instead of a silent fallback to Welt's default rendering:
+
+```python
+answer = interrupt(
+    interrupt_reason(
+        "Deploy to prod?",
+        [
+            {"value": "y", "label": "Deploy", "style": "primary"},
+            {"value": "n", "label": "Cancel"},
+        ],
+        input={"label": "Or tell me what to do instead"},
+    )
+)
+```
+
+## Working with interrupts
+
+[Welt's Interrupts doc](https://github.com/iwamot/welt/blob/main/docs/interrupts.md) covers the Slack side: how each reason renders, who can answer, multiple questions, and expiry. On the LangGraph side:
+
+- **`interrupt` needs a checkpointer**, even though the conversation history lives in Slack — pausing and resuming run through checkpoints. An in-memory checkpointer works on AgentCore Runtime, where each session keeps its own microVM.
+- **Start each conversation turn on a fresh thread.** Welt sends the whole Slack thread every turn by default, so letting the checkpointer stack turns into its own history would double the conversation. Resume alone reuses the interrupted thread's config. (An agent that keeps its own history instead sets `AGENT_MANAGES_HISTORY` on the Welt side.)
+- **A plain interrupt value renders too.** Any non-structured value — `interrupt("Deploy to prod?")` — becomes a question with Welt's default **Approve** / **Deny** buttons, whose answers arrive as `y` / `n`.
+- **Code before `interrupt` runs again on resume.** LangGraph re-executes the interrupted node (or tool) from its start, so wrap whatever precedes an interrupt and must not run twice — side effects, or work that must match what the human approved — in a [LangGraph task](https://docs.langchain.com/oss/python/langgraph/durable-execution): a completed task is not re-executed on resume; its saved result is reused. The [example agent](examples/agent)'s `sample_draft_report` shows the pattern.
+
+## Supported Versions
+
+Welt releases first; welt-io-langgraph follows, mirroring the minor version. While both are 0.x, a welt-io-langgraph 0.Y release supports Welt v0.Y — other combinations may work, but come with no guarantee.
+
+## License
+
+MIT

welt_io_langgraph-0.3.0/README.md

@@ -0,0 +1,107 @@
+# welt-io-langgraph
+
+[![pypi](https://img.shields.io/pypi/v/welt-io-langgraph.svg)](https://pypi.org/project/welt-io-langgraph/)
+[![python](https://img.shields.io/pypi/pyversions/welt-io-langgraph.svg)](https://pypi.org/project/welt-io-langgraph/)
+
+The [LangGraph](https://docs.langchain.com/oss/python/langgraph/overview) (Python) adapter for [Welt](https://github.com/iwamot/welt)'s wire contract.
+
+## Install
+
+```bash
+uv add welt-io-langgraph
+```
+
+## Usage
+
+See [`examples/agent`](examples/agent) — the smallest complete agent built on this package (text streaming, tool use, file output, file input, and human-approval tools). The sections below explain the adapters it wires in.
+
+## API
+
+The wire between Welt and the agent is JSON, specified by [Welt's wire contract](https://github.com/iwamot/welt/blob/main/docs/wire.md) — plain LangGraph values do not fit it in either direction. Two functions adapt the inbound payload, three the outbound stream. The adapters target LangGraph 1.x and LangChain 1.x, whose messages carry [standard content blocks](https://docs.langchain.com/oss/python/langchain/messages).
+
+### Inbound
+
+#### `decode_messages(messages)`
+
+Turns Welt's Converse-shaped messages — built from the Slack thread, file bytes base64-encoded — into role/content message dicts that feed the graph input (`{"messages": decoded}`) as-is:
+
+| Converse block | Standard content block |
+|---|---|
+| Text | Text |
+| Image | Image |
+| Document | File (the document's name carried as `filename`) |
+| Video | Video |
+
+Each file-carrying block gets the media type LangChain models expect in place of the Converse format token, and the base64 data stays base64 — standard content blocks need no decoding. Malformed entries are skipped.
+
+#### `decode_interrupt_responses(responses)`
+
+Turns Welt's resume payload — a mapping of interrupt id to the answer a human chose — into the mapping `Command(resume=...)` takes, answering every pending interrupt at once:
+
+```python
+agent.astream(
+    Command(resume=decode_interrupt_responses(payload["interrupt_responses"])),
+    config,
+    stream_mode=["messages", "updates", "custom"],
+)
+```
+
+The interrupt ids are LangGraph's own, as emitted by `renderable_events`; the config must point at the interrupted thread, which the host app stashes when an interrupt event goes by (see the [example agent](examples/agent)).
+
+### Outbound
+
+#### `renderable_events(stream)`
+
+Reduces the `(mode, payload)` items of `astream(..., stream_mode=["messages", "updates", "custom"])` — whose values Welt does not render — to the events Welt renders:
+
+| LangGraph emits | On the wire | In the Slack thread |
+|---|---|---|
+| Token deltas | `data` | The streamed reply |
+| Tool calls and tool messages | `current_tool_use` / `tool_result` | "Using tool" indicators (tool output stays off the wire) |
+| Image / file / video content blocks a tool or the model returns | `file` | An uploaded file ([size limits](https://github.com/iwamot/welt/blob/main/docs/wire.md#limits)) |
+| Pending [interrupts](https://docs.langchain.com/oss/python/langgraph/interrupts) | `interrupt` | Buttons and/or a text field |
+
+A run that stops for human input ends its stream with one `interrupt` event per pending interrupt; agents that do not use interrupts see no change.
+
+#### `file_event(name, data)`
+
+Builds the same `file` event from a filename and raw bytes, for attaching arbitrary files of your own. Yield it from the host app alongside the reduced stream, or pass it to LangGraph's custom stream writer to attach a file from inside a tool — `renderable_events` passes it through by itself:
+
+```python
+writer = get_stream_writer()
+writer(file_event("report.csv", csv_bytes))
+```
+
+#### `interrupt_reason(message, options=..., input=...)`
+
+Builds the structured reason Welt renders as a message with the specified widgets — choice buttons (`options`), a free-text field (`input`), or both. The specs are [the wire's own shapes](https://github.com/iwamot/welt/blob/main/docs/wire.md#interrupt); omitted fields keep Welt's defaults, and a typo becomes an immediate `ValueError` instead of a silent fallback to Welt's default rendering:
+
+```python
+answer = interrupt(
+    interrupt_reason(
+        "Deploy to prod?",
+        [
+            {"value": "y", "label": "Deploy", "style": "primary"},
+            {"value": "n", "label": "Cancel"},
+        ],
+        input={"label": "Or tell me what to do instead"},
+    )
+)
+```
+
+## Working with interrupts
+
+[Welt's Interrupts doc](https://github.com/iwamot/welt/blob/main/docs/interrupts.md) covers the Slack side: how each reason renders, who can answer, multiple questions, and expiry. On the LangGraph side:
+
+- **`interrupt` needs a checkpointer**, even though the conversation history lives in Slack — pausing and resuming run through checkpoints. An in-memory checkpointer works on AgentCore Runtime, where each session keeps its own microVM.
+- **Start each conversation turn on a fresh thread.** Welt sends the whole Slack thread every turn by default, so letting the checkpointer stack turns into its own history would double the conversation. Resume alone reuses the interrupted thread's config. (An agent that keeps its own history instead sets `AGENT_MANAGES_HISTORY` on the Welt side.)
+- **A plain interrupt value renders too.** Any non-structured value — `interrupt("Deploy to prod?")` — becomes a question with Welt's default **Approve** / **Deny** buttons, whose answers arrive as `y` / `n`.
+- **Code before `interrupt` runs again on resume.** LangGraph re-executes the interrupted node (or tool) from its start, so wrap whatever precedes an interrupt and must not run twice — side effects, or work that must match what the human approved — in a [LangGraph task](https://docs.langchain.com/oss/python/langgraph/durable-execution): a completed task is not re-executed on resume; its saved result is reused. The [example agent](examples/agent)'s `sample_draft_report` shows the pattern.
+
+## Supported Versions
+
+Welt releases first; welt-io-langgraph follows, mirroring the minor version. While both are 0.x, a welt-io-langgraph 0.Y release supports Welt v0.Y — other combinations may work, but come with no guarantee.
+
+## License
+
+MIT

welt_io_langgraph-0.3.0/SECURITY.md

@@ -0,0 +1,9 @@
+# Security Policy
+
+## Disclaimer
+
+This software is provided "as is" without warranty. Security issues will be addressed on a best-effort basis.
+
+## Reporting a Vulnerability
+
+Please report security vulnerabilities through GitHub's Security Advisory "Report a Vulnerability" feature.

welt_io_langgraph-0.3.0/mise.lock

@@ -0,0 +1,178 @@
+# @generated - this file is auto-generated by `mise lock` https://mise.jdx.dev/dev-tools/mise-lock.html
+
+[[tools."aqua:astral-sh/ruff"]]
+version = "0.15.22"
+backend = "aqua:astral-sh/ruff"
+
+[tools."aqua:astral-sh/ruff"."platforms.linux-arm64"]
+checksum = "sha256:88feb2dc2fafb92482185201f4d483134fbaab10370c79512d3dd372f1d3f28b"
+url = "https://github.com/astral-sh/ruff/releases/download/0.15.22/ruff-aarch64-unknown-linux-musl.tar.gz"
+url_api = "https://api.github.com/repos/astral-sh/ruff/releases/assets/479313917"
+provenance = "github-attestations"
+
+[tools."aqua:astral-sh/ruff"."platforms.linux-arm64-musl"]
+checksum = "sha256:88feb2dc2fafb92482185201f4d483134fbaab10370c79512d3dd372f1d3f28b"
+url = "https://github.com/astral-sh/ruff/releases/download/0.15.22/ruff-aarch64-unknown-linux-musl.tar.gz"
+url_api = "https://api.github.com/repos/astral-sh/ruff/releases/assets/479313917"
+provenance = "github-attestations"
+
+[tools."aqua:astral-sh/ruff"."platforms.linux-x64"]
+checksum = "sha256:853462df618fb9f156a9f04d9d899d9e5a9e1a43fbffaec72df4bb159348e71b"
+url = "https://github.com/astral-sh/ruff/releases/download/0.15.22/ruff-x86_64-unknown-linux-musl.tar.gz"
+url_api = "https://api.github.com/repos/astral-sh/ruff/releases/assets/479314045"
+provenance = "github-attestations"
+
+[tools."aqua:astral-sh/ruff"."platforms.linux-x64-musl"]
+checksum = "sha256:853462df618fb9f156a9f04d9d899d9e5a9e1a43fbffaec72df4bb159348e71b"
+url = "https://github.com/astral-sh/ruff/releases/download/0.15.22/ruff-x86_64-unknown-linux-musl.tar.gz"
+url_api = "https://api.github.com/repos/astral-sh/ruff/releases/assets/479314045"
+provenance = "github-attestations"
+
+[tools."aqua:astral-sh/ruff"."platforms.macos-arm64"]
+checksum = "sha256:a2881af26fd1d19f4932c4ddf1e70b4e0efcf48513c5dae082564e03f0b467a3"
+url = "https://github.com/astral-sh/ruff/releases/download/0.15.22/ruff-aarch64-apple-darwin.tar.gz"
+url_api = "https://api.github.com/repos/astral-sh/ruff/releases/assets/479313898"
+provenance = "github-attestations"
+
+[tools."aqua:astral-sh/ruff"."platforms.macos-x64"]
+checksum = "sha256:687a9ceb88ab85dab061026d5017218225a481121b1a40862cc8f92b56f18090"
+url = "https://github.com/astral-sh/ruff/releases/download/0.15.22/ruff-x86_64-apple-darwin.tar.gz"
+url_api = "https://api.github.com/repos/astral-sh/ruff/releases/assets/479314007"
+provenance = "github-attestations"
+
+[tools."aqua:astral-sh/ruff"."platforms.windows-x64"]
+checksum = "sha256:6e5419593984941405e9add902e89c6ea4af87d97919ac5ef82e1bc4e43bbd8d"
+url = "https://github.com/astral-sh/ruff/releases/download/0.15.22/ruff-x86_64-pc-windows-msvc.zip"
+url_api = "https://api.github.com/repos/astral-sh/ruff/releases/assets/479314019"
+provenance = "github-attestations"
+
+[[tools."aqua:astral-sh/ty"]]
+version = "0.0.63"
+backend = "aqua:astral-sh/ty"
+
+[tools."aqua:astral-sh/ty"."platforms.linux-arm64"]
+checksum = "sha256:e44b9da55ec237a8e8c53991c9df56603d2948d721c9710ec430e4112e2fbe6e"
+url = "https://github.com/astral-sh/ty/releases/download/0.0.63/ty-aarch64-unknown-linux-musl.tar.gz"
+url_api = "https://api.github.com/repos/astral-sh/ty/releases/assets/487124536"
+provenance = "github-attestations"
+
+[tools."aqua:astral-sh/ty"."platforms.linux-arm64-musl"]
+checksum = "sha256:e44b9da55ec237a8e8c53991c9df56603d2948d721c9710ec430e4112e2fbe6e"
+url = "https://github.com/astral-sh/ty/releases/download/0.0.63/ty-aarch64-unknown-linux-musl.tar.gz"
+url_api = "https://api.github.com/repos/astral-sh/ty/releases/assets/487124536"
+provenance = "github-attestations"
+
+[tools."aqua:astral-sh/ty"."platforms.linux-x64"]
+checksum = "sha256:363c340abc2490f3cfd7d9b829ff89cd8e79a41f8d9db911bf78dae48c36c436"
+url = "https://github.com/astral-sh/ty/releases/download/0.0.63/ty-x86_64-unknown-linux-musl.tar.gz"
+url_api = "https://api.github.com/repos/astral-sh/ty/releases/assets/487124639"
+provenance = "github-attestations"
+
+[tools."aqua:astral-sh/ty"."platforms.linux-x64-musl"]
+checksum = "sha256:363c340abc2490f3cfd7d9b829ff89cd8e79a41f8d9db911bf78dae48c36c436"
+url = "https://github.com/astral-sh/ty/releases/download/0.0.63/ty-x86_64-unknown-linux-musl.tar.gz"
+url_api = "https://api.github.com/repos/astral-sh/ty/releases/assets/487124639"
+provenance = "github-attestations"
+
+[tools."aqua:astral-sh/ty"."platforms.macos-arm64"]
+checksum = "sha256:30d09000d5f2524769816c57f85e19505676d23618aad6a43e046d5c50510988"
+url = "https://github.com/astral-sh/ty/releases/download/0.0.63/ty-aarch64-apple-darwin.tar.gz"
+url_api = "https://api.github.com/repos/astral-sh/ty/releases/assets/487124513"
+provenance = "github-attestations"
+
+[tools."aqua:astral-sh/ty"."platforms.macos-x64"]
+checksum = "sha256:5a18373c8bd6894be5f595a2cbefa4e72b7d5b95cfe2c2f075024a949064bba9"
+url = "https://github.com/astral-sh/ty/releases/download/0.0.63/ty-x86_64-apple-darwin.tar.gz"
+url_api = "https://api.github.com/repos/astral-sh/ty/releases/assets/487124618"
+provenance = "github-attestations"
+
+[tools."aqua:astral-sh/ty"."platforms.windows-x64"]
+checksum = "sha256:f9476788c8c27c328bff1b4691dbb1aa6f1591e103e630caffb9ccb70648a1a0"
+url = "https://github.com/astral-sh/ty/releases/download/0.0.63/ty-x86_64-pc-windows-msvc.zip"
+url_api = "https://api.github.com/repos/astral-sh/ty/releases/assets/487124623"
+provenance = "github-attestations"
+
+[[tools."aqua:astral-sh/uv"]]
+version = "0.11.31"
+backend = "aqua:astral-sh/uv"
+
+[tools."aqua:astral-sh/uv"."platforms.linux-arm64"]
+checksum = "sha256:49cb5ffce40cc9c85355caa8104f7b61c40a8daac7334f4bc841cad1a7bb359e"
+url = "https://github.com/astral-sh/uv/releases/download/0.11.31/uv-aarch64-unknown-linux-musl.tar.gz"
+url_api = "https://api.github.com/repos/astral-sh/uv/releases/assets/485371019"
+provenance = "github-attestations"
+
+[tools."aqua:astral-sh/uv"."platforms.linux-arm64-musl"]
+checksum = "sha256:49cb5ffce40cc9c85355caa8104f7b61c40a8daac7334f4bc841cad1a7bb359e"
+url = "https://github.com/astral-sh/uv/releases/download/0.11.31/uv-aarch64-unknown-linux-musl.tar.gz"
+url_api = "https://api.github.com/repos/astral-sh/uv/releases/assets/485371019"
+provenance = "github-attestations"
+
+[tools."aqua:astral-sh/uv"."platforms.linux-x64"]
+checksum = "sha256:89048b7e30a6c459fa7e8f2e91cfdc413dc004dcbddc6c2af5e09df123e3246d"
+url = "https://github.com/astral-sh/uv/releases/download/0.11.31/uv-x86_64-unknown-linux-musl.tar.gz"
+url_api = "https://api.github.com/repos/astral-sh/uv/releases/assets/485371115"
+provenance = "github-attestations"
+
+[tools."aqua:astral-sh/uv"."platforms.linux-x64-musl"]
+checksum = "sha256:89048b7e30a6c459fa7e8f2e91cfdc413dc004dcbddc6c2af5e09df123e3246d"
+url = "https://github.com/astral-sh/uv/releases/download/0.11.31/uv-x86_64-unknown-linux-musl.tar.gz"
+url_api = "https://api.github.com/repos/astral-sh/uv/releases/assets/485371115"
+provenance = "github-attestations"
+
+[tools."aqua:astral-sh/uv"."platforms.macos-arm64"]
+checksum = "sha256:b2b93e82a6786f9c7cb89fd4ca0e859a147b292ae8f6f95784f9742f0efec39e"
+url = "https://github.com/astral-sh/uv/releases/download/0.11.31/uv-aarch64-apple-darwin.tar.gz"
+url_api = "https://api.github.com/repos/astral-sh/uv/releases/assets/485371001"
+provenance = "github-attestations"
+
+[tools."aqua:astral-sh/uv"."platforms.macos-x64"]
+checksum = "sha256:33ee6bd62b57fcd77a499deb54e4432dc1e1a2f3d34930ba987ad8b43f9c7bc7"
+url = "https://github.com/astral-sh/uv/releases/download/0.11.31/uv-x86_64-apple-darwin.tar.gz"
+url_api = "https://api.github.com/repos/astral-sh/uv/releases/assets/485371098"
+provenance = "github-attestations"
+
+[tools."aqua:astral-sh/uv"."platforms.windows-x64"]
+checksum = "sha256:410c2fd3126ff621c9450a21cfc200002c7540dc48d130069a8f619cdb0a811b"
+url = "https://github.com/astral-sh/uv/releases/download/0.11.31/uv-x86_64-pc-windows-msvc.zip"
+url_api = "https://api.github.com/repos/astral-sh/uv/releases/assets/485371099"
+provenance = "github-attestations"
+
+[[tools.python]]
+version = "3.14.6"
+backend = "core:python"
+
+[tools.python."platforms.linux-arm64"]
+checksum = "sha256:c2a2caa03aa9beb77a5bbb5a009c8fe77b96a56925da2dba18095237e30faf04"
+url = "https://github.com/astral-sh/python-build-standalone/releases/download/20260718/cpython-3.14.6+20260718-aarch64-unknown-linux-gnu-install_only_stripped.tar.gz"
+provenance = "github-attestations"
+
+[tools.python."platforms.linux-arm64-musl"]
+checksum = "sha256:ff7da86be2a3d7fdf0124da7b408ad2de3c7ca8d6c19e6c449ec2cddedd01a8b"
+url = "https://github.com/astral-sh/python-build-standalone/releases/download/20260718/cpython-3.14.6+20260718-aarch64-unknown-linux-musl-install_only_stripped.tar.gz"
+provenance = "github-attestations"
+
+[tools.python."platforms.linux-x64"]
+checksum = "sha256:86bf107f65fc30b56f2b263b26797fcbb1661f5315910cdbf27f733eb8738b74"
+url = "https://github.com/astral-sh/python-build-standalone/releases/download/20260718/cpython-3.14.6+20260718-x86_64-unknown-linux-gnu-install_only_stripped.tar.gz"
+provenance = "github-attestations"
+
+[tools.python."platforms.linux-x64-musl"]
+checksum = "sha256:2c27fc15bde497fbd78a8d5d38559ee1a8c93110952d5c2b390bc6481e2be415"
+url = "https://github.com/astral-sh/python-build-standalone/releases/download/20260718/cpython-3.14.6+20260718-x86_64-unknown-linux-musl-install_only_stripped.tar.gz"
+provenance = "github-attestations"
+
+[tools.python."platforms.macos-arm64"]
+checksum = "sha256:5e8e0746cb0108d138f510cfbb28c4b031b9ed63bbbe3e43a34c77d4663c4fa1"
+url = "https://github.com/astral-sh/python-build-standalone/releases/download/20260718/cpython-3.14.6+20260718-aarch64-apple-darwin-install_only_stripped.tar.gz"
+provenance = "github-attestations"
+
+[tools.python."platforms.macos-x64"]
+checksum = "sha256:2d03154bc83c6d2d048bba23bb808b020e352028f5bd541a740e54467fc9cc75"
+url = "https://github.com/astral-sh/python-build-standalone/releases/download/20260718/cpython-3.14.6+20260718-x86_64-apple-darwin-install_only_stripped.tar.gz"
+provenance = "github-attestations"
+
+[tools.python."platforms.windows-x64"]
+checksum = "sha256:0c5c9f231704fb49149bc8f2b9d9dbe43eeaf6c54f362ef0fc2066ce64b4d10f"
+url = "https://github.com/astral-sh/python-build-standalone/releases/download/20260718/cpython-3.14.6+20260718-x86_64-pc-windows-msvc-install_only_stripped.tar.gz"
+provenance = "github-attestations"

welt_io_langgraph-0.3.0/pyproject.toml

@@ -0,0 +1,113 @@
+[project]
+name = "welt-io-langgraph"
+dynamic = ["version"]
+description = "The LangGraph (Python) adapter for Welt's wire contract"
+readme = "README.md"
+# Floor matches the AgentCore CLI's generated agent projects (requires-python
+# >= 3.10), so `uv add welt-io-langgraph` resolves there without edits.
+requires-python = ">=3.10"
+license = "MIT"
+authors = [{ name = "Takashi Iwamoto" }]
+keywords = ["welt", "slack", "agentcore", "bedrock", "langgraph"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development",
+    "Typing :: Typed",
+]
+dependencies = []
+
+[project.urls]
+Repository = "https://github.com/iwamot/welt-io-langgraph"
+Issues = "https://github.com/iwamot/welt-io-langgraph/issues"
+
+# The dev group is included by `uv sync` and `uv run` by default, and —
+# unlike a dev extra — is not published in the wheel metadata.
+[dependency-groups]
+dev = [
+    # examples/agent is a standalone deployable; its dependencies are
+    # installed here so lint and type checks cover it against the local
+    # library.
+    "bedrock-agentcore==1.18.1",
+    "langchain==1.3.14",
+    "langchain-aws==1.6.3",
+    "langgraph==1.2.9",
+    "pip-licenses==5.5.5",
+    "pytest==9.1.1",
+    "pytest-cov==7.1.0",
+]
+
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+source = "vcs"
+
+[tool.hatch.build.hooks.vcs]
+version-file = "src/welt_io_langgraph/_version.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/welt_io_langgraph"]
+
+[tool.hatch.build.targets.sdist]
+exclude = [
+    "/.codecov.yml",
+    "/.github",
+    "/compatibility.sh",
+    "/examples",
+    "/mise.toml",
+    "/uv.lock",
+    "/validate.sh",
+]
+
+[tool.uv]
+exclude-newer = "1 day"
+
+[tool.ruff]
+include = ["*.py", "examples/**/*.py", "src/**/*.py", "tests/**/*.py"]
+
+[tool.ruff.lint]
+# Reference: https://pydevtools.com/handbook/how-to/how-to-configure-recommended-ruff-defaults/
+extend-select = [
+    "F",    # Pyflakes rules
+    "W",    # PyCodeStyle warnings
+    # "E",    # PyCodeStyle errors
+    "I",    # Sort imports properly
+    "UP",   # Warn if certain things can changed due to newer Python versions
+    "C4",   # Catch incorrect use of comprehensions, dict, list, etc
+    "FA",   # Enforce from __future__ import annotations
+    "ISC",  # Good use of string concatenation
+    "ICN",  # Use common import conventions
+    "RET",  # Good return practices
+    # "SIM",  # Common simplification rules
+    "TID",  # Some good import practices
+    # "TC",   # Enforce importing certain types in a TYPE_CHECKING block
+    "PTH",  # Use pathlib instead of os.path
+    "TD",   # Be diligent with TODO comments
+    # "NPY",  # Some numpy-specific things
+    # Not in the reference URL
+    "S",    # flake8-bandit (security)
+]
+ignore = [
+    "S101",  # Allow assert in tests (pytest standard practice)
+]
+
+[tool.ty.src]
+include = ["examples", "src", "tests"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.coverage.run]
+source = ["welt_io_langgraph"]
+branch = true
+
+[tool.coverage.report]
+show_missing = true