toolstream 0.1.0__tar.gz

toolstream-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,25 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+env:
+  UV_NO_SOURCES: "1"
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        # requires-python: >= {{pypi.minRequiredPython}}
+        python-version: ["3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@v7
+      - run: uv python install ${{ matrix.python-version }}
+      - run: uv sync
+      - run: uv run python -c "import toolstream"

toolstream-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,21 @@
+name: Publish
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@v7
+      - run: uv build
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true

toolstream-0.1.0/.gitignore

@@ -0,0 +1,17 @@
+node_modules/
+__pycache__/
+*.pyc
+*.log
+.DS_Store
+coverage/
+dist/
+*.egg-info/
+.rlsbl-notes-*.tmp
+.rlsbl/lock
+.credentials.json
+.*-cache.json
+.env
+.env.local
+*.local-only
+
+.rlsbl-monorepo/lock

toolstream-0.1.0/.rlsbl/bases/.github/workflows/ci.yml

@@ -0,0 +1,25 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+env:
+  UV_NO_SOURCES: "1"
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        # requires-python: >= {{pypi.minRequiredPython}}
+        python-version: ["3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@v7
+      - run: uv python install ${{ matrix.python-version }}
+      - run: uv sync
+      - run: uv run python -c "import toolstream"

toolstream-0.1.0/.rlsbl/bases/.github/workflows/publish.yml

@@ -0,0 +1,21 @@
+name: Publish
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@v7
+      - run: uv build
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true

toolstream-0.1.0/.rlsbl/bases/.gitignore

@@ -0,0 +1,16 @@
+node_modules/
+__pycache__/
+*.pyc
+*.log
+.DS_Store
+coverage/
+dist/
+*.egg-info/
+.rlsbl-notes-*.tmp
+.rlsbl/lock
+.rlsbl-monorepo/lock
+.credentials.json
+.*-cache.json
+.env
+.env.local
+*.local-only

toolstream-0.1.0/.rlsbl/bases/.rlsbl/hooks/post-release.sh

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+# Post-release hook. Runs after a successful release (non-fatal).
+# Environment: RLSBL_VERSION is set to the released version.
+# Customize this for your project (e.g., local install, deploy, notify).
+
+set -euo pipefail
+
+echo "Post-release: v$RLSBL_VERSION"
+
+# Push to assembly for unified documentation site
+if command -v selfdoc &>/dev/null && [ -f selfdoc.json ]; then
+  if python3 -c "import json; c=json.load(open('selfdoc.json')); exit(0 if c.get('assembly') or (c.get('topology') or {}).get('assembly') else 1)" 2>/dev/null; then
+    echo "Pushing to documentation assembly..."
+    selfdoc assembly push || echo "Warning: assembly push failed (non-fatal)"
+  fi
+fi

toolstream-0.1.0/.rlsbl/bases/.rlsbl/hooks/pre-checks.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -euo pipefail
+# This hook runs BEFORE built-in pre-release checks (tests, lint).
+# Use it for setup tasks: starting services, setting env vars, etc.
+# Built-in checks run after this hook. Custom validation goes in pre-release.sh.

toolstream-0.1.0/.rlsbl/bases/.rlsbl/hooks/pre-release.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+set -euo pipefail
+# Project-specific pre-release checks.
+# When this hook is customized (any change from the scaffold template),
+# built-in tests and lint are skipped -- the hook is expected to handle them.
+# Add custom validation here, e.g.:
+#   - Run tests and lint with project-specific flags
+#   - Check for uncommitted documentation
+#   - Verify external service connectivity
+#   - Run integration tests not covered by the test suite

toolstream-0.1.0/.rlsbl/bases/.rlsbl/lint/python.toml

@@ -0,0 +1,25 @@
+[forbidden-imports]
+modules = [
+    "argparse",
+    "click",
+    "typer",
+    "flask",
+    "fastapi",
+    "django",
+    "uvicorn",
+    "granian",
+    "starlette",
+    "tornado",
+    "bottle",
+]
+
+[stdout]
+enabled = true
+ignore = []
+
+[entry-point]
+enabled = true
+ignore = []
+
+[files]
+exclude = []

toolstream-0.1.0/.rlsbl/bases/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 0.1.0
+
+- Initial release

toolstream-0.1.0/.rlsbl/changes/.validated

@@ -0,0 +1 @@
+fc67d7d7fd04667ac82ff49e54875ee5cfa32b12

toolstream-0.1.0/.rlsbl/changes/0.1.0.jsonl

@@ -0,0 +1,15 @@
+{"commits":["c55effaf38258e704c0fb226209331d1580acfab","c1ce7abe9bcdcb50345e89482afc9d6b3c778974","a9481027ed2223f6d224891c9a7c1a7cf37909cc","eef1c8f83910cc5b81a92f30617f5c78720a7f4a","62872272c9c0405fa125a5000e07fa68664851e7"],"user_facing":true,"description":"**New feature.** Typed streaming SDK for LLM tool-calling loops with async/sync sessions, tool registration, agent definitions, and direct API backend.","type":"feature"}
+{"commits":["1669386f20681682a82b24ff8ada3594f724c3cd","d4bc8abb8e57eed561c634bbfb48ef6dc193ab15","89d9e4342a75286946e511805eb56b85b7fcf4d2","33be63efbb342dd71512e555f1c29bb8f1a7e596","a984925afc18ecd97698724649d00439ec2fda61"],"user_facing":false}
+{"commits":["4dd50fedaf0d9e8f6319462fcbda94ee576e5c86","1ad69e4fc2f72ea04d70571f4ed89566d05aef02","4b87daaa2e4c067a147cb532a55c4352c0b3fbb6","a02905c95d26c2f5d85b02c1e99839a6767b8a65","f0007c69a636edfaa58566387e0c871775155443"],"user_facing":false}
+{"commits":["48f8d679198e93f90d0a7f093fc871153432f630","78415fc02c7fc070f101dd1b3c8e79f052cf8607","bf8f7709477802d19549d0e5013ae93e01370d8a"],"user_facing":false}
+{"commits":["26149d43fdd04d5e264a3ab9a19fea6091c0d3e0","f4607a61c8787982789f33a6f37b96f4b1b3e2a6","fc6772a1d11577ebdbf9d76886100ce7e96ce9a1","9f93e82b5845089e4191ddf115e294f9bb92a002","0852d267c46d995fc5b108d10c6e5139bab10020"],"user_facing":false}
+{"commits":["e6d6102e24f0b512801a50df417b7533169a3724","28eb8ae8a65061759b9f0af8d93e4c3c641d7738","33fddaae9cb7b69c73e36cf96f0d5bfbfa6550fd","6af9091768435b243765db7d12d0d682d0010486","463bb9047017b64bd1c78d76854f35893ed972f2"],"user_facing":false}
+{"commits":["0c2c142e7fcc6a64cc2edcbd2ac17b90f305ecfb","212e3a09205b013ec0e6affe31ca3496b536d71b","7e032734872527adf7e0b7765d8ff13c7b547e21","4f6e6840254384a6bc84af2ae882592619733be2"],"user_facing":false}
+{"commits":["1e120368f06d2bcf2bd08a598d47b0c8325e4ce5","a35b1ed40b6bfed1adb21adaf83d10fbeb47c6e0","495c8a63467ef6353fc44dfefeb14b62145fc0bd","28ddb67d9d4b61748724816d7471c11d55fdff29","0695651f242154f42d735b208ac68980a8fff45f"],"user_facing":false}
+{"commits":["b8ed602e225e66eecf2105517176e5aa9c928c56","2a2febcd235eae94175bbc7874d0a7e3ad6c7301","a016bdada30c37c165064243c3abb2760e9ef44f","b1945206f0a81b67b7fb64ad8578232129ef634d","d408e39ac29dcde7c4e7d483a0f79847e8210859"],"user_facing":false}
+{"commits":["bba6f6362b31ebd896703a700481084c0c6c0be5","30fa6347b895bf263d61a336b0890d32f6f8b219","088c98e0f759a261ec8468e1339095b60ca2fb10","a4bea191e26aaea8f3b710e2c73bdeed54449d45","f1c995dffbca5f38b1a9e1734db0fb687b7f5895"],"user_facing":false}
+{"commits":["b1a4603d793057bf1a9e2bd4c757871685d29154","98e5605d3bf3cf1681d81d26d500c9d5ba0efe1c","5a9489ef0bfa4cee9189c40c567c33cea31454b3","a171da6831bbd808c565e058b7830188031f158c","5b7b608d504faa37679f168afcac86785688e391"],"user_facing":false}
+{"commits":["b2dfd283226ac361a3912e21c9ac7e239b7a8df9","9cf2a20523e76ebad80008affddb16829e5a10c6","b84b6383cf625ed39eefa05608e51c865974947c","a0aa9fe86be17d8482d583ae4794d62fa224069a","cfe8a844ff8ec17254c256625a2b5a4216a5e4d5"],"user_facing":false}
+{"commits":["4d91e4a683c29b770be4fa23c86c422224fde968","76b5de6aa85b6c02ea5e072470fa2811f1ba27eb","14f61389136eb114c7fdbbc2f89bd4a87ab6a9ad","250e22fd2d90ca9ad1a2d006f5861f892c2432c2","707a8c463d70a9d93efdbe9a42f9891cbbe050ec"],"user_facing":false}
+{"commits":["c3344480247105a363a94bd0268c20bd5b825e03","fa94248b24017a7b4fea2974bff0093df8fc6573","e62f6cc8f85546b16df0c15f89ad8680e1814d54","9445cdf9c6282e3c9da8be13b317d947e18f6889"],"user_facing":false}
+{"commits":["e1b14fd6c7a16694dcf918aa77e4398e96323d96","18368bf426ad38fcdfdae7317f5ea723a6191b63"],"user_facing":false}

toolstream-0.1.0/.rlsbl/changes/0.1.0.md

@@ -0,0 +1,7 @@
+## 0.1.0
+
+Initial release: typed streaming SDK for LLM tool-calling loops
+
+### Features
+
+- **New feature.** Typed streaming SDK for LLM tool-calling loops with async/sync sessions, tool registration, agent definitions, and direct API backend.

toolstream-0.1.0/.rlsbl/config.json

@@ -0,0 +1,12 @@
+{
+  "targets": [
+    "pypi"
+  ],
+  "private": false,
+  "pipelines": {
+    "pypi": {
+      "type": "pypi",
+      "local": false
+    }
+  }
+}

toolstream-0.1.0/.rlsbl/hashes.json

@@ -0,0 +1,11 @@
+{
+  ".github/workflows/ci.yml": "3c8019d75aad7546f505fe83725adab37a67037f2c09bf19bd8d1767cc4c7ee2",
+  ".github/workflows/publish.yml": "c86fe3682721199f304390f8acbaf57aef8b5e6d98cca4787aa70ef209979596",
+  "CHANGELOG.md": "7a6ec46141007c18090a0ff325e2dd68cd51588c4e0b5af7b580365e5eaaca85",
+  ".gitignore": "c0582f9b1c640f9f9a8acbbe02cd19fff50e66cc595f25e129b7cc9b6cd357db",
+  ".rlsbl/hooks/pre-checks.sh": "60c57d4563263124530e6f33aca77550ea2161ad3b33b3ba6ad1c03fea9eb6e2",
+  ".rlsbl/hooks/pre-release.sh": "799fe9a8ed742f5b4f7bc32856df8487b05ab28a37aaa0e9ecf854ea289c5305",
+  ".rlsbl/hooks/post-release.sh": "a7548df0ce46ee421865afbe50b0c327b301ad003519aa2f2521edb484c3865c",
+  ".rlsbl/changes/unreleased.jsonl": "11f98a6a99eb629a9b201adf81d5de7c4df6cfdac5fbf945dd62223ad1b397a8",
+  ".rlsbl/lint/python.toml": "9cfbcef2e010d5fad243437bf2fd8df54a1fae70ee0762f9d11da70fe207501c"
+}

toolstream-0.1.0/.rlsbl/hooks/post-release.sh

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+# Post-release hook. Runs after a successful release (non-fatal).
+# Environment: RLSBL_VERSION is set to the released version.
+# Customize this for your project (e.g., local install, deploy, notify).
+
+set -euo pipefail
+
+echo "Post-release: v$RLSBL_VERSION"
+
+# Push to assembly for unified documentation site
+if command -v selfdoc &>/dev/null && [ -f selfdoc.json ]; then
+  if python3 -c "import json; c=json.load(open('selfdoc.json')); exit(0 if c.get('assembly') or (c.get('topology') or {}).get('assembly') else 1)" 2>/dev/null; then
+    echo "Pushing to documentation assembly..."
+    selfdoc assembly push || echo "Warning: assembly push failed (non-fatal)"
+  fi
+fi

toolstream-0.1.0/.rlsbl/hooks/pre-checks.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -euo pipefail
+# This hook runs BEFORE built-in pre-release checks (tests, lint).
+# Use it for setup tasks: starting services, setting env vars, etc.
+# Built-in checks run after this hook. Custom validation goes in pre-release.sh.

toolstream-0.1.0/.rlsbl/hooks/pre-release.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+set -euo pipefail
+# Project-specific pre-release checks.
+# When this hook is customized (any change from the scaffold template),
+# built-in tests and lint are skipped -- the hook is expected to handle them.
+# Add custom validation here, e.g.:
+#   - Run tests and lint with project-specific flags
+#   - Check for uncommitted documentation
+#   - Verify external service connectivity
+#   - Run integration tests not covered by the test suite

toolstream-0.1.0/.rlsbl/lint/python.toml

@@ -0,0 +1,25 @@
+[forbidden-imports]
+modules = [
+    "argparse",
+    "click",
+    "typer",
+    "flask",
+    "fastapi",
+    "django",
+    "uvicorn",
+    "granian",
+    "starlette",
+    "tornado",
+    "bottle",
+]
+
+[stdout]
+enabled = true
+ignore = []
+
+[entry-point]
+enabled = true
+ignore = []
+
+[files]
+exclude = []

toolstream-0.1.0/.rlsbl/managed-files.json

@@ -0,0 +1,14 @@
+{
+  "version": 1,
+  "files": {
+    ".github/workflows/ci.yml": "3c8019d75aad7546f505fe83725adab37a67037f2c09bf19bd8d1767cc4c7ee2",
+    ".github/workflows/publish.yml": "c86fe3682721199f304390f8acbaf57aef8b5e6d98cca4787aa70ef209979596",
+    "CHANGELOG.md": "7a6ec46141007c18090a0ff325e2dd68cd51588c4e0b5af7b580365e5eaaca85",
+    ".gitignore": "c0582f9b1c640f9f9a8acbbe02cd19fff50e66cc595f25e129b7cc9b6cd357db",
+    ".rlsbl/hooks/pre-checks.sh": "60c57d4563263124530e6f33aca77550ea2161ad3b33b3ba6ad1c03fea9eb6e2",
+    ".rlsbl/hooks/pre-release.sh": "799fe9a8ed742f5b4f7bc32856df8487b05ab28a37aaa0e9ecf854ea289c5305",
+    ".rlsbl/hooks/post-release.sh": "a7548df0ce46ee421865afbe50b0c327b301ad003519aa2f2521edb484c3865c",
+    ".rlsbl/changes/unreleased.jsonl": "11f98a6a99eb629a9b201adf81d5de7c4df6cfdac5fbf945dd62223ad1b397a8",
+    ".rlsbl/lint/python.toml": "9cfbcef2e010d5fad243437bf2fd8df54a1fae70ee0762f9d11da70fe207501c"
+  }
+}

toolstream-0.1.0/.rlsbl/releases/v0.1.0.toml

@@ -0,0 +1,10 @@
+# Version bump type: patch, minor, or major
+bump = "minor"
+# Short description of this release (required)
+description = "Initial release: typed streaming SDK for LLM tool-calling loops"
+# Optional context explaining why these changes were made
+context = ""
+# Set to true to generate a blog post for this release
+# blog = false
+include = ["pypi"]
+exclude = []

toolstream-0.1.0/.rlsbl/version

@@ -0,0 +1 @@
+0.74.1

toolstream-0.1.0/CHANGELOG.md

@@ -0,0 +1,11 @@
+<!-- Generated by rlsbl from .rlsbl/changes/ — do not edit -->
+
+# Changelog
+
+## 0.1.0
+
+Initial release: typed streaming SDK for LLM tool-calling loops
+
+### Features
+
+- **New feature.** Typed streaming SDK for LLM tool-calling loops with async/sync sessions, tool registration, agent definitions, and direct API backend.

toolstream-0.1.0/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: toolstream
+Version: 0.1.0
+Summary: Typed streaming SDK for LLM tool-calling loops
+Keywords: rlsbl
+Requires-Python: >=3.11
+Requires-Dist: httpx

toolstream-0.1.0/npm/README.md

@@ -0,0 +1,8 @@
+# toolstream
+
+This is a name-claim shim. The real package is on PyPI:
+
+    pip install toolstream
+
+- PyPI: https://pypi.org/project/toolstream/
+- GitHub: https://github.com/smm-h/toolstream

toolstream-0.1.0/npm/index.js

@@ -0,0 +1,5 @@
+throw new Error(
+  "toolstream is a Python package. Install it with: pip install toolstream\n" +
+  "PyPI: https://pypi.org/project/toolstream/\n" +
+  "GitHub: https://github.com/smm-h/toolstream"
+);

toolstream-0.1.0/npm/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "toolstream",
+  "version": "0.1.0",
+  "description": "Typed streaming SDK for LLM tool-calling loops (Python package — install via pip)",
+  "main": "index.js",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/smm-h/toolstream"
+  },
+  "keywords": ["llm", "streaming", "tool-calling", "ai", "sdk"],
+  "license": "UNLICENSED"
+}

