welt-io-strands 0.3.3__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,10 @@
1
+ __pycache__/
2
+ *.py[cod]
3
+ *.so
4
+ dist/
5
+ .venv*/
6
+ .coverage
7
+ .pytest_cache/
8
+ .ruff_cache/
9
+ src/welt_io_strands/_version.py
10
+ .claude/
@@ -0,0 +1,48 @@
1
+ # Contributing
2
+
3
+ We welcome contributions! Please follow these guidelines when submitting pull requests.
4
+
5
+ ## Recommended setup
6
+
7
+ After cloning, enable the git hooks:
8
+
9
+ ```bash
10
+ mise run enable-git-hooks
11
+ ```
12
+
13
+ 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.
14
+
15
+ ## Before Submitting a PR
16
+
17
+ ### 1. Run Validation
18
+
19
+ ```bash
20
+ ./validate.sh
21
+ ```
22
+
23
+ Runs the project's validation pipeline.
24
+
25
+ ### 2. Sign Commits with DCO
26
+
27
+ All commits must be signed with DCO. Use `git commit -s` to sign your commits.
28
+
29
+ - Use your real name (no pseudonyms)
30
+ - All commits in a PR must be signed
31
+ - If the DCO check fails, see the check details page for instructions on fixing unsigned commits
32
+
33
+ For more about DCO: https://developercertificate.org/
34
+
35
+ ### 3. Follow Conventional Commits
36
+
37
+ Commit subjects (first line) must follow `<type>(<scope>)?!?: <description>`. Allowed types: `feat`, `fix`, `chore`, `docs`. Append `!` for breaking changes.
38
+
39
+ ```
40
+ feat: add dark-mode toggle
41
+ fix(auth): handle expired token
42
+ chore: bump dependencies
43
+ feat!: drop legacy API
44
+ ```
45
+
46
+ Other types (`refactor`, `ci`, `test`, etc.) are intentionally rejected — use `chore:` instead.
47
+
48
+ For more about Conventional Commits: https://www.conventionalcommits.org/
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Takashi Iwamoto
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,112 @@
1
+ Metadata-Version: 2.4
2
+ Name: welt-io-strands
3
+ Version: 0.3.3
4
+ Summary: The Strands Agents (Python) adapter for Welt's wire contract
5
+ Project-URL: Repository, https://github.com/iwamot/welt-io-strands
6
+ Project-URL: Issues, https://github.com/iwamot/welt-io-strands/issues
7
+ Author: Takashi Iwamoto
8
+ License-Expression: MIT
9
+ License-File: LICENSE
10
+ Keywords: agentcore,bedrock,slack,strands,welt
11
+ Classifier: Development Status :: 3 - Alpha
12
+ Classifier: Intended Audience :: Developers
13
+ Classifier: Programming Language :: Python :: 3
14
+ Classifier: Programming Language :: Python :: 3.10
15
+ Classifier: Programming Language :: Python :: 3.11
16
+ Classifier: Programming Language :: Python :: 3.12
17
+ Classifier: Programming Language :: Python :: 3.13
18
+ Classifier: Programming Language :: Python :: 3.14
19
+ Classifier: Topic :: Software Development
20
+ Classifier: Typing :: Typed
21
+ Requires-Python: >=3.10
22
+ Description-Content-Type: text/markdown
23
+
24
+ # welt-io-strands
25
+
26
+ [![pypi](https://img.shields.io/pypi/v/welt-io-strands.svg)](https://pypi.org/project/welt-io-strands/)
27
+ [![python](https://img.shields.io/pypi/pyversions/welt-io-strands.svg)](https://pypi.org/project/welt-io-strands/)
28
+
29
+ The [Strands Agents](https://strandsagents.com/) (Python) adapter for [Welt](https://github.com/iwamot/welt)'s wire contract — one of Welt's [agent-side adapters](https://github.com/iwamot/welt#agent-side-adapters).
30
+
31
+ ## Install
32
+
33
+ ```bash
34
+ uv add welt-io-strands
35
+ ```
36
+
37
+ ## Usage
38
+
39
+ See [`examples/agent`](examples/agent) — the smallest complete agent built on this package (text streaming, image generation, file input, and a human-approval tool), which doubles as the example for [Welt's Quick Start](https://github.com/iwamot/welt#quick-start). The sections below explain the adapters it wires in.
40
+
41
+ ## API
42
+
43
+ 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 Strands values do not fit it in either direction. Two functions adapt the inbound payload, three the outbound stream.
44
+
45
+ ### Inbound
46
+
47
+ #### `decode_messages(messages)`
48
+
49
+ Returns a copy of Welt's Converse-shaped messages with the base64-encoded file bytes restored to the raw bytes Strands expects; the input is left untouched. Its in-place predecessor, `decode_file_blocks(messages)`, is deprecated.
50
+
51
+ #### `decode_interrupt_responses(responses)`
52
+
53
+ Turns Welt's resume payload — a mapping of interrupt id to the answer a human chose — into the `interruptResponse` items that `Agent.stream_async` resumes from.
54
+
55
+ ### Outbound
56
+
57
+ #### `renderable_events(events)`
58
+
59
+ Reduces raw `stream_async` events — not JSON-serializable as-is — to the events Welt renders:
60
+
61
+ | Strands emits | On the wire | In the Slack thread |
62
+ |---|---|---|
63
+ | Text deltas | `data` | The streamed reply |
64
+ | Tool invocations and results | `current_tool_use` / `tool_result` | "Using tool" indicators (tool output stays off the wire) |
65
+ | Image / document / video blocks a tool or the model produces | `file` | An uploaded file ([size limits](https://github.com/iwamot/welt/blob/main/docs/wire.md#limits)) |
66
+ | Pending [interrupts](https://strandsagents.com/docs/user-guide/concepts/interrupts/) | `interrupt` | Buttons and/or a text field |
67
+
68
+ 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.
69
+
70
+ #### `file_event(name, data)`
71
+
72
+ Builds the same `file` event from a filename and raw bytes, for attaching arbitrary files of your own:
73
+
74
+ ```python
75
+ yield file_event("report.csv", csv_bytes)
76
+ ```
77
+
78
+ Tool-generated files need no code at all — for example, strands-tools' [`generate_image`](https://github.com/strands-agents/tools/blob/main/src/strands_tools/generate_image.py) returns the image as a tool-result block, which streams into the thread by itself. The [example agent](examples/agent) includes it.
79
+
80
+ #### `interrupt_reason(message, options=..., input=...)`
81
+
82
+ 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:
83
+
84
+ ```python
85
+ answer = tool_context.interrupt(
86
+ "deploy-approval",
87
+ reason=interrupt_reason(
88
+ "Deploy to prod?",
89
+ [
90
+ {"value": "y", "label": "Deploy", "style": "primary"},
91
+ {"value": "n", "label": "Cancel"},
92
+ ],
93
+ input={"label": "Or tell me what to do instead"},
94
+ ),
95
+ )
96
+ ```
97
+
98
+ ## Working with interrupts
99
+
100
+ [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 Strands side:
101
+
102
+ - **Prefix your interrupt names** (`myapp-deploy-approval`). Hook-raised interrupts must be unique across the whole event, tool-raised ones within their tool — a prefix keeps both as the agent grows.
103
+ - **Strands' ready-made [`HumanInTheLoop`](https://strandsagents.com/docs/user-guide/concepts/agents/interventions/human-in-the-loop/) intervention works over Welt as-is.** Its string reasons render with Welt's default **Approve** / **Deny** buttons, whose `y` / `n` values its default evaluator understands. Do not pass `ask`: stdio prompts and callback evaluators have no terminal on AgentCore Runtime.
104
+ - **Route stdio consent prompts through interrupts instead.** For strands-tools packages that gate themselves behind a stdio prompt, set `BYPASS_TOOL_CONSENT=true` and let `HumanInTheLoop` do the gating over Slack. The strands-tools `handoff_to_user` tool is likewise stdio-bound; a small interrupt-raising tool of your own is the replacement.
105
+
106
+ ## Supported Versions
107
+
108
+ Welt releases first; welt-io-strands follows, mirroring the minor version. While both are 0.x, a welt-io-strands 0.Y release supports Welt v0.Y — other combinations may work, but come with no guarantee.
109
+
110
+ ## License
111
+
112
+ MIT
@@ -0,0 +1,89 @@
1
+ # welt-io-strands
2
+
3
+ [![pypi](https://img.shields.io/pypi/v/welt-io-strands.svg)](https://pypi.org/project/welt-io-strands/)
4
+ [![python](https://img.shields.io/pypi/pyversions/welt-io-strands.svg)](https://pypi.org/project/welt-io-strands/)
5
+
6
+ The [Strands Agents](https://strandsagents.com/) (Python) adapter for [Welt](https://github.com/iwamot/welt)'s wire contract — one of Welt's [agent-side adapters](https://github.com/iwamot/welt#agent-side-adapters).
7
+
8
+ ## Install
9
+
10
+ ```bash
11
+ uv add welt-io-strands
12
+ ```
13
+
14
+ ## Usage
15
+
16
+ See [`examples/agent`](examples/agent) — the smallest complete agent built on this package (text streaming, image generation, file input, and a human-approval tool), which doubles as the example for [Welt's Quick Start](https://github.com/iwamot/welt#quick-start). The sections below explain the adapters it wires in.
17
+
18
+ ## API
19
+
20
+ 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 Strands values do not fit it in either direction. Two functions adapt the inbound payload, three the outbound stream.
21
+
22
+ ### Inbound
23
+
24
+ #### `decode_messages(messages)`
25
+
26
+ Returns a copy of Welt's Converse-shaped messages with the base64-encoded file bytes restored to the raw bytes Strands expects; the input is left untouched. Its in-place predecessor, `decode_file_blocks(messages)`, is deprecated.
27
+
28
+ #### `decode_interrupt_responses(responses)`
29
+
30
+ Turns Welt's resume payload — a mapping of interrupt id to the answer a human chose — into the `interruptResponse` items that `Agent.stream_async` resumes from.
31
+
32
+ ### Outbound
33
+
34
+ #### `renderable_events(events)`
35
+
36
+ Reduces raw `stream_async` events — not JSON-serializable as-is — to the events Welt renders:
37
+
38
+ | Strands emits | On the wire | In the Slack thread |
39
+ |---|---|---|
40
+ | Text deltas | `data` | The streamed reply |
41
+ | Tool invocations and results | `current_tool_use` / `tool_result` | "Using tool" indicators (tool output stays off the wire) |
42
+ | Image / document / video blocks a tool or the model produces | `file` | An uploaded file ([size limits](https://github.com/iwamot/welt/blob/main/docs/wire.md#limits)) |
43
+ | Pending [interrupts](https://strandsagents.com/docs/user-guide/concepts/interrupts/) | `interrupt` | Buttons and/or a text field |
44
+
45
+ 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.
46
+
47
+ #### `file_event(name, data)`
48
+
49
+ Builds the same `file` event from a filename and raw bytes, for attaching arbitrary files of your own:
50
+
51
+ ```python
52
+ yield file_event("report.csv", csv_bytes)
53
+ ```
54
+
55
+ Tool-generated files need no code at all — for example, strands-tools' [`generate_image`](https://github.com/strands-agents/tools/blob/main/src/strands_tools/generate_image.py) returns the image as a tool-result block, which streams into the thread by itself. The [example agent](examples/agent) includes it.
56
+
57
+ #### `interrupt_reason(message, options=..., input=...)`
58
+
59
+ 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:
60
+
61
+ ```python
62
+ answer = tool_context.interrupt(
63
+ "deploy-approval",
64
+ reason=interrupt_reason(
65
+ "Deploy to prod?",
66
+ [
67
+ {"value": "y", "label": "Deploy", "style": "primary"},
68
+ {"value": "n", "label": "Cancel"},
69
+ ],
70
+ input={"label": "Or tell me what to do instead"},
71
+ ),
72
+ )
73
+ ```
74
+
75
+ ## Working with interrupts
76
+
77
+ [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 Strands side:
78
+
79
+ - **Prefix your interrupt names** (`myapp-deploy-approval`). Hook-raised interrupts must be unique across the whole event, tool-raised ones within their tool — a prefix keeps both as the agent grows.
80
+ - **Strands' ready-made [`HumanInTheLoop`](https://strandsagents.com/docs/user-guide/concepts/agents/interventions/human-in-the-loop/) intervention works over Welt as-is.** Its string reasons render with Welt's default **Approve** / **Deny** buttons, whose `y` / `n` values its default evaluator understands. Do not pass `ask`: stdio prompts and callback evaluators have no terminal on AgentCore Runtime.
81
+ - **Route stdio consent prompts through interrupts instead.** For strands-tools packages that gate themselves behind a stdio prompt, set `BYPASS_TOOL_CONSENT=true` and let `HumanInTheLoop` do the gating over Slack. The strands-tools `handoff_to_user` tool is likewise stdio-bound; a small interrupt-raising tool of your own is the replacement.
82
+
83
+ ## Supported Versions
84
+
85
+ Welt releases first; welt-io-strands follows, mirroring the minor version. While both are 0.x, a welt-io-strands 0.Y release supports Welt v0.Y — other combinations may work, but come with no guarantee.
86
+
87
+ ## License
88
+
89
+ MIT
@@ -0,0 +1,9 @@
1
+ # Security Policy
2
+
3
+ ## Disclaimer
4
+
5
+ This software is provided "as is" without warranty. Security issues will be addressed on a best-effort basis.
6
+
7
+ ## Reporting a Vulnerability
8
+
9
+ Please report security vulnerabilities through GitHub's Security Advisory "Report a Vulnerability" feature.
@@ -0,0 +1,178 @@
1
+ # @generated - this file is auto-generated by `mise lock` https://mise.jdx.dev/dev-tools/mise-lock.html
2
+
3
+ [[tools."aqua:astral-sh/ruff"]]
4
+ version = "0.15.22"
5
+ backend = "aqua:astral-sh/ruff"
6
+
7
+ [tools."aqua:astral-sh/ruff"."platforms.linux-arm64"]
8
+ checksum = "sha256:88feb2dc2fafb92482185201f4d483134fbaab10370c79512d3dd372f1d3f28b"
9
+ url = "https://github.com/astral-sh/ruff/releases/download/0.15.22/ruff-aarch64-unknown-linux-musl.tar.gz"
10
+ url_api = "https://api.github.com/repos/astral-sh/ruff/releases/assets/479313917"
11
+ provenance = "github-attestations"
12
+
13
+ [tools."aqua:astral-sh/ruff"."platforms.linux-arm64-musl"]
14
+ checksum = "sha256:88feb2dc2fafb92482185201f4d483134fbaab10370c79512d3dd372f1d3f28b"
15
+ url = "https://github.com/astral-sh/ruff/releases/download/0.15.22/ruff-aarch64-unknown-linux-musl.tar.gz"
16
+ url_api = "https://api.github.com/repos/astral-sh/ruff/releases/assets/479313917"
17
+ provenance = "github-attestations"
18
+
19
+ [tools."aqua:astral-sh/ruff"."platforms.linux-x64"]
20
+ checksum = "sha256:853462df618fb9f156a9f04d9d899d9e5a9e1a43fbffaec72df4bb159348e71b"
21
+ url = "https://github.com/astral-sh/ruff/releases/download/0.15.22/ruff-x86_64-unknown-linux-musl.tar.gz"
22
+ url_api = "https://api.github.com/repos/astral-sh/ruff/releases/assets/479314045"
23
+ provenance = "github-attestations"
24
+
25
+ [tools."aqua:astral-sh/ruff"."platforms.linux-x64-musl"]
26
+ checksum = "sha256:853462df618fb9f156a9f04d9d899d9e5a9e1a43fbffaec72df4bb159348e71b"
27
+ url = "https://github.com/astral-sh/ruff/releases/download/0.15.22/ruff-x86_64-unknown-linux-musl.tar.gz"
28
+ url_api = "https://api.github.com/repos/astral-sh/ruff/releases/assets/479314045"
29
+ provenance = "github-attestations"
30
+
31
+ [tools."aqua:astral-sh/ruff"."platforms.macos-arm64"]
32
+ checksum = "sha256:a2881af26fd1d19f4932c4ddf1e70b4e0efcf48513c5dae082564e03f0b467a3"
33
+ url = "https://github.com/astral-sh/ruff/releases/download/0.15.22/ruff-aarch64-apple-darwin.tar.gz"
34
+ url_api = "https://api.github.com/repos/astral-sh/ruff/releases/assets/479313898"
35
+ provenance = "github-attestations"
36
+
37
+ [tools."aqua:astral-sh/ruff"."platforms.macos-x64"]
38
+ checksum = "sha256:687a9ceb88ab85dab061026d5017218225a481121b1a40862cc8f92b56f18090"
39
+ url = "https://github.com/astral-sh/ruff/releases/download/0.15.22/ruff-x86_64-apple-darwin.tar.gz"
40
+ url_api = "https://api.github.com/repos/astral-sh/ruff/releases/assets/479314007"
41
+ provenance = "github-attestations"
42
+
43
+ [tools."aqua:astral-sh/ruff"."platforms.windows-x64"]
44
+ checksum = "sha256:6e5419593984941405e9add902e89c6ea4af87d97919ac5ef82e1bc4e43bbd8d"
45
+ url = "https://github.com/astral-sh/ruff/releases/download/0.15.22/ruff-x86_64-pc-windows-msvc.zip"
46
+ url_api = "https://api.github.com/repos/astral-sh/ruff/releases/assets/479314019"
47
+ provenance = "github-attestations"
48
+
49
+ [[tools."aqua:astral-sh/ty"]]
50
+ version = "0.0.61"
51
+ backend = "aqua:astral-sh/ty"
52
+
53
+ [tools."aqua:astral-sh/ty"."platforms.linux-arm64"]
54
+ checksum = "sha256:a273d6afabdf815251f6d5fc57821c9576c1f627654602b8986e990cf6f79fe0"
55
+ url = "https://github.com/astral-sh/ty/releases/download/0.0.61/ty-aarch64-unknown-linux-musl.tar.gz"
56
+ url_api = "https://api.github.com/repos/astral-sh/ty/releases/assets/481013990"
57
+ provenance = "github-attestations"
58
+
59
+ [tools."aqua:astral-sh/ty"."platforms.linux-arm64-musl"]
60
+ checksum = "sha256:a273d6afabdf815251f6d5fc57821c9576c1f627654602b8986e990cf6f79fe0"
61
+ url = "https://github.com/astral-sh/ty/releases/download/0.0.61/ty-aarch64-unknown-linux-musl.tar.gz"
62
+ url_api = "https://api.github.com/repos/astral-sh/ty/releases/assets/481013990"
63
+ provenance = "github-attestations"
64
+
65
+ [tools."aqua:astral-sh/ty"."platforms.linux-x64"]
66
+ checksum = "sha256:99fa3eb57e633256ed849cabb97fe6b2166a343bedadcf9f9c6c13479b220ac1"
67
+ url = "https://github.com/astral-sh/ty/releases/download/0.0.61/ty-x86_64-unknown-linux-musl.tar.gz"
68
+ url_api = "https://api.github.com/repos/astral-sh/ty/releases/assets/481014060"
69
+ provenance = "github-attestations"
70
+
71
+ [tools."aqua:astral-sh/ty"."platforms.linux-x64-musl"]
72
+ checksum = "sha256:99fa3eb57e633256ed849cabb97fe6b2166a343bedadcf9f9c6c13479b220ac1"
73
+ url = "https://github.com/astral-sh/ty/releases/download/0.0.61/ty-x86_64-unknown-linux-musl.tar.gz"
74
+ url_api = "https://api.github.com/repos/astral-sh/ty/releases/assets/481014060"
75
+ provenance = "github-attestations"
76
+
77
+ [tools."aqua:astral-sh/ty"."platforms.macos-arm64"]
78
+ checksum = "sha256:3b80f713c76584ae0fb386236752ca130507b381581fd03f874c0077c219b8e9"
79
+ url = "https://github.com/astral-sh/ty/releases/download/0.0.61/ty-aarch64-apple-darwin.tar.gz"
80
+ url_api = "https://api.github.com/repos/astral-sh/ty/releases/assets/481013968"
81
+ provenance = "github-attestations"
82
+
83
+ [tools."aqua:astral-sh/ty"."platforms.macos-x64"]
84
+ checksum = "sha256:acce284df5716a9843e0c39ebf5b8a3440dc44aea76bee476c84e18a90f78ec5"
85
+ url = "https://github.com/astral-sh/ty/releases/download/0.0.61/ty-x86_64-apple-darwin.tar.gz"
86
+ url_api = "https://api.github.com/repos/astral-sh/ty/releases/assets/481014042"
87
+ provenance = "github-attestations"
88
+
89
+ [tools."aqua:astral-sh/ty"."platforms.windows-x64"]
90
+ checksum = "sha256:07b95c84b1c4c49a359d3c921e58b179f83894abbc891ed402eda6e9135f5ddf"
91
+ url = "https://github.com/astral-sh/ty/releases/download/0.0.61/ty-x86_64-pc-windows-msvc.zip"
92
+ url_api = "https://api.github.com/repos/astral-sh/ty/releases/assets/481014044"
93
+ provenance = "github-attestations"
94
+
95
+ [[tools."aqua:astral-sh/uv"]]
96
+ version = "0.11.29"
97
+ backend = "aqua:astral-sh/uv"
98
+
99
+ [tools."aqua:astral-sh/uv"."platforms.linux-arm64"]
100
+ checksum = "sha256:593d79a797ece3f1dfaaf3e0a973263422a135d9262c7dbc6cd75d9c11acc0b4"
101
+ url = "https://github.com/astral-sh/uv/releases/download/0.11.29/uv-aarch64-unknown-linux-musl.tar.gz"
102
+ url_api = "https://api.github.com/repos/astral-sh/uv/releases/assets/478261262"
103
+ provenance = "github-attestations"
104
+
105
+ [tools."aqua:astral-sh/uv"."platforms.linux-arm64-musl"]
106
+ checksum = "sha256:593d79a797ece3f1dfaaf3e0a973263422a135d9262c7dbc6cd75d9c11acc0b4"
107
+ url = "https://github.com/astral-sh/uv/releases/download/0.11.29/uv-aarch64-unknown-linux-musl.tar.gz"
108
+ url_api = "https://api.github.com/repos/astral-sh/uv/releases/assets/478261262"
109
+ provenance = "github-attestations"
110
+
111
+ [tools."aqua:astral-sh/uv"."platforms.linux-x64"]
112
+ checksum = "sha256:46711858adb2a3acaa9cee00f9060688ad1fd5706aecc005b96a6a7f285a00b7"
113
+ url = "https://github.com/astral-sh/uv/releases/download/0.11.29/uv-x86_64-unknown-linux-musl.tar.gz"
114
+ url_api = "https://api.github.com/repos/astral-sh/uv/releases/assets/478261352"
115
+ provenance = "github-attestations"
116
+
117
+ [tools."aqua:astral-sh/uv"."platforms.linux-x64-musl"]
118
+ checksum = "sha256:46711858adb2a3acaa9cee00f9060688ad1fd5706aecc005b96a6a7f285a00b7"
119
+ url = "https://github.com/astral-sh/uv/releases/download/0.11.29/uv-x86_64-unknown-linux-musl.tar.gz"
120
+ url_api = "https://api.github.com/repos/astral-sh/uv/releases/assets/478261352"
121
+ provenance = "github-attestations"
122
+
123
+ [tools."aqua:astral-sh/uv"."platforms.macos-arm64"]
124
+ checksum = "sha256:61c04acc52a33ef0f331e494bdfbedcdb6c26c6970c022ed3699e5860f8930e3"
125
+ url = "https://github.com/astral-sh/uv/releases/download/0.11.29/uv-aarch64-apple-darwin.tar.gz"
126
+ url_api = "https://api.github.com/repos/astral-sh/uv/releases/assets/478261245"
127
+ provenance = "github-attestations"
128
+
129
+ [tools."aqua:astral-sh/uv"."platforms.macos-x64"]
130
+ checksum = "sha256:c4c4de482da9ccdd076dc4fb5cfe7b740609029385c72f58606be3153602387d"
131
+ url = "https://github.com/astral-sh/uv/releases/download/0.11.29/uv-x86_64-apple-darwin.tar.gz"
132
+ url_api = "https://api.github.com/repos/astral-sh/uv/releases/assets/478261331"
133
+ provenance = "github-attestations"
134
+
135
+ [tools."aqua:astral-sh/uv"."platforms.windows-x64"]
136
+ checksum = "sha256:a047d55651bc3e0ca24595b25ec4cfcb10f9dca9fb56514e661269b37d4fae68"
137
+ url = "https://github.com/astral-sh/uv/releases/download/0.11.29/uv-x86_64-pc-windows-msvc.zip"
138
+ url_api = "https://api.github.com/repos/astral-sh/uv/releases/assets/478261333"
139
+ provenance = "github-attestations"
140
+
141
+ [[tools.python]]
142
+ version = "3.14.6"
143
+ backend = "core:python"
144
+
145
+ [tools.python."platforms.linux-arm64"]
146
+ checksum = "sha256:f177d40ca931df03f660fc006f86ad8cd2ac6e7d6b5d54edbc625103464fc4aa"
147
+ url = "https://github.com/astral-sh/python-build-standalone/releases/download/20260623/cpython-3.14.6+20260623-aarch64-unknown-linux-gnu-install_only_stripped.tar.gz"
148
+ provenance = "github-attestations"
149
+
150
+ [tools.python."platforms.linux-arm64-musl"]
151
+ checksum = "sha256:11d463be3e2d34ea67722acfd8f3f2d6d6e5b6b4d4ab27240f220628134a0141"
152
+ url = "https://github.com/astral-sh/python-build-standalone/releases/download/20260623/cpython-3.14.6+20260623-aarch64-unknown-linux-musl-install_only_stripped.tar.gz"
153
+ provenance = "github-attestations"
154
+
155
+ [tools.python."platforms.linux-x64"]
156
+ checksum = "sha256:c172314f4a8ec137a8f605289010c3d19c8b56867d968f0095074cc68efa1d29"
157
+ url = "https://github.com/astral-sh/python-build-standalone/releases/download/20260623/cpython-3.14.6+20260623-x86_64-unknown-linux-gnu-install_only_stripped.tar.gz"
158
+ provenance = "github-attestations"
159
+
160
+ [tools.python."platforms.linux-x64-musl"]
161
+ checksum = "sha256:f25064ecb3b07cfe2440b178e72001cf1e0d69a5e53625ca3a32b7ae4e2fdcc6"
162
+ url = "https://github.com/astral-sh/python-build-standalone/releases/download/20260623/cpython-3.14.6+20260623-x86_64-unknown-linux-musl-install_only_stripped.tar.gz"
163
+ provenance = "github-attestations"
164
+
165
+ [tools.python."platforms.macos-arm64"]
166
+ checksum = "sha256:35d774f61d63c1fd4f1bc9495a7ada92e500dc4382a0df8a9910eb87ea48e8cf"
167
+ url = "https://github.com/astral-sh/python-build-standalone/releases/download/20260623/cpython-3.14.6+20260623-aarch64-apple-darwin-install_only_stripped.tar.gz"
168
+ provenance = "github-attestations"
169
+
170
+ [tools.python."platforms.macos-x64"]
171
+ checksum = "sha256:12fb3ea3d6a855fe6ca1c2241702b06cb7e5939fbef09a5f54bf326e480f66af"
172
+ url = "https://github.com/astral-sh/python-build-standalone/releases/download/20260623/cpython-3.14.6+20260623-x86_64-apple-darwin-install_only_stripped.tar.gz"
173
+ provenance = "github-attestations"
174
+
175
+ [tools.python."platforms.windows-x64"]
176
+ checksum = "sha256:ec05b628ad749682d06d225780fbc02e7bbb5ce2146c9bd8e74a3659b14b693a"
177
+ url = "https://github.com/astral-sh/python-build-standalone/releases/download/20260623/cpython-3.14.6+20260623-x86_64-pc-windows-msvc-install_only_stripped.tar.gz"
178
+ provenance = "github-attestations"
@@ -0,0 +1,112 @@
1
+ [project]
2
+ name = "welt-io-strands"
3
+ dynamic = ["version"]
4
+ description = "The Strands Agents (Python) adapter for Welt's wire contract"
5
+ readme = "README.md"
6
+ # Floor matches the AgentCore CLI's generated agent projects (requires-python
7
+ # >= 3.10), so `uv add welt-io-strands` resolves there without edits.
8
+ requires-python = ">=3.10"
9
+ license = "MIT"
10
+ authors = [{ name = "Takashi Iwamoto" }]
11
+ keywords = ["welt", "slack", "agentcore", "bedrock", "strands"]
12
+ classifiers = [
13
+ "Development Status :: 3 - Alpha",
14
+ "Intended Audience :: Developers",
15
+ "Programming Language :: Python :: 3",
16
+ "Programming Language :: Python :: 3.10",
17
+ "Programming Language :: Python :: 3.11",
18
+ "Programming Language :: Python :: 3.12",
19
+ "Programming Language :: Python :: 3.13",
20
+ "Programming Language :: Python :: 3.14",
21
+ "Topic :: Software Development",
22
+ "Typing :: Typed",
23
+ ]
24
+ dependencies = []
25
+
26
+ [project.urls]
27
+ Repository = "https://github.com/iwamot/welt-io-strands"
28
+ Issues = "https://github.com/iwamot/welt-io-strands/issues"
29
+
30
+ # The dev group is included by `uv sync` and `uv run` by default, and —
31
+ # unlike a dev extra — is not published in the wheel metadata.
32
+ [dependency-groups]
33
+ dev = [
34
+ # examples/agent is a standalone deployable; its dependencies are
35
+ # installed here so lint and type checks cover it against the local
36
+ # library.
37
+ "bedrock-agentcore==1.18.1",
38
+ "pip-licenses==5.5.5",
39
+ "pytest==9.1.1",
40
+ "pytest-cov==7.1.0",
41
+ "strands-agents==1.48.0",
42
+ "strands-agents-tools==0.8.4",
43
+ ]
44
+
45
+ [build-system]
46
+ requires = ["hatchling", "hatch-vcs"]
47
+ build-backend = "hatchling.build"
48
+
49
+ [tool.hatch.version]
50
+ source = "vcs"
51
+
52
+ [tool.hatch.build.hooks.vcs]
53
+ version-file = "src/welt_io_strands/_version.py"
54
+
55
+ [tool.hatch.build.targets.wheel]
56
+ packages = ["src/welt_io_strands"]
57
+
58
+ [tool.hatch.build.targets.sdist]
59
+ exclude = [
60
+ "/.codecov.yml",
61
+ "/.github",
62
+ "/compatibility.sh",
63
+ "/examples",
64
+ "/mise.toml",
65
+ "/uv.lock",
66
+ "/validate.sh",
67
+ ]
68
+
69
+ [tool.uv]
70
+ exclude-newer = "1 day"
71
+
72
+ [tool.ruff]
73
+ include = ["*.py", "examples/**/*.py", "src/**/*.py", "tests/**/*.py"]
74
+
75
+ [tool.ruff.lint]
76
+ # Reference: https://pydevtools.com/handbook/how-to/how-to-configure-recommended-ruff-defaults/
77
+ extend-select = [
78
+ "F", # Pyflakes rules
79
+ "W", # PyCodeStyle warnings
80
+ # "E", # PyCodeStyle errors
81
+ "I", # Sort imports properly
82
+ "UP", # Warn if certain things can changed due to newer Python versions
83
+ "C4", # Catch incorrect use of comprehensions, dict, list, etc
84
+ "FA", # Enforce from __future__ import annotations
85
+ "ISC", # Good use of string concatenation
86
+ "ICN", # Use common import conventions
87
+ "RET", # Good return practices
88
+ # "SIM", # Common simplification rules
89
+ "TID", # Some good import practices
90
+ # "TC", # Enforce importing certain types in a TYPE_CHECKING block
91
+ "PTH", # Use pathlib instead of os.path
92
+ "TD", # Be diligent with TODO comments
93
+ # "NPY", # Some numpy-specific things
94
+ # Not in the reference URL
95
+ "S", # flake8-bandit (security)
96
+ ]
97
+ ignore = [
98
+ "S101", # Allow assert in tests (pytest standard practice)
99
+ ]
100
+
101
+ [tool.ty.src]
102
+ include = ["examples", "src", "tests"]
103
+
104
+ [tool.pytest.ini_options]
105
+ testpaths = ["tests"]
106
+
107
+ [tool.coverage.run]
108
+ source = ["welt_io_strands"]
109
+ branch = true
110
+
111
+ [tool.coverage.report]
112
+ show_missing = true