agent-framework-hosting 1.0.0a260625__tar.gz

agent_framework_hosting-1.0.0a260625/LICENSE

@@ -0,0 +1,21 @@
+    MIT License
+
+    Copyright (c) Microsoft Corporation.
+
+    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

agent_framework_hosting-1.0.0a260625/PKG-INFO

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: agent-framework-hosting
+Version: 1.0.0a260625
+Summary: Multi-channel hosting for Microsoft Agent Framework agents.
+Author-email: Microsoft <af-support@microsoft.com>
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+License-File: LICENSE
+Requires-Dist: agent-framework-core>=1.10.0,<2
+Requires-Dist: starlette>=0.37
+Requires-Dist: diskcache>=5.6 ; extra == "disk"
+Requires-Dist: hypercorn>=0.17 ; extra == "serve"
+Project-URL: homepage, https://aka.ms/agent-framework
+Project-URL: issues, https://github.com/microsoft/agent-framework/issues
+Project-URL: release_notes, https://github.com/microsoft/agent-framework/releases?q=tag%3Apython-1&expanded=true
+Project-URL: source, https://github.com/microsoft/agent-framework/tree/main/python
+Provides-Extra: disk
+Provides-Extra: serve
+
+# agent-framework-hosting
+
+Multi-channel hosting for Microsoft Agent Framework agents.
+
+`agent-framework-hosting` lets you serve a single agent or workflow target
+through one or more **channels**. The host owns one Starlette ASGI app,
+route/lifecycle composition, and per-`isolation_key` session resolution.
+Each channel owns its protocol parsing and response rendering.
+
+The base package contains only channel-neutral plumbing:
+
+- `AgentFrameworkHost` — the Starlette host.
+- `Channel` — the channel protocol.
+- `ChannelRequest` / `ChannelSession` / `ChannelIdentity` — the request
+  envelope and optional channel metadata.
+- `ChannelContext` / `ChannelContribution` / `ChannelCommand` — channel-side
+  hooks for invoking the target and contributing routes, commands, and
+  lifecycle callbacks.
+- `ChannelRunHook` / `ChannelResponseHook` / `ChannelStreamUpdateHook` —
+  host-invoked customization seams.
+
+`ChannelStreamUpdateHook` applies to streamed updates only. It is not a
+substitute for final-response redaction.
+
+Concrete channels live in their own packages so you only install what you use:
+
+| Package | Transport |
+|---|---|
+| `agent-framework-hosting-responses` | OpenAI Responses API |
+
+Additional channel packages can build on the same host contract without adding
+their protocol dependencies to the base package.
+
+## Install
+
+```bash
+pip install agent-framework-hosting agent-framework-hosting-responses
+# or with Hypercorn pre-installed for the demo `host.serve(...)` helper
+pip install "agent-framework-hosting[serve]" agent-framework-hosting-responses
+# add the [disk] extra to persist reset-session aliases
+pip install "agent-framework-hosting[disk]"
+```
+
+## Quickstart
+
+```python
+from agent_framework.openai import OpenAIChatClient
+from agent_framework_hosting import AgentFrameworkHost, Channel
+
+agent = OpenAIChatClient().as_agent(name="Assistant")
+
+# Add channels from sibling packages, e.g. `agent-framework-hosting-responses`
+# exposes a `ResponsesChannel` that serves the OpenAI Responses API.
+channels: list[Channel] = []
+
+host = AgentFrameworkHost(target=agent, channels=channels)
+host.serve(port=8000)
+```
+
+## Session state and workflow checkpoints
+
+By default the host keeps live `AgentSession` objects and reset-session aliases
+in memory. Channels opt into continuity by setting
+`ChannelRequest.session = ChannelSession(isolation_key=...)`; requests with the
+same isolation key reuse the same host-created session.
+
+The host treats `isolation_key` as an opaque partition key. Each channel or
+hosting environment decides where that key comes from:
+
+- protocol headers supplied by a trusted platform,
+- request body fields such as a previous response or conversation ID,
+- route/path parameters,
+- channel-native metadata such as chat/user IDs, or
+- environment-provided context in an ephemeral host.
+
+The host should be able to carry any of those sources as long as the channel or
+platform has already authenticated and authorized the caller before passing the
+key to `ChannelSession`.
+
+The built-in request-context helper recognizes the `x-agent-user-isolation-key`
+and `x-agent-chat-isolation-key` header names because some hosting
+environments, including Foundry Hosted Agents, already use them. Reusing those
+header names does **not** mean `agent-framework-hosting` is the supported way to
+run on Foundry Hosted Agents; use `agent-framework-foundry-hosting` for that
+hosting surface.
+
+For long-running deployments that need `reset_session(...)` aliases to survive
+restart, pass `state_dir`:
+
+```python
+host = AgentFrameworkHost(
+    target=agent,
+    channels=channels,
+    state_dir="./.host-state",
+)
+```
+
+This creates `./.host-state/sessions/` and stores only lightweight alias
+bookkeeping. Live `AgentSession` objects are still rehydrated lazily by the
+configured history provider on the next turn.
+
+For workflow targets, `checkpoint_location=...` is the clearest way to enable
+checkpoint persistence. As a convenience, `state_dir="./.host-state"` also
+derives `./.host-state/checkpoints/` for workflow targets. Use the mapping form
+when you want only one component:
+
+```python
+from agent_framework_hosting import HostStatePaths
+
+host = AgentFrameworkHost(
+    target=workflow,
+    channels=channels,
+    state_dir=HostStatePaths(
+        sessions="/var/lib/myapp/sessions",
+        checkpoints="/var/lib/myapp/checkpoints",
+    ),
+)
+```
+
+Cross-channel identity linking, multicast delivery, background runs,
+continuation tokens, and durable delivery runners are follow-up enhancements,
+not part of this v1 host contract.
+