toolstream-0.1.0/pyproject.toml

@@ -0,0 +1,26 @@
+[project]
+name = "toolstream"
+version = "0.1.0"
+requires-python = ">=3.11"
+description = "Typed streaming SDK for LLM tool-calling loops"
+
+dependencies = ["httpx"]
+keywords = ["rlsbl"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["toolstream"]
+
+[dependency-groups]
+dev = ["pytest", "pytest-asyncio"]
+
+[tool.pytest.ini_options]
+addopts = "--import-mode=importlib -m 'not slow'"
+testpaths = ["tests"]
+markers = [
+    "slow: marks tests as slow (deselect with '-m \"not slow\"')",
+]
+asyncio_mode = "auto"

toolstream-0.1.0/tests/conftest.py

@@ -0,0 +1,98 @@
+"""Shared fixtures for toolstream tests -- mock LLM responder."""
+
+from __future__ import annotations
+
+import json
+from typing import Any
+
+import httpx
+import pytest
+
+from toolstream.config import SessionConfig
+
+
+def text_response(
+    content: str,
+    prompt_tokens: int = 10,
+    completion_tokens: int = 5,
+) -> dict:
+    """Build a canned text-only chat completion response."""
+    return {
+        "choices": [{
+            "message": {
+                "content": content,
+                "tool_calls": None,
+            },
+            "finish_reason": "stop",
+        }],
+        "usage": {
+            "prompt_tokens": prompt_tokens,
+            "completion_tokens": completion_tokens,
+            "total_tokens": prompt_tokens + completion_tokens,
+        },
+    }
+
+
+def tool_call_response(
+    tool_name: str,
+    arguments: dict,
+    call_id: str = "call_1",
+    prompt_tokens: int = 10,
+    completion_tokens: int = 5,
+) -> dict:
+    """Build a canned tool-call chat completion response."""
+    return {
+        "choices": [{
+            "message": {
+                "content": None,
+                "tool_calls": [{
+                    "id": call_id,
+                    "type": "function",
+                    "function": {
+                        "name": tool_name,
+                        "arguments": json.dumps(arguments),
+                    },
+                }],
+            },
+            "finish_reason": "tool_calls",
+        }],
+        "usage": {
+            "prompt_tokens": prompt_tokens,
+            "completion_tokens": completion_tokens,
+            "total_tokens": prompt_tokens + completion_tokens,
+        },
+    }
+
+
+def direct_config(**overrides: Any) -> SessionConfig:
+    """Build a SessionConfig suitable for DirectClient with mock http_client."""
+    defaults: dict[str, Any] = dict(
+        model="test-model",
+        api_key="test-key",
+        base_url="https://mock-gateway.test/v1/chat/completions",
+        system_prompt="You are a test assistant.",
+    )
+    defaults.update(overrides)
+    return SessionConfig(**defaults)
+
+
+@pytest.fixture
+def mock_llm_responses():
+    """Factory fixture: call with canned response dicts to get a mock httpx.AsyncClient."""
+
+    def factory(*responses: dict) -> httpx.AsyncClient:
+        it = iter(responses)
+
+        def handler(request: httpx.Request) -> httpx.Response:
+            try:
+                response_dict = next(it)
+            except StopIteration:
+                raise RuntimeError(
+                    f"mock_llm_responses exhausted: expected at most "
+                    f"{len(responses)} call(s)"
+                )
+            return httpx.Response(200, json=response_dict)
+
+        return httpx.AsyncClient(transport=httpx.MockTransport(handler))
+
+    return factory

toolstream-0.1.0/tests/fixtures/agents/explorer.agent.json

@@ -0,0 +1,6 @@
+{
+  "name": "explorer",
+  "version": "1.0",
+  "prompt_template": "You are an explorer agent. Task: {task}",
+  "description": "Test explorer agent"
+}

toolstream-0.1.0/tests/fixtures/agents/orchestrator.agent.json

@@ -0,0 +1,7 @@
+{
+  "name": "orchestrator",
+  "version": "1.0",
+  "prompt_template": "You are an orchestrator. Task: {task}",
+  "description": "Test orchestrator agent",
+  "tools": [{"name": "read"}, {"name": "write"}]
+}