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.
- welt_io_strands-0.3.3/.gitignore +10 -0
- welt_io_strands-0.3.3/CONTRIBUTING.md +48 -0
- welt_io_strands-0.3.3/LICENSE +21 -0
- welt_io_strands-0.3.3/PKG-INFO +112 -0
- welt_io_strands-0.3.3/README.md +89 -0
- welt_io_strands-0.3.3/SECURITY.md +9 -0
- welt_io_strands-0.3.3/mise.lock +178 -0
- welt_io_strands-0.3.3/pyproject.toml +112 -0
- welt_io_strands-0.3.3/src/welt_io_strands/__init__.py +459 -0
- welt_io_strands-0.3.3/src/welt_io_strands/_version.py +24 -0
- welt_io_strands-0.3.3/src/welt_io_strands/py.typed +0 -0
- welt_io_strands-0.3.3/tests/test_decode_file_blocks.py +15 -0
- welt_io_strands-0.3.3/tests/test_decode_interrupt_responses.py +25 -0
- welt_io_strands-0.3.3/tests/test_decode_messages.py +102 -0
- welt_io_strands-0.3.3/tests/test_file_event.py +25 -0
- welt_io_strands-0.3.3/tests/test_interrupt_reason.py +158 -0
- welt_io_strands-0.3.3/tests/test_renderable_events.py +375 -0
- welt_io_strands-0.3.3/tests/test_version.py +24 -0
|
@@ -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
|
+
[](https://pypi.org/project/welt-io-strands/)
|
|
27
|
+
[](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
|
+
[](https://pypi.org/project/welt-io-strands/)
|
|
4
|
+
[](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
|