bazaar-compute-node 0.1.3__py3-none-any.whl

bazaar_compute_node/core/storage.py

@@ -0,0 +1,167 @@
+from __future__ import annotations
+
+from contextlib import AbstractAsyncContextManager
+from dataclasses import dataclass
+from typing import Protocol
+
+from .lifecycle import IAsyncLifecycle
+from .models import (
+    BcnSession,
+    ChannelSession,
+    ConsumerCursor,
+    InboundMessage,
+    OutboundMessage,
+    RuntimeAttempt,
+    RuntimeEvent,
+    RuntimeSession,
+)
+
+
+@dataclass(frozen=True, slots=True)
+class NodeIdentity:
+    """Stable node and shared workspace identity returned by storage."""
+
+    node_id: str
+    workspace_id: str
+
+    def __post_init__(self) -> None:
+        if not isinstance(self.node_id, str) or not self.node_id:
+            raise ValueError("node_id must be a non-empty string")
+        if not isinstance(self.workspace_id, str) or not self.workspace_id:
+            raise ValueError("workspace_id must be a non-empty string")
+
+
+class IStorageTransaction(Protocol):
+    """Explicit transaction boundary for repository operations.
+
+    A normal context exit commits. An exception, including cancellation,
+    rolls back. Implementations must not rely on implicit driver transactions
+    for cursor, fresh-check, or durable outcome transitions.
+    """
+
+    async def find_channel_session(
+        self,
+        *,
+        channel: str,
+        provider_thread_id: str,
+    ) -> ChannelSession | None:
+        """Find a channel session by provider-neutral identity fields."""
+        ...
+
+    async def get_channel_session(self, session_id: str) -> ChannelSession | None:
+        """Load one channel session by local id."""
+        ...
+
+    async def get_bcn_session(self, session_id: str) -> BcnSession | None:
+        """Load one bcn session by local id."""
+        ...
+
+    async def find_bcn_session(self, channel_session_id: str) -> BcnSession | None:
+        """Find the bcn session bound to one channel session for recovery."""
+        ...
+
+    async def get_runtime_session(self, session_id: str) -> RuntimeSession | None:
+        """Load one durable runtime binding by local id."""
+        ...
+
+    async def find_runtime_session(self, session_id: str) -> RuntimeSession | None:
+        """Find the runtime session bound to one bcn session for recovery."""
+        ...
+
+    async def get_runtime_attempt(self, turn_id: str) -> RuntimeAttempt | None:
+        """Load one immutable runtime attempt correlation record."""
+        ...
+
+    async def get_consumer_cursor(self, session_id: str) -> ConsumerCursor | None:
+        """Load the session-scoped delivery and inbox snapshot cursor."""
+        ...
+
+    async def get_latest_inbound_seq(self, session_id: str) -> int:
+        """Return zero when the session has no inbound messages."""
+        ...
+
+    async def find_inbound_message(
+        self,
+        channel: str,
+        provider_thread_id: str,
+        provider_message_id: str,
+    ) -> InboundMessage | None:
+        """Load the canonical inbound bound to one external message identity."""
+        ...
+
+    async def list_ready_attachment_paths(self) -> tuple[str, ...]:
+        """List workspace-relative paths retained by ready descriptors."""
+        ...
+
+    async def list_inbound_messages(
+        self,
+        session_id: str,
+        *,
+        after_seq: int | None = None,
+        target: str | None = None,
+        around_message_id: str | None = None,
+        notifying_only: bool = False,
+        limit: int = 100,
+    ) -> tuple[InboundMessage, ...]:
+        """Read messages without advancing the consumer cursor."""
+        ...
+
+    async def save_channel_session(self, session: ChannelSession) -> None:
+        """Persist a validated channel session binding update."""
+        ...
+
+    async def save_bcn_session(self, session: BcnSession) -> None:
+        """Persist a validated bcn session binding update."""
+        ...
+
+    async def save_runtime_session(self, session: RuntimeSession) -> None:
+        """Persist a validated runtime binding update."""
+        ...
+
+    async def save_runtime_attempt(self, attempt: RuntimeAttempt) -> None:
+        """Persist one immutable runtime attempt correlation record."""
+        ...
+
+    async def append_inbound_message(self, message: InboundMessage) -> InboundMessage:
+        """Append or deduplicate one inbound message and return its canonical row."""
+        ...
+
+    async def save_consumer_cursor(self, cursor: ConsumerCursor) -> None:
+        """Persist the session cursor and independent inbox snapshot."""
+        ...
+
+    async def get_outbound_message(
+        self, outbound_message_id: str
+    ) -> OutboundMessage | None:
+        """Load one outbound command attempt by local id."""
+        ...
+
+    async def save_outbound_message(self, message: OutboundMessage) -> OutboundMessage:
+        """Persist a draft or delivery transition and return its canonical row."""
+        ...
+
+    async def append_runtime_event(self, event: RuntimeEvent) -> RuntimeEvent:
+        """Append an operational event and return its canonical local sequence."""
+        ...
+
+
+class IStorage(IAsyncLifecycle, Protocol):
+    """Provider-neutral storage lifecycle and explicit transaction factory."""
+
+    @property
+    def name(self) -> str:
+        """Return the stable entry-point identity of this adapter."""
+        ...
+
+    async def initialize(
+        self,
+        *,
+        node_id: str | None = None,
+        workspace_id: str | None = None,
+    ) -> NodeIdentity:
+        """Load or create node identity after storage startup."""
+        ...
+
+    def transaction(self) -> AbstractAsyncContextManager[IStorageTransaction]:
+        """Open an explicit transaction owned by the caller."""
+        ...

