chore: import upstream snapshot with attribution

2026-07-13 13:39:25 +08:00
commit db620d33df
5151 changed files with 925932 additions and 0 deletions
@@ -0,0 +1,57 @@
+# Durable Task Package (agent-framework-durabletask)
+
+Durable execution support for long-running agent workflows using Azure Durable Functions.
+
+## Main Classes
+
+### Client Side
+
+- **`DurableAIAgentClient`** - Client for invoking durable agents
+- **`DurableAIAgent`** - Shim for creating durable agents
+
+### Worker Side
+
+- **`DurableAIAgentWorker`** - Worker that executes durable agent tasks
+- **`DurableAgentExecutor`** - Executes agent logic within durable context
+- **`AgentEntity`** - Durable entity for agent state management
+
+### State Management
+
+- **`DurableAgentState`** - State container for durable agents
+- **`DurableAgentSession`** - Session management for durable agents
+- **`DurableAIAgentOrchestrationContext`** - Orchestration context
+
+### Callbacks
+
+- **`AgentCallbackContext`** - Context for agent callbacks
+- **`AgentResponseCallbackProtocol`** - Protocol for response callbacks
+
+## Usage
+
+```python
+from agent_framework import Agent
+from agent_framework.openai import OpenAIChatCompletionClient
+from agent_framework_durabletask import DurableAIAgentClient, DurableAIAgentWorker
+from durabletask.client import TaskHubGrpcClient
+from durabletask.worker import TaskHubGrpcWorker
+
+# Client side
+dt_client = TaskHubGrpcClient(host_address="localhost:4001")
+agent_client = DurableAIAgentClient(dt_client)
+durable_agent = agent_client.get_agent("assistant")
+
+# Worker side
+dt_worker = TaskHubGrpcWorker(host_address="localhost:4001")
+agent_worker = DurableAIAgentWorker(dt_worker)
+
+# Create a chat client for the agent
+chat_client = OpenAIChatCompletionClient()
+my_agent = Agent(client=chat_client, name="assistant")
+agent_worker.add_agent(my_agent)
+```
+
+## Import Path
+
+```python
+from agent_framework_durabletask import DurableAIAgentClient, DurableAIAgentWorker
+```