agent_framework_hosting-1.0.0a260625/README.md

@@ -0,0 +1,122 @@
+# agent-framework-hosting
+
+Multi-channel hosting for Microsoft Agent Framework agents.
+
+`agent-framework-hosting` lets you serve a single agent or workflow target
+through one or more **channels**. The host owns one Starlette ASGI app,
+route/lifecycle composition, and per-`isolation_key` session resolution.
+Each channel owns its protocol parsing and response rendering.
+
+The base package contains only channel-neutral plumbing:
+
+- `AgentFrameworkHost` — the Starlette host.
+- `Channel` — the channel protocol.
+- `ChannelRequest` / `ChannelSession` / `ChannelIdentity` — the request
+  envelope and optional channel metadata.
+- `ChannelContext` / `ChannelContribution` / `ChannelCommand` — channel-side
+  hooks for invoking the target and contributing routes, commands, and
+  lifecycle callbacks.
+- `ChannelRunHook` / `ChannelResponseHook` / `ChannelStreamUpdateHook` —
+  host-invoked customization seams.
+
+`ChannelStreamUpdateHook` applies to streamed updates only. It is not a
+substitute for final-response redaction.
+
+Concrete channels live in their own packages so you only install what you use:
+
+| Package | Transport |
+|---|---|
+| `agent-framework-hosting-responses` | OpenAI Responses API |
+
+Additional channel packages can build on the same host contract without adding
+their protocol dependencies to the base package.
+
+## Install
+
+```bash
+pip install agent-framework-hosting agent-framework-hosting-responses
+# or with Hypercorn pre-installed for the demo `host.serve(...)` helper
+pip install "agent-framework-hosting[serve]" agent-framework-hosting-responses
+# add the [disk] extra to persist reset-session aliases
+pip install "agent-framework-hosting[disk]"
+```
+
+## Quickstart
+
+```python
+from agent_framework.openai import OpenAIChatClient
+from agent_framework_hosting import AgentFrameworkHost, Channel
+
+agent = OpenAIChatClient().as_agent(name="Assistant")
+
+# Add channels from sibling packages, e.g. `agent-framework-hosting-responses`
+# exposes a `ResponsesChannel` that serves the OpenAI Responses API.
+channels: list[Channel] = []
+
+host = AgentFrameworkHost(target=agent, channels=channels)
+host.serve(port=8000)
+```
+
+## Session state and workflow checkpoints
+
+By default the host keeps live `AgentSession` objects and reset-session aliases
+in memory. Channels opt into continuity by setting
+`ChannelRequest.session = ChannelSession(isolation_key=...)`; requests with the
+same isolation key reuse the same host-created session.
+
+The host treats `isolation_key` as an opaque partition key. Each channel or
+hosting environment decides where that key comes from:
+
+- protocol headers supplied by a trusted platform,
+- request body fields such as a previous response or conversation ID,
+- route/path parameters,
+- channel-native metadata such as chat/user IDs, or
+- environment-provided context in an ephemeral host.
+
+The host should be able to carry any of those sources as long as the channel or
+platform has already authenticated and authorized the caller before passing the
+key to `ChannelSession`.
+
+The built-in request-context helper recognizes the `x-agent-user-isolation-key`
+and `x-agent-chat-isolation-key` header names because some hosting
+environments, including Foundry Hosted Agents, already use them. Reusing those
+header names does **not** mean `agent-framework-hosting` is the supported way to
+run on Foundry Hosted Agents; use `agent-framework-foundry-hosting` for that
+hosting surface.
+
+For long-running deployments that need `reset_session(...)` aliases to survive
+restart, pass `state_dir`:
+
+```python
+host = AgentFrameworkHost(
+    target=agent,
+    channels=channels,
+    state_dir="./.host-state",
+)
+```
+
+This creates `./.host-state/sessions/` and stores only lightweight alias
+bookkeeping. Live `AgentSession` objects are still rehydrated lazily by the
+configured history provider on the next turn.
+
+For workflow targets, `checkpoint_location=...` is the clearest way to enable
+checkpoint persistence. As a convenience, `state_dir="./.host-state"` also
+derives `./.host-state/checkpoints/` for workflow targets. Use the mapping form
+when you want only one component:
+
+```python
+from agent_framework_hosting import HostStatePaths
+
+host = AgentFrameworkHost(
+    target=workflow,
+    channels=channels,
+    state_dir=HostStatePaths(
+        sessions="/var/lib/myapp/sessions",
+        checkpoints="/var/lib/myapp/checkpoints",
+    ),
+)
+```
+
+Cross-channel identity linking, multicast delivery, background runs,
+continuation tokens, and durable delivery runners are follow-up enhancements,
+not part of this v1 host contract.