bazaar_compute_node-0.1.3.dist-info/METADATA

@@ -0,0 +1,178 @@
+Metadata-Version: 2.4
+Name: bazaar-compute-node
+Version: 0.1.3
+Summary: Runtime-agnostic computer node daemon for agents and channels.
+License-Expression: AGPL-3.0-only
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.12.0
+Requires-Dist: aiosqlite>=0.20.0
+Requires-Dist: cryptography>=45.0.0
+Requires-Python: >=3.14
+Project-URL: Repository, https://github.com/yuchanns/bazaar-compute-node
+Description-Content-Type: text/markdown
+
+# Bazaar Compute Node
+
+Bazaar Compute Node（`bcn`）是一个可组合的 Agent 计算节点。用户通过 Channel 与
+Agent Runtime 沟通：Channel 提供输入任务和接收结果的界面，Runtime 是用户选择的 Agent
+Harness 工具。
+
+不同的 Channel 与 Runtime 可以自由组合和扩展，不绑定具体供应商或交互形态。
+
+## 核心能力
+
+- **自由组合**：根据使用场景分别选择 Channel 与 Runtime，并可独立替换和扩展。
+- **持续会话**：每个用户和对话拥有独立上下文，节点重启后仍可继续之前的任务。
+- **真实工作区**：Runtime 可以在独立工作区中分析、创建和修改文件，而不局限于文本回答。
+- **可靠交付**：自动处理长结果的分批发送并记录交付状态，避免任务结果静默丢失。
+- **安全边界**：复用所选 Harness 的权限机制，按任务需要控制文件与网络访问。
+- **跨平台运行**：支持 Linux、macOS 和 Windows，并以后台进程长期运行。
+
+## 当前支持
+
+当前版本提供首组可用组合：
+
+- **WeCom Channel**：通过企业微信与 Agent Runtime 持续沟通；
+- **Codex Runtime**：使用 Codex 作为 Agent Harness 工具完成任务。
+
+## Roadmap
+
+bcn 将沿着可组合的 Channel、Runtime 与节点通用能力继续扩展。
+
+### 更多 Harness
+
+- 一个节点允许添加多个 Agents
+- Agent Teams 合作
+
+### 更多 Channel
+
+- **Telegram**：通过 Telegram 与 Agent 交互。
+- **GitHub**: 通过 GitHub Issue 与 Agent Harness 进行开发。
+- **GitLab**: 将 Agent Harness 引入企业私有仓库与团队进行开发。
+
+### 更多 Runtime
+
+- **Claude Code**：支持选择 Claude Code 作为 Agent Harness；
+- **pi**：支持选择 pi 作为 Agent Harness。
+
+### 节点能力
+
+- **附件发送**：让 Agent 可以通过当前 Channel 交付生成的文件；
+- **定时任务**：创建一次性或周期性任务，由节点按计划自动执行并返回结果。
+
+## 安装
+
+项目通过 PyPI 分发，要求 Python 3.14 或更高版本：
+
+```bash
+uv tool install bazaar-compute-node
+bcn --version
+```
+
+升级到 PyPI 上的最新正式版本：
+
+```bash
+uv tool upgrade bazaar-compute-node
+```
+
+也可以直接从 GitHub 运行尚未发布的源码：
+
+```bash
+uvx --from 'git+https://github.com/yuchanns/bazaar-compute-node@main' bcn --version
+```
+
+生产环境建议将 `@main` 替换为固定 tag 或 commit，避免运行版本随分支更新。
+
+## Channel
+
+Channel 是用户输入任务、接收结果，并与 Agent Runtime 持续沟通的界面。启动节点时选择一种
+Channel 即可。
+
+### WeCom
+
+WeCom Channel 对接企业微信智能机器人，支持单聊、群聊、文本与媒体输入，以及 Markdown
+长消息分批返回。群聊中需要 @机器人，确保消息能够进入节点。
+
+在 `~/.bcn/config.toml` 中配置 Bot ID：
+
+```toml
+[channel.wecom]
+bot_id = "your-bot-id"
+```
+
+Bot Secret 不写入配置文件，只通过环境变量提供：
+
+```bash
+export BCN_WECOM_BOT_SECRET='your-bot-secret'
+```
+
+PowerShell：
+
+```powershell
+$env:BCN_WECOM_BOT_SECRET = 'your-bot-secret'
+```
+
+## Runtime
+
+Runtime 是用户选择的 Agent Harness 工具，用来运行 Agent 并完成任务。启动节点时选择一种
+Runtime 即可。
+
+### Codex
+
+使用 Codex Runtime 前，需要先安装并登录
+[Codex CLI](https://developers.openai.com/codex/cli/)。
+
+默认配置只允许 Codex 写入当前会话的工作区，并允许其命令访问网络：
+
+```toml
+[runtime]
+sandbox_mode = "workspace-write"
+network_access = true
+```
+
+如需覆盖 Codex 的默认模型或推理强度，可以在 `[runtime]` 中增加 `model` 和 `effort`。
+除非你明确需要使用运行用户已有的主机权限，否则不要将 `sandbox_mode` 改为
+`danger-full-access`。
+
+## 启动节点
+
+在 `~/.bcn/config.toml` 中选择要组合的 Channel 与 Runtime。以下配置使用当前已经落地的
+WeCom + Codex 组合：
+
+```toml
+[node]
+channel = "wecom"
+runtime = "codex"
+```
+
+启动后台节点：
+
+```bash
+uvx --from 'git+https://github.com/yuchanns/bazaar-compute-node@main' bcn start
+```
+
+也可以不创建配置文件，直接通过 `--channel`、`--runtime`、`--model`、`--effort`、
+`--sandbox-mode` 和 `--network-access` 等参数启动；命令行参数会覆盖配置文件中的对应值。
+
+## 常用操作
+
+```bash
+# Stop the background node gracefully.
+uvx --from 'git+https://github.com/yuchanns/bazaar-compute-node@main' bcn stop
+
+# Restart the node after changing configuration.
+uvx --from 'git+https://github.com/yuchanns/bazaar-compute-node@main' bcn restart
+
+# Inspect available options.
+uvx --from 'git+https://github.com/yuchanns/bazaar-compute-node@main' bcn --help
+```
+
+节点数据默认保存在 `~/.bcn`。停止节点会优雅关闭后台进程，不会删除既有会话、工作区或消息记录。
+
+## 许可证
+
+本项目使用 [GNU Affero General Public License v3.0](LICENSE)。
+
+## Credits
+
+本项目的协作模型与 Agent Runtime 设计受到 [Raft.build](https://raft.build) 的启发，谨此致谢。

bazaar_compute_node-0.1.3.dist-info/RECORD

@@ -0,0 +1,62 @@
+bazaar_compute_node/__init__.py,sha256=53_DJe-VLzgldmTJPdbNKASHyUPfkQ3reFXcjwSE3Vg,85
+bazaar_compute_node/app/__init__.py,sha256=KuBO8wDyz3JOTRwjA8eJ2pb8AX8B9R89Rr4beasY1-M,59
+bazaar_compute_node/app/application.py,sha256=9187ME_HN6kBD3OTVkC60xqYea-MbhsdsSl66YQEQgI,14985
+bazaar_compute_node/app/attachments.py,sha256=IIyFIKZbt7eeonkBCT_mME-TRZ4wggiCH1A6GgvtXE4,5964
+bazaar_compute_node/app/command.py,sha256=zy-y9vM9_nt5KSNXx1GwCYTjbbysRWG9NIeTY6qK6Po,12914
+bazaar_compute_node/app/config.py,sha256=ww6dGZfIuapUBkdAyn3B1cFlYIHqdao5ybAcI0y1hKs,4541
+bazaar_compute_node/app/registry.py,sha256=54aHCHiBCvHs99StWfETUCO25gbaG1A2exynCWZ5igA,4012
+bazaar_compute_node/app/transport.py,sha256=cGH0N5hnQKzartyTE8ALowlxjlDCZP3nGxfiYFK1en8,9002
+bazaar_compute_node/app/windows_pipe.py,sha256=qdl6tbhTHF8OQckrQfZAcy34LFdVzx5MCcGOsvLp9HY,14710
+bazaar_compute_node/app/wrapper.py,sha256=AOW47DBaJFEHZevQ0H5tP3smIaSB2ww246sDc_W8-88,1929
+bazaar_compute_node/bcc.py,sha256=SGaTWjcVKrdW3P1DyQyMf1_sbWBxExneFtOhPojRj14,18457
+bazaar_compute_node/cli.py,sha256=D310AaGWClXIXv3IRkFPQFas4RoPOiu5MyYkCM8kfmY,11870
+bazaar_compute_node/contrib/__init__.py,sha256=tbFhPuTl23h_TtraSOcCxne-Yq5CUrdQQioSw_IHH6s,63
+bazaar_compute_node/contrib/codex_app_server/__init__.py,sha256=_UMpu3gjG-IXWuMOaP-SnwPvilDRuB6ks5JntcNSWaE,1589
+bazaar_compute_node/contrib/codex_app_server/approval.py,sha256=2e9T_8X9SUMNjwsdJum9XLeY6KkdVx3TaS4n8siMrII,5493
+bazaar_compute_node/contrib/codex_app_server/client.py,sha256=aPxvlON-r21HbyYw1UE_Wx64UDh8XFfCuLjYNCfa_VA,12827
+bazaar_compute_node/contrib/codex_app_server/events.py,sha256=BpKlVWubunSjM3-tFJ_3EubWWSU0IpIYwaaVmXMqWEA,16278
+bazaar_compute_node/contrib/codex_app_server/plugin.py,sha256=aCoN3D49WSt2JrIm-D8ZQlBH1M1YYeHUQeRyqv7_Bv8,399
+bazaar_compute_node/contrib/codex_app_server/process.py,sha256=DdSMxPgXoy4um88dzUh3rTG6irmO2dmGyoZ1wvrhXVE,20794
+bazaar_compute_node/contrib/codex_app_server/protocol.py,sha256=JaViEGquWwp_SF_CMogJr-wbMgmUwJlRzZqWEMTMdJY,2902
+bazaar_compute_node/contrib/codex_app_server/runtime.py,sha256=IvOx_k04Op_OsFVyEaNRyJsj2JWE3iyEVcNNAr8tX2c,19616
+bazaar_compute_node/contrib/logging/__init__.py,sha256=gZnDXRjaAVFhRW7DAkFhfTOcwTHnQGE6aJ6HFG6WCUE,96
+bazaar_compute_node/contrib/logging/audit.py,sha256=gI7akvoFyElgydzF4fg9p4oEGE9KalDcKBQZye3Q6MI,2010
+bazaar_compute_node/contrib/logging/plugin.py,sha256=NfMxZq6o0nDnuFbzgl6WET-KQCq4HeZBgHfhHD_QrW0,196
+bazaar_compute_node/contrib/sqlite/__init__.py,sha256=xDxqVZo2RcZmtw1otNDsqiHe6UsbrA-LEf7pDNlfcZY,306
+bazaar_compute_node/contrib/sqlite/codec.py,sha256=eEesABKsW5rDE7GKgz_et5JCUJQ--hFi86DNcE2vPCI,30654
+bazaar_compute_node/contrib/sqlite/database.py,sha256=EhR_NJRjVpprV3bTY4Us8J-Kb5F2WrMWLJS0lUeIe9Q,9892
+bazaar_compute_node/contrib/sqlite/migrations.py,sha256=aFxQ6xosrJaGkGIvBe37pDRMQkL2eHiknD667eJ8zos,23757
+bazaar_compute_node/contrib/sqlite/plugin.py,sha256=wPrEpsf-ho2u5IF-NDGOtKs4onNWF9nF26DxfaR3W08,205
+bazaar_compute_node/contrib/sqlite/repository.py,sha256=m_A5gFw8uxsInubBUWpc3kK5EPuDvanjbRV04a4IJXk,45985
+bazaar_compute_node/contrib/wecom/__init__.py,sha256=oh81U9F7_tdJDjM1AJYvprUQOt2mV9zPf8-LCBGnnVU,45
+bazaar_compute_node/contrib/wecom/channel.py,sha256=0mtyQFsN8t_QjRLTJo2PChHZN7AHVT3v7U4zBrA-CXY,38197
+bazaar_compute_node/contrib/wecom/markdown.py,sha256=tNtk3BSe0QbJemK_m6TiA_FVlfpHUaIbIx9Ehdv7vTk,4897
+bazaar_compute_node/contrib/wecom/plugin.py,sha256=R3_tnzca8rEYJ6UJURKPC4vZJDbEpIS_rAwMMbAtAYk,924
+bazaar_compute_node/core/__init__.py,sha256=5hDdQN5MuoC8fSPUXgB06N9ZfWnrX367bym3ZKdiYgQ,212
+bazaar_compute_node/core/approval.py,sha256=WxSzdFUKybR0fMgbEbxFBr4gds7ehocx3NEDI5rl4vI,1762
+bazaar_compute_node/core/audit.py,sha256=EMlYMh7V01eOvD_P8rjkZpHD3Dyoh2z5KaSgTOkxBe8,3341
+bazaar_compute_node/core/channel.py,sha256=f7TdpJps43i7_1KgddTf0ylAEtW5rTqYRCtn7Bk9gz4,3752
+bazaar_compute_node/core/client.py,sha256=KYooK8OeIvHt4VX_EN2V7aTKbcQaGcAqTKw9GCDEqx8,887
+bazaar_compute_node/core/command.py,sha256=oZ2yec-u3UAAtFn9_RZpyb7aIj0Owmg57VsoOIZ_E2w,2752
+bazaar_compute_node/core/concurrency.py,sha256=viJx1CV3VFrY7tKD77iTActP8zdYokMhbaP4ja3rYcU,978
+bazaar_compute_node/core/correlation.py,sha256=c7CGd0TOJwsqYBSGAgIYYfM7ufu-aDn6Lk9_6ln3u_I,1906
+bazaar_compute_node/core/instruction.py,sha256=jP6ODinNBrhN6-Myt18D-gX8WKycHoh7CRmN4-Q0CVU,15242
+bazaar_compute_node/core/lifecycle.py,sha256=4wL9f_S-93Zsork6oevD_JhjkabYtHWWCIUhQFLvU64,1632
+bazaar_compute_node/core/models/__init__.py,sha256=wb9d_abZf9opn1uA1675YYVgDJBL6V_IF-KN5yYEsFQ,1295
+bazaar_compute_node/core/models/entities.py,sha256=0RhM0HZeutlwWUcVHMUOnwIvQOppe1AtsR3RbMhmcGM,18331
+bazaar_compute_node/core/models/states.py,sha256=_R93vVuMzleW-ujFXBeCQRFRIPZEubDZw16Z7pec1Es,13156
+bazaar_compute_node/core/observability.py,sha256=Kom3d2FXnaJe61gDjxpnT7Zz1utjCVqQjPz_XiL_YdU,1226
+bazaar_compute_node/core/orchestration/__init__.py,sha256=o55opZI-vkesm-ziZD6gZQY7tj3tnI6nwcre5ygq2mQ,151
+bazaar_compute_node/core/orchestration/command.py,sha256=SezMU3VpTcnsqlfOTwAaJ2PGamdCjr413VtzLz68IhU,26860
+bazaar_compute_node/core/orchestration/services.py,sha256=azjLc7_4nmmxrG7uVYvJyWpPDcUv6dM-YTxBoHaLQcY,4147
+bazaar_compute_node/core/orchestration/session.py,sha256=AAt_FVla6LnA4pt0VUSFzJO-lK57N9l11mQRGK_XqG0,35858
+bazaar_compute_node/core/orchestration/turn.py,sha256=-aSHeMsrB_70gRCyPxSN0IdH8mqzgchDknuCWCqEFD0,17968
+bazaar_compute_node/core/outcomes.py,sha256=QecTXJ0QZ33J3ton9Xalp-NH4zQ_sBRPSFDnZcqSwIc,1741
+bazaar_compute_node/core/paths.py,sha256=3_szH8NVEKI1KAmLxM2wBI_XCIoFDWzEmBB0T3uHP6w,555
+bazaar_compute_node/core/runtime.py,sha256=hX_41WlwqdzHAYgMktSctPozR58bSRNlaigHgEaG1eo,3885
+bazaar_compute_node/core/storage.py,sha256=V1sUpKZVrd0aX-Nbkb8DWKRK624nlKirvni09s9NOIQ,5619
+bazaar_compute_node-0.1.3.dist-info/licenses/LICENSE,sha256=ux8a5pM2QVuZCxl-4Fiu9LkvMdwCxa0qQ1jvGWDzi-4,33876
+bazaar_compute_node-0.1.3.dist-info/WHEEL,sha256=q9Wah2_CgP24mRNSlTyb0F8Yrbz55SzVl8eHLkZ_wvE,80
+bazaar_compute_node-0.1.3.dist-info/entry_points.txt,sha256=Bzzi72277-1aui_xVQVVj1mQjEyoo-oR37nL_zIvkU8,451
+bazaar_compute_node-0.1.3.dist-info/METADATA,sha256=41steq9Dp11Rw3qOmKfMtDf8zprW2tfl7EzK0Mxj9uQ,5522
+bazaar_compute_node-0.1.3.dist-info/RECORD,,

bazaar_compute_node-0.1.3.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.12.2
+Root-Is-Purelib: true
+Tag: py3-none-any

bazaar_compute_node-0.1.3.dist-info/entry_points.txt

@@ -0,0 +1,15 @@
+[console_scripts]
+bcn = bazaar_compute_node.cli:main
+
+[bazaar_compute_node.audits]
+logging = bazaar_compute_node.contrib.logging.plugin:create_audit
+
+[bazaar_compute_node.channels]
+wecom = bazaar_compute_node.contrib.wecom.plugin:create_channel
+
+[bazaar_compute_node.runtimes]
+codex = bazaar_compute_node.contrib.codex_app_server.plugin:create_runtime
+
+[bazaar_compute_node.storages]
+sqlite = bazaar_compute_node.contrib.sqlite.plugin:create_storage
+