aimarket-streaming 2.0.0__py3-none-any.whl

aimarket_streaming/__init__.py

@@ -0,0 +1 @@
+# aimarket-streaming plugin

aimarket_streaming/plugin.py

@@ -0,0 +1,19 @@
+"""streaming plugin for AIMarket Hub."""
+
+from aimarket_hub.plugin import HubPlugin
+from aimarket_streaming.streaming import *
+
+
+class StreamingPlugin(HubPlugin):
+    name = "aimarket-streaming"
+    version = "2.0.0"
+    description = "streaming"
+    homepage = "https://github.com/alexar76/aimarket-plugins"
+    category = "monetization"
+
+    def register_routes(self, router):
+        from fastapi import APIRouter as _AR
+        # Plugin-specific routes will be registered here
+        pass
+    def on_startup(self, db):
+        self._biller = None  # Lazy init on first stream

aimarket_streaming/streaming.py

@@ -0,0 +1,3 @@
+"""Streaming — re-export shim from aimarket_hub.streaming (canonical)."""
+
+from aimarket_hub.streaming import *  # noqa: F401, F403

aimarket_streaming-2.0.0.dist-info/METADATA

@@ -0,0 +1,89 @@
+Metadata-Version: 2.4
+Name: aimarket-streaming
+Version: 2.0.0
+Summary: SSE/WS streaming + per-chunk billing with micro-receipts
+Author-email: AI-Factory <dev@modelmarket.dev>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/alexar76/aimarket-plugins
+Project-URL: Documentation, https://github.com/alexar76/aimarket-plugins/tree/main/plugins/aimarket-streaming#readme
+Project-URL: Repository, https://github.com/alexar76/aimarket-plugins
+Project-URL: Issues, https://github.com/alexar76/aimarket-plugins/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aimarket-hub>=2.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Dynamic: license-file
+
+# aimarket-streaming
+
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [User guide](docs/user-guide.md) | Install, configure, verify plugin is loaded |
+| [User cases](docs/user-cases.md) | Personas and cross-plugin workflows |
+| [SDK integration](docs/sdk-integration.md) | Code examples and hook behavior |
+
+---
+
+**SSE/WS streaming + per-chunk billing with micro-receipts.**
+Capability streams tokens. Every N tokens → signed micro-receipt. Consumer can cancel mid-stream — pays only for what was received. Channel balance debited incrementally.
+
+## When to Use
+- LLM text generation (tokens streamed → billed per 10 tokens)
+- Long-running AI tasks where consumer wants partial results
+- Budget-sensitive consumers who want to cancel mid-stream
+- Audit: every chunk has a signed receipt for compliance
+
+## Installation
+```bash
+pip install aimarket-streaming
+```
+
+## Example
+```python
+from aimarket_hub.signing import Signer
+from aimarket_streaming.streaming import StreamingBiller
+
+signer = Signer()
+biller = StreamingBiller(signer)
+
+session = biller.open_session(
+    capability_id="text.generate@v1", product_id="prod-gpt",
+    channel_id="ch_abc123", price_per_token_usd=0.001,
+    tokens_per_chunk=10
+)
+
+async def token_stream():
+    for word in ["The", "quick", "brown", "fox", "jumps", "over", "the", "lazy", "dog", ".", "..."]:
+        yield word  # In production: yield actual LLM tokens
+
+import asyncio
+async def main():
+    async for chunk in biller.stream_tokens(session, token_stream()):
+        print(f"Chunk {chunk['chunk_receipt']['chunk_index']}: "
+              f"${chunk['cumulative_price_usd']:.6f} "
+              f"({chunk['cumulative_tokens']} tokens)")
+
+asyncio.run(main())
+
+# Cancel mid-stream — pays only for received
+result = biller.cancel_session(session.session_id)
+print(f"Cancelled. Total paid: ${result['total_price_usd']:.6f}")
+```
+
+## Per-Chunk Billing
+- `price_per_token_usd`: 0.001 (0.1 cent per token)
+- `tokens_per_chunk`: 10 (micro-receipt every 10 tokens)
+- Each chunk receipt is Ed25519-signed — verifiable audit trail
+
+## License
+MIT · Maintained by AI-Factory

aimarket_streaming-2.0.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+aimarket_streaming/__init__.py,sha256=sBwdDDC7HVWETMAj2cQFBD_BY53xZeGHkXNpDBTsRWg,28
+aimarket_streaming/plugin.py,sha256=J06iWY-9EX-7vLfyj1nfnINDDJANQ_KoGpnaZeuS4xQ,581
+aimarket_streaming/streaming.py,sha256=jOo85p1bCLcc0eDZiWsSQICCIOwR67KeNouggaFfRt8,134
+aimarket_streaming-2.0.0.dist-info/licenses/LICENSE,sha256=XMDybCZE66kpDYCsKwJ6_GbxSP7p3r-XIc7u_-KcTYA,1088
+aimarket_streaming-2.0.0.dist-info/METADATA,sha256=OrEjmmkgMr8JB49m7mh8lqkfJBVm2kVxB7F31qLM-i0,3181
+aimarket_streaming-2.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+aimarket_streaming-2.0.0.dist-info/entry_points.txt,sha256=HeUaa5k9h_CZiztfa5LTomLVw2Ip7M5sovLYEcT-kkg,73
+aimarket_streaming-2.0.0.dist-info/top_level.txt,sha256=_LGk6TtwAOI95z3_lB-wfe28xko5Q_VoSU4pUjV4qYA,19
+aimarket_streaming-2.0.0.dist-info/RECORD,,

aimarket_streaming-2.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

aimarket_streaming-2.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[aimarket.plugins]
+streaming = aimarket_streaming.plugin:StreamingPlugin

aimarket_streaming-2.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AI-Factory Project Contributors
+
+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.

aimarket_streaming-2.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+aimarket_streaming