claudestream 0.1.0__tar.gz

claudestream-0.1.0/.claude/settings.json

@@ -0,0 +1,3 @@
+{
+  "hooks": {}
+}

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

@@ -0,0 +1,21 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+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 claudestream"

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

@@ -0,0 +1,18 @@
+name: Publish
+
+on:
+  release:
+    types: [published]
+
+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

claudestream-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+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

claudestream-0.1.0/.rlsbl/bases/.claude/settings.json

@@ -0,0 +1,3 @@
+{
+  "hooks": {}
+}

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

@@ -0,0 +1,21 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+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 claudestream"

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

@@ -0,0 +1,18 @@
+name: Publish
+
+on:
+  release:
+    types: [published]
+
+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

claudestream-0.1.0/.rlsbl/bases/.gitignore

@@ -0,0 +1,15 @@
+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

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

@@ -0,0 +1,8 @@
+#!/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"

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

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# Pre-release validation hook.
+# Runs before rlsbl creates a release. Exit non-zero to abort.
+# Detects project type and runs appropriate checks automatically.
+
+set -euo pipefail
+
+echo "Running pre-release checks..."
+
+if [ -f go.mod ]; then
+  echo "  Go: vet + build + test"
+  go vet ./...
+  go build ./...
+  go test ./... -race -short -count=1
+fi
+
+if [ -f pyproject.toml ]; then
+  echo "  Python: pytest"
+  if command -v uv &>/dev/null; then
+    uv run pytest
+  elif command -v pytest &>/dev/null; then
+    pytest
+  fi
+fi
+
+if [ -f package.json ] && node -e "process.exit(require('./package.json').scripts?.test ? 0 : 1)" 2>/dev/null; then
+  echo "  npm: test"
+  npm test
+fi
+
+# Library lint (monorepo only)
+if command -v rlsbl &>/dev/null; then
+  if rlsbl doctor --check library-lint 2>/dev/null; then
+    :
+  else
+    echo "  Library lint check failed"
+    exit 1
+  fi
+fi
+
+echo "Pre-release checks passed."

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

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

claudestream-0.1.0/.rlsbl/bases/CLAUDE.md

