wisruntime 0.4.0__tar.gz → 0.4.2__tar.gz

{wisruntime-0.4.0/wisruntime.egg-info → wisruntime-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wisruntime
-Version: 0.4.0
+Version: 0.4.2
 Summary: 企业级 Agent Runtime SDK — 让 AI 工程师专注 Agent 能力开发，无需关心底层基础设施
 Author: WIS Team
 License-Expression: MIT

{wisruntime-0.4.0 → wisruntime-0.4.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "wisruntime"
-version = "0.4.0"
+version = "0.4.2"
 description = "企业级 Agent Runtime SDK — 让 AI 工程师专注 Agent 能力开发，无需关心底层基础设施"
 readme = "README.md"
 requires-python = ">=3.11"

{wisruntime-0.4.0 → wisruntime-0.4.2}/wisruntime/conversation/__init__.py

@@ -1,53 +1,55 @@
-"""会话模块 / Conversation Module.
-
-wishub-memory 会话服务的薄写客户端 (agent 通道) + 自动持久化记录器。
-框架无关——任何框架都可以使用，也自动集成进 create_server。
-
-两种接入模式:
-
-**方式一：自动持久化 (推荐，零代码集成)**
-
-    >>> from wisruntime import create_server
-    >>> from wisruntime.conversation import ConversationClient
-    >>>
-    >>> server = create_server(
-    ...     my_agent,
-    ...     conversation_client=ConversationClient(),
-    ... )
-    >>> # 之后每次请求自动完成：
-    >>> #   1. 首轮自动创建会话 (回填 conversation_id 到流式事件)
-    >>> #   2. 每轮结束后后台追加 user + assistant 两条消息
-    >>> #   3. 持久化失败不影响响应
-
-**方式二：手动客户端 (薄写客户端，agent 通道)**
-
-    >>> from wisruntime.conversation import ConversationClient
-    >>>
-    >>> async with ConversationClient() as client:
-    ...     conv = await client.create_conversation(user_id="u_001")
-    ...     # 一轮问答需要调用两次：一次 user，一次 assistant
-    ...     await client.append_message(conv.conversation_id, "user", "你好")
-    ...     await client.append_message(conv.conversation_id, "assistant", "你好!")
-
-    同步版本 (不能在事件循环中调用):
-    >>> client = ConversationClient()
-    >>> conv = client.create_conversation_sync(user_id="u_001")
-    >>> client.append_message_sync(conv.conversation_id, "user", "你好")
-
-范围说明:
-- 仅 agent 通道写操作 (创建会话 + 追加消息)。历史消息、会话列表等
-  读操作走用户通道 (user JWT)，由应用侧调用，不在 SDK 范围。
-- 依赖中台接口落地：移除两个端点的 agentId 必填要求。落地前 SDK
-  通过 agent_id 可选透传兼容两种形态，落地后清理。
-"""
-
-from wisruntime.conversation.client import ConversationClient
-from wisruntime.conversation.model import ConversationInfo, MessageInfo
-from wisruntime.conversation.recorder import ConversationRecorder
-
-__all__ = [
-    "ConversationClient",
-    "ConversationRecorder",
-    "ConversationInfo",
-    "MessageInfo",
-]
+"""会话模块 / Conversation Module.
+
+wishub-memory 会话服务的薄写客户端 (agent 通道) + 自动持久化记录器。
+框架无关——任何框架都可以使用，也自动集成进 create_server。
+
+两种接入模式:
+
+**方式一：自动持久化 (推荐，零代码集成)**
+
+    >>> from wisruntime import create_server
+    >>> from wisruntime.conversation import ConversationClient
+    >>>
+    >>> server = create_server(
+    ...     my_agent,
+    ...     conversation_client=ConversationClient(),
+    ... )
+    >>> # 之后每次请求自动完成：
+    >>> #   1. 首轮自动创建会话 (回填 conversation_id 到流式事件)
+    >>> #   2. 每轮结束后后台追加 user + assistant 两条消息
+    >>> #   3. 持久化失败不影响响应
+
+**方式二：手动客户端 (薄写客户端，agent 通道)**
+
+    >>> from wisruntime.conversation import ConversationClient
+    >>>
+    >>> async with ConversationClient() as client:
+    ...     conv = await client.create_conversation(user_id="u_001")
+    ...     # 一轮问答需要调用两次：一次 user，一次 assistant
+    ...     # user_id 是归属锚点，必须与创建时一致 (否则 404)
+    ...     await client.append_message(conv.conversation_id, "u_001", "user", "你好")
+    ...     await client.append_message(conv.conversation_id, "u_001", "assistant", "你好!")
+
+    同步版本 (不能在事件循环中调用):
+    >>> client = ConversationClient()
+    >>> conv = client.create_conversation_sync(user_id="u_001")
+    >>> client.append_message_sync(conv.conversation_id, "u_001", "user", "你好")
+
+范围说明:
+- 仅 agent 通道写操作 (创建会话 + 追加消息)。历史消息、会话列表等
+  读操作走用户通道 (user JWT)，由应用侧调用，不在 SDK 范围。
+- agentCode 由服务端从 API Key 推导，请求体不传 agentId；userId 是
+  归属锚点，追加时必传且须等于目标会话归属用户；appCode 可选一致性
+  声明，提供时透传。
+"""
+
+from wisruntime.conversation.client import ConversationClient
+from wisruntime.conversation.model import ConversationInfo, MessageInfo
+from wisruntime.conversation.recorder import ConversationRecorder
+
+__all__ = [
+    "ConversationClient",
+    "ConversationRecorder",
+    "ConversationInfo",
+    "MessageInfo",
+]