nighthawk-python 0.2.0__tar.gz → 0.3.1__tar.gz

{nighthawk_python-0.2.0 → nighthawk_python-0.3.1}/.claude/rules/docs.md

@@ -91,6 +91,8 @@ Each file has a distinct audience and scope. Content belongs in exactly one file
 - This file should be self-contained: a coding agent reading only this file should be able to write correct Nighthawk code without consulting other docs.
 - This file is consumed standalone (`@docs/for-coding-agents.md` in CLAUDE.md/AGENTS.md, GitHub raw URL, etc.). Do not assume sibling files exist at relative paths.
 - All external references to other docs use absolute URLs based on `site_url` from `mkdocs.yml` (currently `https://kurusugawa-computer.github.io/nighthawk-python/`). If `site_url` changes, update the URLs in this file.
+- `@nh.tool` is deprecated. Do not add examples, recommendations, or references to `@nh.tool` in this file. Binding functions are the only recommended callable exposure mechanism.
+- Filter content for coding-agent relevance. Omit infrastructure-level concerns (scoped overrides parameter lists, exception hierarchy beyond `ExecutionError`, observability/tracing) that do not affect how an agent writes Natural blocks or binding functions. Mention existence and link to Tutorial or Design for details.
 
 ### api.md specifics
 

nighthawk_python-0.3.1/.claude/settings.json

@@ -0,0 +1,5 @@
+{
+  "enabledPlugins": {
+    "pyright-lsp@claude-plugins-official": true
+  }
+}

nighthawk_python-0.3.1/CHANGELOG.md

@@ -0,0 +1,56 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.3.1] - 2026-03-19
+
+### Changed
+- Internal ID generation now uses `ulid.generate_ulid()` (ULID,
+  26-character Crockford Base32, timestamp-sortable) in a dedicated
+  module, replacing the former `generate_id` embedded in
+  `runtime.scoping`.
+
+## [0.3.0] - 2026-03-18
+
+### Added
+- `system_prompt_suffix_fragment_scope` and `user_prompt_suffix_fragment_scope` context managers for lightweight prompt fragment management without full scope overhead.
+- OpenTelemetry tracer now reports `instrumenting_library_version`.
+
+### Changed
+- Simplified OpenTelemetry span hierarchy: removed implicit `nighthawk.scope` spans and `nighthawk.step_executor` spans. `nighthawk.scope` spans are now emitted only for explicit `nh.scope()` calls.
+- `nighthawk.run` span no longer includes `scope.id` attribute; only `run.id` is emitted.
+- Trimmed `for-coding-agents.md` for coding-agent relevance: removed deprecated `@nh.tool` references, condensed exception hierarchy, scoped overrides, and added debugging context to `StepContextLimits`.
+
+## [0.2.0] - 2026-03-16
+
+### Added
+- Added compact step trace support for Natural block execution attempts:
+  - `StepTrace`
+  - `StepTraceError`
+  - `nighthawk.get_step_traces()`
+
+### Changed
+- Updated CI workflow setup (`setup-uv`) in project automation.
+
+### Fixed
+- License badge reference in README.
+- Documentation formatting inconsistencies.
+
+## [0.1.0] - 2026-03-13
+
+### Added
+- Initial public release of `nighthawk-python`.
+- Natural DSL execution runtime with run/scope execution context model.
+- Step executor abstraction and provider integration foundation.
+- Core documentation and project scaffolding.
+
+[Unreleased]: https://github.com/kurusugawa-computer/nighthawk-python/compare/v0.3.1...HEAD
+[0.3.1]: https://github.com/kurusugawa-computer/nighthawk-python/compare/v0.3.0...v0.3.1
+[0.3.0]: https://github.com/kurusugawa-computer/nighthawk-python/compare/v0.2.0...v0.3.0
+[0.2.0]: https://github.com/kurusugawa-computer/nighthawk-python/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/kurusugawa-computer/nighthawk-python/tree/v0.1.0

{nighthawk_python-0.2.0 → nighthawk_python-0.3.1}/CONTRIBUTING.md

