Python: add agent-framework-hosting core package

python/packages/hosting/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

python/packages/hosting/README.md

@@ -0,0 +1,59 @@
+# 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** — pluggable adapters that
+expose the target over different transports. The result is a single
+Starlette ASGI application you can host anywhere (local Hypercorn,
+Azure Container Apps, Foundry Hosted Agents, …).
+
+The base package contains only the channel-neutral plumbing:
+
+- `AgentFrameworkHost` — the Starlette host
+- `Channel` / `ChannelPush` — the channel protocols
+- `ChannelRequest` / `ChannelSession` / `ChannelIdentity` / `ResponseTarget`
+  — the request envelope and routing primitives
+- `ChannelContext` / `ChannelContribution` / `ChannelCommand` — the
+  channel-side hooks for invoking the target and contributing routes,
+  commands, and lifecycle callbacks
+- `ChannelRunHook` / `ChannelStreamTransformHook` — the per-request
+  customization seams
+
+Concrete channels live in their own packages so you only install what
+you use:
+
+| Package | Transport |
+|---|---|
+| `agent-framework-hosting-responses` | OpenAI Responses API |
+| `agent-framework-hosting-invocations` | Foundry-native invocation envelope |
+| `agent-framework-hosting-telegram` | Telegram Bot API |
+| `agent-framework-hosting-activity-protocol` | Bot Framework Activity Protocol (Teams, Direct Line, Web Chat, …) |
+| `agent-framework-hosting-teams` | Microsoft Teams (Teams SDK) |
+| `agent-framework-hosting-entra` | Entra (OAuth) identity-link sidecar |
+
+## Install
+
+```bash
+pip install agent-framework-hosting agent-framework-hosting-responses
+# or with uvicorn pre-installed for the demo `host.serve(...)` helper
+pip install "agent-framework-hosting[serve]" agent-framework-hosting-responses
+```
+
+## Quickstart
+
+```python
+from agent_framework import ChatAgent
+from agent_framework.openai import OpenAIChatClient
+from agent_framework_hosting import AgentFrameworkHost
+from agent_framework_hosting_responses import ResponsesChannel
+
+agent = ChatAgent(name="Assistant", chat_client=OpenAIChatClient())
+
+host = AgentFrameworkHost(target=agent, channels=[ResponsesChannel()])
+host.serve(port=8000)
+```
+
+See the [hosting samples](https://github.com/microsoft/agent-framework/tree/main/python/samples/04-hosting/af-hosting)
+for richer multi-channel apps (Telegram + Teams + Responses fan-out,
+identity linking, `ResponseTarget` routing, etc.).

python/packages/hosting/agent_framework_hosting/__init__.py

@@ -0,0 +1,74 @@
+# 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 such as the
+OpenAI Responses API, Microsoft Teams, Telegram, and others. The base
+package contains only the channel-neutral plumbing; concrete channels
+ship in their own packages (``agent-framework-hosting-responses``,
+``agent-framework-hosting-telegram``, …) 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,
+    ChannelPush,
+    ChannelRequest,
+    ChannelRunHook,
+    ChannelSession,
+    ChannelStreamTransformHook,
+    DeliveryReport,
+    HostedRunResult,
+    ResponseTarget,
+    ResponseTargetKind,
+    apply_run_hook,
+)
+
+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",
+    "ChannelPush",
+    "ChannelRequest",
+    "ChannelRunHook",
+    "ChannelSession",
+    "ChannelStreamTransformHook",
+    "DeliveryReport",
+    "HostedRunResult",
+    "IsolationKeys",
+    "ResponseTarget",
+    "ResponseTargetKind",
+    "__version__",
+    "apply_run_hook",
+    "get_current_isolation_keys",
+    "logger",
+    "reset_current_isolation_keys",
+    "set_current_isolation_keys",
+]