agent_framework_hosting-1.0.0a260625/agent_framework_hosting/__init__.py

@@ -0,0 +1,66 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+"""Multi-channel hosting for Microsoft Agent Framework agents.
+
+Serve a single agent target through one or more **channels** — pluggable
+adapters that expose the target over different transports. The base
+package contains only the channel-neutral plumbing; concrete channels
+ship in their own packages, such as ``agent-framework-hosting-responses``,
+so users install only what they need.
+"""
+
+import importlib.metadata
+
+from ._host import AgentFrameworkHost, ChannelContext, logger
+from ._isolation import (
+    ISOLATION_HEADER_CHAT,
+    ISOLATION_HEADER_USER,
+    IsolationKeys,
+    get_current_isolation_keys,
+    reset_current_isolation_keys,
+    set_current_isolation_keys,
+)
+from ._types import (
+    Channel,
+    ChannelCommand,
+    ChannelCommandContext,
+    ChannelContribution,
+    ChannelIdentity,
+    ChannelRequest,
+    ChannelResponseHook,
+    ChannelRunHook,
+    ChannelSession,
+    ChannelStreamUpdateHook,
+    HostedRunResult,
+    HostStatePaths,
+)
+
+try:
+    __version__ = importlib.metadata.version(__name__)
+except importlib.metadata.PackageNotFoundError:
+    __version__ = "0.0.0"
+
+__all__ = [
+    "ISOLATION_HEADER_CHAT",
+    "ISOLATION_HEADER_USER",
+    "AgentFrameworkHost",
+    "Channel",
+    "ChannelCommand",
+    "ChannelCommandContext",
+    "ChannelContext",
+    "ChannelContribution",
+    "ChannelIdentity",
+    "ChannelRequest",
+    "ChannelResponseHook",
+    "ChannelRunHook",
+    "ChannelSession",
+    "ChannelStreamUpdateHook",
+    "HostStatePaths",
+    "HostedRunResult",
+    "IsolationKeys",
+    "__version__",
+    "get_current_isolation_keys",
+    "logger",
+    "reset_current_isolation_keys",
+    "set_current_isolation_keys",
+]