agento11y-strands 0.10.0__tar.gz

agento11y_strands-0.10.0/LICENSE

@@ -0,0 +1,3 @@
+SPDX-License-Identifier: Apache-2.0
+
+See /LICENSE at repository root for full license text.

agento11y_strands-0.10.0/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: agento11y-strands
+Version: 0.10.0
+Summary: Strands Agents hooks for the Grafana Agent Observability Python SDK
+License: SPDX-License-Identifier: Apache-2.0
+        
+        See /LICENSE at repository root for full license text.
+        
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: agento11y>=0.10.0
+Requires-Dist: strands-agents>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=9.0.3; extra == "dev"
+Dynamic: license-file
+
+# Sigil Python Framework Module: Strands Agents
+
+`agento11y-strands` provides a Strands `HookProvider` bridge that maps agent, model, and tool lifecycle events into Sigil generation and tool recording.
+
+## Installation
+
+```bash
+pip install agento11y agento11y-strands
+pip install strands-agents
+```
+
+## Quickstart
+
+```python
+from agento11y import Client
+from agento11y_strands import with_agento11y_strands_hooks
+from strands import Agent
+
+client = Client()
+agent_config = with_agento11y_strands_hooks(
+    {"name": "support-agent"},
+    client=client,
+    provider_resolver="auto",
+)
+
+agent = Agent(**agent_config)
+agent(
+    "Explain what LLM observability is in one sentence.",
+    invocation_state={"conversation_id": "demo-strands"},
+)
+
+client.shutdown()
+```
+
+## Existing Agents
+
+```python
+from agento11y import Client
+from agento11y_strands import with_agento11y_strands_hooks
+
+client = Client()
+with_agento11y_strands_hooks(agent, client=client, provider_resolver="auto")
+```
+
+## Conversation Mapping
+
+Conversation ID precedence:
+
+1. `conversation_id` / `session_id` / `group_id` from Strands `invocation_state`
+2. `thread_id` from Strands `invocation_state`
+3. deterministic fallback `agento11y:framework:strands:<run_id>`
+
+Pass a stable value per user conversation:
+
+```python
+agent("Remember my timezone is UTC+1.", invocation_state={"conversation_id": "customer-42"})
+agent("What timezone did I give you?", invocation_state={"conversation_id": "customer-42"})
+```
+
+## Metadata and Lineage
+
+Required framework tags:
+
+- `agento11y.framework.name=strands`
+- `agento11y.framework.source=hooks`
+- `agento11y.framework.language=python`
+
+Metadata includes:
+
+- required: `agento11y.framework.run_type`
+- optional: `agento11y.framework.run_id`, `agento11y.framework.thread_id`, `agento11y.framework.parent_run_id`, `agento11y.framework.component_name`, `agento11y.framework.event_id`
+
+## Provider Resolver
+
+Resolver order: explicit provider option -> Strands model config metadata -> model prefix inference -> `custom`.
+
+For Bedrock model IDs that do not infer cleanly, pass `provider="anthropic"` or another provider value when creating the hook provider.
+
+## Troubleshooting
+
+- If conversations are fragmented, pass stable `conversation_id` or `session_id` in `invocation_state`.
+- If provider is inferred as `custom`, set `provider="openai"` / `provider="anthropic"` / `provider="gemini"` on hook creation.
+- Always call `client.shutdown()` during teardown.

agento11y_strands-0.10.0/README.md

@@ -0,0 +1,83 @@
+# Sigil Python Framework Module: Strands Agents
+
+`agento11y-strands` provides a Strands `HookProvider` bridge that maps agent, model, and tool lifecycle events into Sigil generation and tool recording.
+
+## Installation
+
+```bash
+pip install agento11y agento11y-strands
+pip install strands-agents
+```
+
+## Quickstart
+
+```python
+from agento11y import Client
+from agento11y_strands import with_agento11y_strands_hooks
+from strands import Agent
+
+client = Client()
+agent_config = with_agento11y_strands_hooks(
+    {"name": "support-agent"},
+    client=client,
+    provider_resolver="auto",
+)
+
+agent = Agent(**agent_config)
+agent(
+    "Explain what LLM observability is in one sentence.",
+    invocation_state={"conversation_id": "demo-strands"},
+)
+
+client.shutdown()
+```
+
+## Existing Agents
+
+```python
+from agento11y import Client
+from agento11y_strands import with_agento11y_strands_hooks
+
+client = Client()
+with_agento11y_strands_hooks(agent, client=client, provider_resolver="auto")
+```
+
+## Conversation Mapping
+
+Conversation ID precedence:
+
+1. `conversation_id` / `session_id` / `group_id` from Strands `invocation_state`
+2. `thread_id` from Strands `invocation_state`
+3. deterministic fallback `agento11y:framework:strands:<run_id>`
+
+Pass a stable value per user conversation:
+
+```python
+agent("Remember my timezone is UTC+1.", invocation_state={"conversation_id": "customer-42"})
+agent("What timezone did I give you?", invocation_state={"conversation_id": "customer-42"})
+```
+
+## Metadata and Lineage
+
+Required framework tags:
+
+- `agento11y.framework.name=strands`
+- `agento11y.framework.source=hooks`
+- `agento11y.framework.language=python`
+
+Metadata includes:
+
+- required: `agento11y.framework.run_type`
+- optional: `agento11y.framework.run_id`, `agento11y.framework.thread_id`, `agento11y.framework.parent_run_id`, `agento11y.framework.component_name`, `agento11y.framework.event_id`
+
+## Provider Resolver
+
+Resolver order: explicit provider option -> Strands model config metadata -> model prefix inference -> `custom`.
+
+For Bedrock model IDs that do not infer cleanly, pass `provider="anthropic"` or another provider value when creating the hook provider.
+
+## Troubleshooting
+
+- If conversations are fragmented, pass stable `conversation_id` or `session_id` in `invocation_state`.
+- If provider is inferred as `custom`, set `provider="openai"` / `provider="anthropic"` / `provider="gemini"` on hook creation.
+- Always call `client.shutdown()` during teardown.