@@ -53,6 +53,23 @@ Then run with your `.env` loaded:
 set -a; source .env; set +a; uv run pytest -q
 ```
 
+### Trace inspection with otel-tui
+
+Nighthawk emits OpenTelemetry traces for step execution. You can inspect them
+locally using [otel-tui](https://github.com/ymtdzzz/otel-tui):
+
+```bash
+docker run --rm -it -p 4318:4318 --name otel-tui ymtdzzz/otel-tui:latest
+```
+
+Then run integration tests with the collector endpoint:
+
+```bash
+OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318 uv run pytest -q tests/integration/
+```
+
+Traces appear in the otel-tui terminal UI in real time.
+
 ### Environment variables
 
 - `OPENAI_API_KEY`: Required for OpenAI integration tests (also requires `pydantic-ai-slim[openai]`).
@@ -131,7 +148,7 @@ def run(
 
     Args:
         step_executor: The step executor to use for Natural block execution.
-        run_id: Optional identifier for the run. If not provided, a UUID is
+        run_id: Optional identifier for the run. If not provided, a ULID is
             generated automatically.
 
     Yields:

{nighthawk_python-0.2.0 → nighthawk_python-0.3.1}/PKG-INFO

@@ -1,9 +1,10 @@
 Metadata-Version: 2.4
 Name: nighthawk-python
-Version: 0.2.0
+Version: 0.3.1
 Summary: An experimental Python library that embeds Natural blocks inside Python functions and executes them using an LLM.
 Project-URL: Repository, https://github.com/kurusugawa-computer/nighthawk-python
 Project-URL: Documentation, https://kurusugawa-computer.github.io/nighthawk-python/
+Project-URL: Changelog, https://github.com/kurusugawa-computer/nighthawk-python/blob/main/CHANGELOG.md
 Project-URL: Bug Tracker, https://github.com/kurusugawa-computer/nighthawk-python/issues
 Author-email: "Kurusugawa Computer Inc." <oss@kurusugawa.jp>
 License-Expression: MIT
@@ -26,7 +27,7 @@ Requires-Dist: tiktoken>=0.12
 Provides-Extra: claude-code-cli
 Requires-Dist: mcp>=1.26; extra == 'claude-code-cli'
 Provides-Extra: claude-code-sdk
-Requires-Dist: claude-agent-sdk>=0.1; extra == 'claude-code-sdk'
+Requires-Dist: claude-agent-sdk==0.1.48; extra == 'claude-code-sdk'
 Provides-Extra: codex
 Requires-Dist: mcp>=1.26; extra == 'codex'
 Description-Content-Type: text/markdown

{nighthawk_python-0.2.0 → nighthawk_python-0.3.1}/docs/for-coding-agents.md

@@ -64,10 +64,6 @@ Each Natural block should make exactly one independent judgment. If a block make
 
 Binding functions (local or module-level callables) are the preferred way to expose functions to the LLM. The LLM discovers them from the LOCALS/GLOBALS sections of the prompt, rendered as their signature with the first docstring line as `# intent:`.
 
-### Prefer binding functions over `@nh.tool`
-
-`@nh.tool` is reserved strictly for cases requiring `RunContext[StepContext]` access. Binding functions incur no per-definition token overhead beyond a signature line. Always use binding functions unless `RunContext` access is needed.
-
 ### Keep locals minimal
 
 Module-level names that are stable across invocations (constants, classes, utility functions) should stay in GLOBALS via `<name>` read bindings. Reserve function parameters for data that genuinely varies per call.
@@ -156,11 +152,7 @@ except nh.ExecutionError as e:
     print(f"Validation failed: {e}")
 ```
 
-Custom exception types referenced in step locals or globals are available as raise targets.
-
-### Exception hierarchy
-
-All exceptions inherit from `NighthawkError`: `ExecutionError`, `NaturalParseError`, `ToolEvaluationError`, `ToolValidationError`, `ToolRegistrationError`.
+Custom exception types referenced in step locals or globals are available as raise targets. Catch `nh.ExecutionError` for Natural block failures; all Nighthawk exceptions inherit from `nh.NighthawkError`.
 
 ## 6. Cross-block composition
 
@@ -221,30 +213,9 @@ with nh.run(step_executor):
     result = my_natural_function(data)
 ```
 