@@ -0,0 +1,20 @@
+# claudestream
+
+## Release workflow
+
+This project uses [rlsbl](https://github.com/smm-h/rlsbl) for release orchestration.
+
+- Update CHANGELOG.md with a `## X.Y.Z` entry describing changes
+- Run `rlsbl release [patch|minor|major]` to bump version and create a GitHub Release
+- CI handles publishing automatically via the publish workflow
+- Never publish manually — always use `rlsbl release`
+- Configure Trusted Publishing on pypi.org for automated PyPI releases
+- Use `rlsbl release --dry-run` to preview a release without making changes
+
+## Conventions
+
+- No tokens or secrets in command-line arguments (use env vars or config files)
+- All file writes to shared state should be atomic (write to tmp, then rename)
+- External calls (APIs, CLI tools) must have timeouts and graceful fallbacks
+- Use `npm link` (npm) or `uv pip install -e .` (Python) for local development
+- CI runs smoke tests on every push; manual testing for UI/UX changes

claudestream-0.1.0/.rlsbl/bases/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 smm-h
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

claudestream-0.1.0/.rlsbl/config.json

@@ -0,0 +1,5 @@
+{
+  "targets": [
+    "pypi"
+  ]
+}

claudestream-0.1.0/.rlsbl/hashes.json

@@ -0,0 +1,11 @@
+{
+  ".github/workflows/ci.yml": "4328950c6097cc32e53ea8f750a3dde1b8593a480b9007b4548cd740fc0d56e6",
+  ".github/workflows/publish.yml": "55e2dba57d17218c2887ba90051d31aee15067cc0b69c8adebc2deab07aef76b",
+  "CHANGELOG.md": "7a6ec46141007c18090a0ff325e2dd68cd51588c4e0b5af7b580365e5eaaca85",
+  ".gitignore": "c89d76c6c43e7f0897b3472a15b7c0103e0be5b3a04c2b44e585fa48bdcda2bb",
+  "LICENSE": "e958892abc1dd5d991fca6d528e695d335f25773d373d2e0be5f4a9507d8f8d5",
+  "CLAUDE.md": "7d5b9e24e36e74f0116b97fc3510382c1fddec9bd611a1230db4330e161f5ac6",
+  ".rlsbl/hooks/pre-release.sh": "c3579d31ae56b8415d7dfead8758ec488fe9ffceea0e2592c1fe1d0ac8ee858c",
+  ".rlsbl/hooks/post-release.sh": "b455f8511e0b2655509ecf5dcb0ab7da5bb7c961f47910ff8e00cab5bd51f833",
+  ".claude/settings.json": "78922a784ee78e9e50587e93628cd3b9d4dfbe49087adc4514e6781cea38cbb9"
+}

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

@@ -0,0 +1,8 @@
+#!/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"

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

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# Pre-release validation hook.
+# Runs before rlsbl creates a release. Exit non-zero to abort.
+# Detects project type and runs appropriate checks automatically.
+
+set -euo pipefail
+
+echo "Running pre-release checks..."
+
+if [ -f go.mod ]; then
+  echo "  Go: vet + build + test"
+  go vet ./...
+  go build ./...
+  go test ./... -race -short -count=1
+fi
+
+if [ -f pyproject.toml ]; then
+  echo "  Python: pytest"
+  if command -v uv &>/dev/null; then
+    uv run pytest
+  elif command -v pytest &>/dev/null; then
+    pytest
+  fi
+fi
+
+if [ -f package.json ] && node -e "process.exit(require('./package.json').scripts?.test ? 0 : 1)" 2>/dev/null; then
+  echo "  npm: test"
+  npm test
+fi
+
+# Library lint (monorepo only)
+if command -v rlsbl &>/dev/null; then
+  if rlsbl doctor --check library-lint 2>/dev/null; then
+    :
+  else
+    echo "  Library lint check failed"
+    exit 1
+  fi
+fi
+
+echo "Pre-release checks passed."

claudestream-0.1.0/.rlsbl/version

@@ -0,0 +1 @@
+0.22.1

claudestream-0.1.0/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## 0.1.0
+
+- Async and sync session APIs (`AsyncSession`, `SyncSession`) for multi-turn conversations with Claude Code
+- One-shot `print_prompt()` convenience function for simple use cases
+- Typed event models for all Claude Code stream-json event types
+- Real-time streaming token support via `StreamDelta` events
+- Configurable permission policy system (allow_all, deny_all, allow_builtins, allow_list, custom callbacks)
+- CLI with 4 commands: `send`, `stream`, `events`, `repl`
+- Subprocess lifecycle management with graceful shutdown

claudestream-0.1.0/CLAUDE.md

@@ -0,0 +1,20 @@
+# claudestream
+
+## Release workflow
+
+This project uses [rlsbl](https://github.com/smm-h/rlsbl) for release orchestration.
+
+- Update CHANGELOG.md with a `## X.Y.Z` entry describing changes
+- Run `rlsbl release [patch|minor|major]` to bump version and create a GitHub Release
+- CI handles publishing automatically via the publish workflow
+- Never publish manually — always use `rlsbl release`
+- Configure Trusted Publishing on pypi.org for automated PyPI releases
+- Use `rlsbl release --dry-run` to preview a release without making changes
+
+## Conventions
+
+- No tokens or secrets in command-line arguments (use env vars or config files)
+- All file writes to shared state should be atomic (write to tmp, then rename)
+- External calls (APIs, CLI tools) must have timeouts and graceful fallbacks
+- Use `npm link` (npm) or `uv pip install -e .` (Python) for local development
+- CI runs smoke tests on every push; manual testing for UI/UX changes

claudestream-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 smm-h
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

claudestream-0.1.0/PKG-INFO

@@ -0,0 +1,11 @@
+Metadata-Version: 2.4
+Name: claudestream
+Version: 0.1.0
+Summary: A Python library and CLI for streaming Claude Code's JSON protocol
+Author-email: SMM-H <lisa.codi@veliu.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: rlsbl
+Requires-Python: >=3.11
+Requires-Dist: selfdoc
+Requires-Dist: strictcli

claudestream-0.1.0/claudestream/__init__.py

@@ -0,0 +1,120 @@
+"""A Python library and CLI for streaming Claude Code's JSON protocol."""
+
+from claudestream._async_session import AsyncSession, ClaudeStreamError
+from claudestream._sync_session import SyncSession
+from claudestream.events import (
+    AssistantMessage,
+    AssistantText,
+    ApiRetry,
+    CompactBoundary,
+    ContentBlock,
+    Event,
+    McpRequest,
+    PermissionRequest,
+    RateLimit,
+    Result,
+    StreamDelta,
+    SystemInit,
+    TextBlock,
+    Thinking,
+    ThinkingBlock,
+    ToolResult,
+    ToolResultBlock,
+    ToolResultMessage,
+    ToolUse,
+    ToolUseBlock,
+    UnknownEvent,
+    Usage,
+)
+from claudestream.policy import (
+    Allow,
+    AllowAllPolicy,
+    AllowBuiltinsPolicy,
+    AllowListPolicy,
+    CallbackPolicy,
+    Deny,
+    Policy,
+    allow_all,
+    allow_builtins,
+    allow_list,
+    callback,
+    deny_all,
+)
+
+__all__ = [
+    # Sessions
+    "AsyncSession",
+    "SyncSession",
+    "ClaudeStreamError",
+    # Events
+    "Event",
+    "SystemInit",
+    "ApiRetry",
+    "CompactBoundary",
+    "AssistantMessage",
+    "AssistantText",
+    "ToolResultMessage",
+    "ToolUse",
+    "ToolResult",
+    "Thinking",
+    "StreamDelta",
+    "Result",
+    "RateLimit",
+    "PermissionRequest",
+    "McpRequest",
+    "UnknownEvent",
+    # Content blocks
+    "TextBlock",
+    "ToolUseBlock",
+    "ThinkingBlock",
+    "ToolResultBlock",
+    "ContentBlock",
+    "Usage",
+    # Policy
+    "Policy",
+    "Allow",
+    "Deny",
+    "AllowAllPolicy",
+    "AllowBuiltinsPolicy",
+    "AllowListPolicy",
+    "CallbackPolicy",
+    "allow_all",
+    "deny_all",
+    "allow_builtins",
+    "allow_list",
+    "callback",
+    # Convenience
+    "print_prompt",
+]
+
+
+def print_prompt(
+    prompt: str,
+    *,
+    model: str | None = None,
+    cwd: str | None = None,
+    binary: str | None = None,
+    policy: Policy | None = None,
+    system_prompt: str | None = None,
+    extra_args: list[str] | None = None,
+    env: dict[str, str] | None = None,
+) -> str:
+    """One-shot convenience: send a prompt and return the full response text.
+
+    Creates a SyncSession, sends one message, collects AssistantText events,
+    and returns the concatenated text. For claudewheel integration.
+    """
+    parts: list[str] = []
+    with SyncSession(
+        model=model,
+        cwd=cwd,
+        binary=binary,
+        policy=policy,
+        system_prompt=system_prompt,
+        extra_args=extra_args,
+        env=env,
+    ) as session:
+        for event in session.send(prompt):
+            if isinstance(event, AssistantText):
+                parts.append(event.text)
+    return "".join(parts)