-### Scoped overrides
-
-Use `nh.scope()` to override execution settings within an existing run. Each scope generates a new `scope_id` while keeping the current `run_id`.
-
-Parameters:
-
-- `step_executor_configuration`: replace the entire configuration.
-- `step_executor_configuration_patch`: partially override specific fields.
-- `step_executor`: replace the step executor entirely.
-- `system_prompt_suffix_fragment`: append text to the system prompt for the scope.
-- `user_prompt_suffix_fragment`: append text to the user prompt for the scope.
-
-```python
-with nh.scope(
-    step_executor_configuration_patch=nh.StepExecutorConfigurationPatch(
-        model="openai-responses:gpt-5-mini",
-    ),
-):
-    expensive_analysis(data)
-```
-
-### Context limits
+Use `nh.scope()` to override model, prompts, or context limits within an existing run. For details, see [Tutorial](https://kurusugawa-computer.github.io/nighthawk-python/tutorial/).
 
-LOCALS and GLOBALS sections are bounded by `StepContextLimits`. Configure via `StepExecutorConfiguration`:
+LOCALS and GLOBALS sections are bounded by `StepContextLimits`. When bindings are missing or truncated (`<snipped>`), adjust the limits:
 
 ```python
 configuration = nh.StepExecutorConfiguration(
@@ -304,7 +275,6 @@ def judge_review(review_data: str | nh.JsonableValue) -> ReviewVerdict:
 | Use `<:carry>` (write binding) for mutable context | Rebinding breaks the caller's reference | Use `<carry>` (read binding); mutate in-place |
 | Put two independent judgments in one block | Non-deterministic, hard to test, unclear contract | Split into two blocks connected by Python |
 | Use Natural for deterministic computation | Wastes latency/cost, adds non-determinism | Use Python |
-| Use `@nh.tool` when a binding function suffices | Unnecessary per-definition token overhead | Use binding functions; reserve `@nh.tool` for `RunContext[StepContext]` access |
 | Forget type annotations on write bindings | No validation or coercion at commit time | Always annotate `<:name>` bindings |
 | Duplicate module-level constants as function parameters | Moves stable values from GLOBALS to LOCALS, wastes tokens | Reference via `<name>` read binding |
 

{nighthawk_python-0.2.0 → nighthawk_python-0.3.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nighthawk-python"
-version = "0.2.0"
+version = "0.3.1"
 description = "An experimental Python library that embeds Natural blocks inside Python functions and executes them using an LLM."
 readme = "README.md"
 requires-python = ">=3.13"
@@ -32,11 +32,12 @@ dependencies = [
 [project.urls]
 Repository = "https://github.com/kurusugawa-computer/nighthawk-python"
 Documentation = "https://kurusugawa-computer.github.io/nighthawk-python/"
+Changelog = "https://github.com/kurusugawa-computer/nighthawk-python/blob/main/CHANGELOG.md"
 "Bug Tracker" = "https://github.com/kurusugawa-computer/nighthawk-python/issues"
 
 [project.optional-dependencies]
 claude-code-sdk = [
-  "claude-agent-sdk>=0.1",
+  "claude-agent-sdk==0.1.48",
 ]
 claude-code-cli = [
   "mcp>=1.26",

{nighthawk_python-0.2.0 → nighthawk_python-0.3.1}/src/nighthawk/runtime/scoping.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-import uuid
+import importlib.metadata
 from collections.abc import Iterator
 from contextlib import contextmanager
 from contextvars import ContextVar
@@ -12,6 +12,7 @@ from opentelemetry.trace import Span, get_tracer_provider
 from ..configuration import StepExecutorConfiguration, StepExecutorConfigurationPatch
 from ..errors import NighthawkError
 from ..tools.registry import tool_scope
+from ..ulid import generate_ulid
 
 if TYPE_CHECKING:
     from .step_executor import AgentStepExecutor, StepExecutor
@@ -36,7 +37,9 @@ STEP_ID = "step.id"
 TOOL_CALL_ID = "tool_call.id"
 
 
-_tracer = get_tracer_provider().get_tracer("nighthawk")
+_LIBRARY_VERSION = importlib.metadata.version("nighthawk-python")
+
+_tracer = get_tracer_provider().get_tracer("nighthawk", _LIBRARY_VERSION)
 
 
 @contextmanager
@@ -50,10 +53,6 @@ def span(span_name: str, /, **attributes: Any) -> Iterator[Span]:
         yield current_span
 
 
-def _generate_id() -> str:
-    return uuid.uuid4().hex
-
-
 _step_executor_var: ContextVar[StepExecutor | None] = ContextVar(
     "nighthawk_step_executor",
     default=None,
@@ -108,6 +107,26 @@ def get_user_prompt_suffix_fragments() -> tuple[str, ...]:
     return _user_prompt_suffix_fragments_var.get()
 
 
+@contextmanager
+def system_prompt_suffix_fragment_scope(fragment: str) -> Iterator[None]:
+    current = _system_prompt_suffix_fragments_var.get()
+    token = _system_prompt_suffix_fragments_var.set((*current, fragment))
+    try:
+        yield
+    finally:
+        _system_prompt_suffix_fragments_var.reset(token)
+
+
+@contextmanager
+def user_prompt_suffix_fragment_scope(fragment: str) -> Iterator[None]:
+    current = _user_prompt_suffix_fragments_var.get()
+    token = _user_prompt_suffix_fragments_var.set((*current, fragment))
+    try:
+        yield
+    finally:
+        _user_prompt_suffix_fragments_var.reset(token)
+
+
 def _resolve_agent_step_executor(step_executor: StepExecutor) -> AgentStepExecutor:
     from .step_executor import AgentStepExecutor
 
@@ -149,7 +168,7 @@ def run(
 
     Args:
         step_executor: The step executor to use for Natural block execution.
-        run_id: Optional identifier for the run. If not provided, a UUID is
+        run_id: Optional identifier for the run. If not provided, a ULID is
             generated automatically.
 
     Yields:
@@ -165,8 +184,8 @@ def run(
         ```
     """
     execution_context = ExecutionContext(
-        run_id=run_id or _generate_id(),
-        scope_id=_generate_id(),
+        run_id=run_id or generate_ulid(),
+        scope_id=generate_ulid(),
     )
 
     with tool_scope():
@@ -179,7 +198,6 @@ def run(
                 "nighthawk.run",
                 **{
                     RUN_ID: execution_context.run_id,
-                    SCOPE_ID: execution_context.scope_id,
                 },
             ):
                 yield
@@ -260,7 +278,7 @@ def scope(
 
     next_execution_context = replace(
         current_execution_context,
-        scope_id=_generate_id(),
+        scope_id=generate_ulid(),
     )
 
     next_system_fragments = _system_prompt_suffix_fragments_var.get()

{nighthawk_python-0.2.0 → nighthawk_python-0.3.1}/src/nighthawk/runtime/step_executor.py

@@ -13,13 +13,8 @@ from ..tools.registry import get_visible_tools
 from .async_bridge import run_coroutine_synchronously
 from .prompt import build_user_prompt, extract_references_and_program
 from .scoping import (
-    RUN_ID,
-    SCOPE_ID,
-    STEP_ID,
-    get_execution_context,
     get_system_prompt_suffix_fragments,
-    scope,
-    span,
+    system_prompt_suffix_fragment_scope,
 )
 from .step_context import (
     _MISSING,
@@ -315,25 +310,16 @@ class AgentStepExecutor:
             allowed_step_kinds=allowed_step_kinds,
         )
 
-        with scope(system_prompt_suffix_fragment=step_system_prompt_fragment):
-            execution_context = get_execution_context()
-            with (
-                span(
-                    "nighthawk.step_executor",
-                    **{
-                        RUN_ID: execution_context.run_id,
-                        SCOPE_ID: execution_context.scope_id,
-                        STEP_ID: step_context.step_id,
-                    },
-                ),
-                step_context_scope(step_context),
-            ):
-                result = await self._run_agent(
-                    user_prompt=user_prompt,
-                    step_context=step_context,
-                    toolset=toolset,
-                    structured_output_type=structured_output_type,
-                )
+        with (
+            system_prompt_suffix_fragment_scope(step_system_prompt_fragment),
+            step_context_scope(step_context),
+        ):
+            result = await self._run_agent(
+                user_prompt=user_prompt,
+                step_context=step_context,
+                toolset=toolset,
+                structured_output_type=structured_output_type,
+            )
 
         step_outcome = self._parse_agent_result(result)
         bindings = self._extract_bindings(binding_names=binding_names, step_context=step_context)

{nighthawk_python-0.2.0 → nighthawk_python-0.3.1}/src/nighthawk/runtime/tool_calls.py

@@ -1,7 +1,6 @@
 from __future__ import annotations
 
 import json
-import uuid
 from collections.abc import Awaitable, Callable, Iterator
 from contextlib import contextmanager
 from typing import Any
@@ -9,9 +8,11 @@ from typing import Any
 from pydantic_ai import RunContext
 from pydantic_ai._instrumentation import InstrumentationNames
 
+from ..ulid import generate_ulid
+
 
 def generate_tool_call_id() -> str:
-    return str(uuid.uuid4())
+    return generate_ulid()
 
 
 def _resolve_instrumentation_names(*, run_context: RunContext[Any]) -> InstrumentationNames:

nighthawk_python-0.3.1/src/nighthawk/ulid.py

@@ -0,0 +1,18 @@
+from __future__ import annotations
+
+import os
+import time
+
+_CROCKFORD = "0123456789ABCDEFGHJKMNPQRSTVWXYZ"
+
+
+def generate_ulid() -> str:
+    """Generate a ULID string (timestamp-based, sortable, 26 chars, Crockford Base32)."""
+    timestamp_ms = int(time.time() * 1000)
+    random_int = int.from_bytes(os.urandom(10))
+    chars: list[str] = []
+    for shift in (45, 40, 35, 30, 25, 20, 15, 10, 5, 0):
+        chars.append(_CROCKFORD[(timestamp_ms >> shift) & 0x1F])
+    for shift in (75, 70, 65, 60, 55, 50, 45, 40, 35, 30, 25, 20, 15, 10, 5, 0):
+        chars.append(_CROCKFORD[(random_int >> shift) & 0x1F])
+    return "".join(chars)

{nighthawk_python-0.2.0 → nighthawk_python-0.3.1}/tests/public/test_public_api.py

@@ -1,4 +1,5 @@
 import asyncio
+import importlib.metadata
 from collections.abc import Generator
 
 import pytest
@@ -26,7 +27,7 @@ def step_span_exporter() -> Generator[InMemorySpanExporter, None, None]:
     tracer_provider.add_span_processor(SimpleSpanProcessor(span_exporter))
 
     previous_tracer_provider = runtime_scoping._tracer
-    runtime_scoping._tracer = tracer_provider.get_tracer("nighthawk")
+    runtime_scoping._tracer = tracer_provider.get_tracer("nighthawk", importlib.metadata.version("nighthawk-python"))
     try:
         yield span_exporter
     finally:
@@ -428,3 +429,43 @@ def test_step_span_failure_event_structure_is_compact(step_span_exporter: InMemo
     assert "exception" in exception_event_name_set
     assert "nighthawk.step.failed" in exception_event_name_set
     assert len(step_span.events) == 2
+
+
+def test_run_span_has_only_run_id_attribute(step_span_exporter: InMemorySpanExporter) -> None:
+    with nh.run(StubExecutor(), run_id="attr-test"):
+
+        @nh.natural_function
+        def natural_value_function() -> int:
+            """natural
+            <:result>
+            {"step_outcome": {"kind": "pass"}, "bindings": {"result": 42}}
+            """
+            return result  # noqa: F821  # pyright: ignore[reportUndefinedVariable]
+
+        assert natural_value_function() == 42
+
+    run_span_list = [s for s in step_span_exporter.get_finished_spans() if s.name == "nighthawk.run"]
+    assert len(run_span_list) == 1
+    run_span = run_span_list[0]
+    assert _require_attribute_key_set(run_span) == {"run.id"}
+    assert _require_attribute_value(run_span, "run.id") == "attr-test"
+
+
+def test_no_implicit_scope_or_step_executor_spans(step_span_exporter: InMemorySpanExporter) -> None:
+    with nh.run(StubExecutor()):
+
+        @nh.natural_function
+        def natural_value_function() -> int:
+            """natural
+            <:result>
+            {"step_outcome": {"kind": "pass"}, "bindings": {"result": 7}}
+            """
+            return result  # noqa: F821  # pyright: ignore[reportUndefinedVariable]
+
+        assert natural_value_function() == 7
+
+    span_name_set = {s.name for s in step_span_exporter.get_finished_spans()}
+    assert "nighthawk.scope" not in span_name_set
+    assert "nighthawk.step_executor" not in span_name_set
+    assert "nighthawk.run" in span_name_set
+    assert "nighthawk.step" in span_name_set

{nighthawk_python-0.2.0 → nighthawk_python-0.3.1}/uv.lock

@@ -761,7 +761,7 @@ wheels = [
 
 [[package]]
 name = "nighthawk-python"
-version = "0.2.0"
+version = "0.3.1"
 source = { editable = "." }
 dependencies = [
     { name = "headson" },
@@ -799,7 +799,7 @@ docs = [
 
 [package.metadata]
 requires-dist = [
-    { name = "claude-agent-sdk", marker = "extra == 'claude-code-sdk'", specifier = ">=0.1" },
+    { name = "claude-agent-sdk", marker = "extra == 'claude-code-sdk'", specifier = "==0.1.48" },
     { name = "headson", specifier = ">=0.16.1" },
     { name = "mcp", marker = "extra == 'claude-code-cli'", specifier = ">=1.26" },
     { name = "mcp", marker = "extra == 'codex'", specifier = ">=1.26" },
@@ -836,7 +836,7 @@ wheels = [
 
 [[package]]
 name = "openai"
-version = "2.28.0"
+version = "2.29.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "anyio" },
@@ -848,9 +848,9 @@ dependencies = [
     { name = "tqdm" },
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/56/87/eb0abb4ef88ddb95b3c13149384c4c288f584f3be17d6a4f63f8c3e3c226/openai-2.28.0.tar.gz", hash = "sha256:bb7fdff384d2a787fa82e8822d1dd3c02e8cf901d60f1df523b7da03cbb6d48d", size = 670334, upload-time = "2026-03-13T19:56:27.306Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/b4/15/203d537e58986b5673e7f232453a2a2f110f22757b15921cbdeea392e520/openai-2.29.0.tar.gz", hash = "sha256:32d09eb2f661b38d3edd7d7e1a2943d1633f572596febe64c0cd370c86d52bec", size = 671128, upload-time = "2026-03-17T17:53:49.599Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/c0/5a/df122348638885526e53140e9c6b0d844af7312682b3bde9587eebc28b47/openai-2.28.0-py3-none-any.whl", hash = "sha256:79aa5c45dba7fef84085701c235cf13ba88485e1ef4f8dfcedc44fc2a698fc1d", size = 1141218, upload-time = "2026-03-13T19:56:25.46Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/b1/35b6f9c8cf9318e3dbb7146cc82dab4cf61182a8d5406fc9b50864362895/openai-2.29.0-py3-none-any.whl", hash = "sha256:b7c5de513c3286d17c5e29b92c4c98ceaf0d775244ac8159aeb1bddf840eb42a", size = 1141533, upload-time = "2026-03-17T17:53:47.348Z" },
 ]
 
 [[package]]
@@ -997,17 +997,17 @@ wheels = [
 
 [[package]]
 name = "protobuf"
-version = "6.33.5"
+version = "6.33.6"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/ba/25/7c72c307aafc96fa87062aa6291d9f7c94836e43214d43722e86037aac02/protobuf-6.33.5.tar.gz", hash = "sha256:6ddcac2a081f8b7b9642c09406bc6a4290128fce5f471cddd165960bb9119e5c", size = 444465, upload-time = "2026-01-29T21:51:33.494Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/66/70/e908e9c5e52ef7c3a6c7902c9dfbb34c7e29c25d2f81ade3856445fd5c94/protobuf-6.33.6.tar.gz", hash = "sha256:a6768d25248312c297558af96a9f9c929e8c4cee0659cb07e780731095f38135", size = 444531, upload-time = "2026-03-18T19:05:00.988Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/b1/79/af92d0a8369732b027e6d6084251dd8e782c685c72da161bd4a2e00fbabb/protobuf-6.33.5-cp310-abi3-win32.whl", hash = "sha256:d71b040839446bac0f4d162e758bea99c8251161dae9d0983a3b88dee345153b", size = 425769, upload-time = "2026-01-29T21:51:21.751Z" },
-    { url = "https://files.pythonhosted.org/packages/55/75/bb9bc917d10e9ee13dee8607eb9ab963b7cf8be607c46e7862c748aa2af7/protobuf-6.33.5-cp310-abi3-win_amd64.whl", hash = "sha256:3093804752167bcab3998bec9f1048baae6e29505adaf1afd14a37bddede533c", size = 437118, upload-time = "2026-01-29T21:51:24.022Z" },
-    { url = "https://files.pythonhosted.org/packages/a2/6b/e48dfc1191bc5b52950246275bf4089773e91cb5ba3592621723cdddca62/protobuf-6.33.5-cp39-abi3-macosx_10_9_universal2.whl", hash = "sha256:a5cb85982d95d906df1e2210e58f8e4f1e3cdc088e52c921a041f9c9a0386de5", size = 427766, upload-time = "2026-01-29T21:51:25.413Z" },
-    { url = "https://files.pythonhosted.org/packages/4e/b1/c79468184310de09d75095ed1314b839eb2f72df71097db9d1404a1b2717/protobuf-6.33.5-cp39-abi3-manylinux2014_aarch64.whl", hash = "sha256:9b71e0281f36f179d00cbcb119cb19dec4d14a81393e5ea220f64b286173e190", size = 324638, upload-time = "2026-01-29T21:51:26.423Z" },
-    { url = "https://files.pythonhosted.org/packages/c5/f5/65d838092fd01c44d16037953fd4c2cc851e783de9b8f02b27ec4ffd906f/protobuf-6.33.5-cp39-abi3-manylinux2014_s390x.whl", hash = "sha256:8afa18e1d6d20af15b417e728e9f60f3aa108ee76f23c3b2c07a2c3b546d3afd", size = 339411, upload-time = "2026-01-29T21:51:27.446Z" },
-    { url = "https://files.pythonhosted.org/packages/9b/53/a9443aa3ca9ba8724fdfa02dd1887c1bcd8e89556b715cfbacca6b63dbec/protobuf-6.33.5-cp39-abi3-manylinux2014_x86_64.whl", hash = "sha256:cbf16ba3350fb7b889fca858fb215967792dc125b35c7976ca4818bee3521cf0", size = 323465, upload-time = "2026-01-29T21:51:28.925Z" },
-    { url = "https://files.pythonhosted.org/packages/57/bf/2086963c69bdac3d7cff1cc7ff79b8ce5ea0bec6797a017e1be338a46248/protobuf-6.33.5-py3-none-any.whl", hash = "sha256:69915a973dd0f60f31a08b8318b73eab2bd6a392c79184b3612226b0a3f8ec02", size = 170687, upload-time = "2026-01-29T21:51:32.557Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/9f/2f509339e89cfa6f6a4c4ff50438db9ca488dec341f7e454adad60150b00/protobuf-6.33.6-cp310-abi3-win32.whl", hash = "sha256:7d29d9b65f8afef196f8334e80d6bc1d5d4adedb449971fefd3723824e6e77d3", size = 425739, upload-time = "2026-03-18T19:04:48.373Z" },
+    { url = "https://files.pythonhosted.org/packages/76/5d/683efcd4798e0030c1bab27374fd13a89f7c2515fb1f3123efdfaa5eab57/protobuf-6.33.6-cp310-abi3-win_amd64.whl", hash = "sha256:0cd27b587afca21b7cfa59a74dcbd48a50f0a6400cfb59391340ad729d91d326", size = 437089, upload-time = "2026-03-18T19:04:50.381Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/01/a3c3ed5cd186f39e7880f8303cc51385a198a81469d53d0fdecf1f64d929/protobuf-6.33.6-cp39-abi3-macosx_10_9_universal2.whl", hash = "sha256:9720e6961b251bde64edfdab7d500725a2af5280f3f4c87e57c0208376aa8c3a", size = 427737, upload-time = "2026-03-18T19:04:51.866Z" },
+    { url = "https://files.pythonhosted.org/packages/ee/90/b3c01fdec7d2f627b3a6884243ba328c1217ed2d978def5c12dc50d328a3/protobuf-6.33.6-cp39-abi3-manylinux2014_aarch64.whl", hash = "sha256:e2afbae9b8e1825e3529f88d514754e094278bb95eadc0e199751cdd9a2e82a2", size = 324610, upload-time = "2026-03-18T19:04:53.096Z" },
+    { url = "https://files.pythonhosted.org/packages/9b/ca/25afc144934014700c52e05103c2421997482d561f3101ff352e1292fb81/protobuf-6.33.6-cp39-abi3-manylinux2014_s390x.whl", hash = "sha256:c96c37eec15086b79762ed265d59ab204dabc53056e3443e702d2681f4b39ce3", size = 339381, upload-time = "2026-03-18T19:04:54.616Z" },
+    { url = "https://files.pythonhosted.org/packages/16/92/d1e32e3e0d894fe00b15ce28ad4944ab692713f2e7f0a99787405e43533a/protobuf-6.33.6-cp39-abi3-manylinux2014_x86_64.whl", hash = "sha256:e9db7e292e0ab79dd108d7f1a94fe31601ce1ee3f7b79e0692043423020b0593", size = 323436, upload-time = "2026-03-18T19:04:55.768Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/72/02445137af02769918a93807b2b7890047c32bfb9f90371cbc12688819eb/protobuf-6.33.6-py3-none-any.whl", hash = "sha256:77179e006c476e69bf8e8ce866640091ec42e1beb80b213c3900006ecfba6901", size = 170656, upload-time = "2026-03-18T19:04:59.826Z" },
 ]
 
 [[package]]
@@ -1036,7 +1036,7 @@ wheels = [
 
 [[package]]
 name = "pydantic-ai-slim"
-version = "1.68.0"
+version = "1.70.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "genai-prices" },
@@ -1047,9 +1047,9 @@ dependencies = [
     { name = "pydantic-graph" },
     { name = "typing-inspection" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/d4/00/3e48684694e424a8d05dc1538fe53322854b0290fbb494f0007db62cd243/pydantic_ai_slim-1.68.0.tar.gz", hash = "sha256:38edda1dbe20137326903d8a223a9f4901d62b0a70799842cae3c7d60b3bebd2", size = 436924, upload-time = "2026-03-13T03:39:08.572Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/ac/97/d57ee44976c349658ea7c645c5c2e1a26830e4b60fdeeee2669d4aaef6eb/pydantic_ai_slim-1.70.0.tar.gz", hash = "sha256:3df0c0e92f72c35e546d24795bce1f4d38f81da2d10addd2e9f255b2d2c83c91", size = 445474, upload-time = "2026-03-18T04:24:34.393Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/46/14/4e850e54024b453ed905aa92b50b286ed9b096979e7d0896005be5e5b74c/pydantic_ai_slim-1.68.0-py3-none-any.whl", hash = "sha256:c3234c743ab256c7f26aecb2296428a55ae3db9f9ebb8d725941cae887e8e027", size = 567829, upload-time = "2026-03-13T03:39:00.91Z" },
+    { url = "https://files.pythonhosted.org/packages/da/8c/8545d28d0b3a9957aa21393cfdab8280bb854362360b296cd486ed1713ec/pydantic_ai_slim-1.70.0-py3-none-any.whl", hash = "sha256:162907092a562b3160d9ef0418d317ec941c5c0e6dd6e0aa0dbb53b5a5cd3450", size = 576244, upload-time = "2026-03-18T04:24:27.301Z" },
 ]
 
 [package.optional-dependencies]
@@ -1113,7 +1113,7 @@ wheels = [
 
 [[package]]
 name = "pydantic-graph"
-version = "1.68.0"
+version = "1.70.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "httpx" },
@@ -1121,9 +1121,9 @@ dependencies = [
     { name = "pydantic" },
     { name = "typing-inspection" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/08/75/de53b774d7b96adc7a75ddc4cac4dfaea25d5538b5004710fc1e9a74180c/pydantic_graph-1.68.0.tar.gz", hash = "sha256:fa48d15659e9514393f0596f62a0355783309e725deedb14d8f3e68fccf3974a", size = 58534, upload-time = "2026-03-13T03:39:10.896Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/07/27/f7a71ca2a3705e7c24fd777959cf5515646cc5f23b5b16c886a2ed373340/pydantic_graph-1.70.0.tar.gz", hash = "sha256:3f76d9137369ef8748b0e8a6df1a08262118af20a32bc139d23e5c0509c6b711", size = 58578, upload-time = "2026-03-18T04:24:37.007Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/d0/bf/cd45f1987468679e8d631d1c0e6014c4156815440a985389bd11aeb4465f/pydantic_graph-1.68.0-py3-none-any.whl", hash = "sha256:a563291109c3efb69fe7553f20b164651fe98680252e8f07a3cd9a1db2f8a879", size = 72350, upload-time = "2026-03-13T03:39:04.439Z" },
+    { url = "https://files.pythonhosted.org/packages/38/fd/19c42b60c37dfdbbf5b76c7b218e8309b43dac501f7aaf2025527ca05023/pydantic_graph-1.70.0-py3-none-any.whl", hash = "sha256:6083c1503a2587990ee1b8a15915106e3ddabc8f3f11fbc4a108a7d7496af4a5", size = 72351, upload-time = "2026-03-18T04:24:30.291Z" },
 ]
 
 [[package]]
@@ -1532,15 +1532,15 @@ wheels = [
 
 [[package]]
 name = "sse-starlette"
-version = "3.3.2"
+version = "3.3.3"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "anyio" },
     { name = "starlette" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/5a/9f/c3695c2d2d4ef70072c3a06992850498b01c6bc9be531950813716b426fa/sse_starlette-3.3.2.tar.gz", hash = "sha256:678fca55a1945c734d8472a6cad186a55ab02840b4f6786f5ee8770970579dcd", size = 32326, upload-time = "2026-02-28T11:24:34.36Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/14/2f/9223c24f568bb7a0c03d751e609844dce0968f13b39a3f73fbb3a96cd27a/sse_starlette-3.3.3.tar.gz", hash = "sha256:72a95d7575fd5129bd0ae15275ac6432bb35ac542fdebb82889c24bb9f3f4049", size = 32420, upload-time = "2026-03-17T20:05:55.529Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/61/28/8cb142d3fe80c4a2d8af54ca0b003f47ce0ba920974e7990fa6e016402d1/sse_starlette-3.3.2-py3-none-any.whl", hash = "sha256:5c3ea3dad425c601236726af2f27689b74494643f57017cafcb6f8c9acfbb862", size = 14270, upload-time = "2026-02-28T11:24:32.984Z" },
+    { url = "https://files.pythonhosted.org/packages/78/e2/b8cff57a67dddf9a464d7e943218e031617fb3ddc133aeeb0602ff5f6c85/sse_starlette-3.3.3-py3-none-any.whl", hash = "sha256:c5abb5082a1cc1c6294d89c5290c46b5f67808cfdb612b7ec27e8ba061c22e8d", size = 14329, upload-time = "2026-03-17T20:05:54.35Z" },
 ]
 
 [[package]]

nighthawk_python-0.2.0/CHANGELOG.md

@@ -1,35 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [Unreleased]
-
-## [0.2.0] - 2026-03-16
-
-### Added
-- Added compact step trace support for Natural block execution attempts:
-  - `StepTrace`
-  - `StepTraceError`
-  - `nighthawk.get_step_traces()`
-
-### Changed
-- Updated CI workflow setup (`setup-uv`) in project automation.
-
-### Fixed
-- License badge reference in README.
-- Documentation formatting inconsistencies.
-
-## [0.1.0] - 2026-03-13
-
-### Added
-- Initial public release of `nighthawk-python`.
-- Natural DSL execution runtime with run/scope execution context model.
-- Step executor abstraction and provider integration foundation.
-- Core documentation and project scaffolding.
-
-[Unreleased]: https://github.com/kurusugawa-computer/nighthawk-python/compare/v0.2.0...HEAD
-[0.2.0]: https://github.com/kurusugawa-computer/nighthawk-python/compare/v0.1.0...v0.2.0
-[0.1.0]: https://github.com/kurusugawa-computer/nighthawk-python/tree/v0.1.0