agno-lark 0.1.0__tar.gz

agno_lark-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 agno-lark contributors
+
+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.

agno_lark-0.1.0/PKG-INFO

@@ -0,0 +1,251 @@
+Metadata-Version: 2.3
+Name: agno-lark
+Version: 0.1.0
+Summary: A lightweight Python bridge between Lark/Feishu and Agno AgentOS.
+Keywords: agno,agentos,lark,feishu,im,websocket
+Author: _白开水_
+Author-email: _白开水_ <pkk518@gmail.com>
+License: MIT License
+         
+         Copyright (c) 2026 agno-lark contributors
+         
+         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.
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: agno[os]>=3.1,<4
+Requires-Dist: aiosqlite>=0.20,<1
+Requires-Dist: httpx[socks]>=0.28,<1
+Requires-Dist: lark-channel-sdk>=1.4,<2
+Requires-Dist: pydantic-settings>=2.6,<3
+Requires-Python: >=3.12, <4
+Project-URL: Homepage, https://github.com/pangkk18/agno-lark
+Project-URL: Repository, https://github.com/pangkk18/agno-lark
+Project-URL: Issues, https://github.com/pangkk18/agno-lark/issues
+Description-Content-Type: text/markdown
+
+# agno-lark
+
+A lightweight Python bridge between Lark/Feishu IM and Agno AgentOS.
+
+`agno-lark` (import package: `agno_lark`) runs as an independent bridge process. It uses the official `lark-channel-sdk` WebSocket channel to receive Lark/Feishu messages, forwards them to an AgentOS agent, team, or workflow, and stores deduplication, session generations, and run records in SQLite.
+
+```mermaid
+flowchart LR
+    U[Lark/Feishu user] --> C[FeishuChannel\nWebSocket]
+    C --> B[agno-lark\nLarkInterface]
+    B --> S[(SQLite\ndedup / sessions / runs)]
+    B --> A[AgentOS\nagent / team / workflow]
+    A --> B
+    B --> C
+```
+
+The Chinese documentation is available in [`READM_ZH.md`](READM_ZH.md).
+
+## Features
+
+- Persistent Lark/Feishu WebSocket connection; HTTP webhook mode is not required.
+- Direct messages and group messages that mention the bot.
+- Text replies, image resources, and file resources converted to Agno media objects.
+- Remote AgentOS targets for `agent`, `team`, and `workflow`.
+- User, chat, and thread session isolation with `/new` generation resets.
+- Configurable group context:
+  - `user` (default): each member who mentions the bot gets an independent context.
+  - `shared`: members share one context for the same chat and thread.
+- SQLite message deduplication, run records, TTL cleanup, WAL, and busy-timeout handling.
+- Streaming Feishu cards with status, run ID, elapsed time, and cancellation actions.
+- `/new`, `/status`, `/cancel [run_id]`, and `/help` commands.
+- User and chat allowlists, reconnect handling, error handling, and structured logging.
+
+The first release does not process audio, video, or voice messages and does not implement HITL resume approval. Long-running tasks use foreground SSE streaming.
+
+## Requirements and installation
+
+Python 3.12 or newer (and lower than 4.0) is required. [uv](https://docs.astral.sh/uv/) is recommended:
+
+```bash
+uv sync
+cp .env.example .env
+```
+
+After the first PyPI release, install the published package in an existing project with either:
+
+```bash
+uv add agno-lark
+# or
+python -m pip install agno-lark
+```
+
+The distribution name uses a hyphen (`agno-lark`), while Python imports use an underscore:
+
+```python
+from agno_lark import LarkInterface, build_remote_target, load_settings
+```
+
+The package also installs the `agno-lark` command. After installation, run the bridge with:
+
+```bash
+agno-lark --help
+agno-lark
+```
+
+## Create the Lark/Feishu application
+
+Create an enterprise application in the Lark or Feishu Open Platform and enable bot capabilities. Record the App ID (`cli_...`) and App Secret. Select the long connection (WebSocket) mode in event subscriptions and subscribe to message events. Grant the permissions required to receive and send messages, read image/file resources, and send card messages. Publish the application and add the bot to the target chats.
+
+The official Channel SDK handles the WebSocket connection, event normalization, resource downloads, deduplication, and card callbacks. This project does not require a separate webhook endpoint.
+
+## Configuration
+
+Copy `.env.example` and fill in the values below. The `FEISHU_*` prefix is retained for compatibility with existing Lark/Feishu application configuration; the distribution and import names are `agno-lark` and `agno_lark`.
+
+```dotenv
+FEISHU_APP_ID=cli_xxx
+FEISHU_APP_SECRET=xxx
+
+AGENTOS_URL=http://127.0.0.1:7777
+AGENTOS_TOKEN=xxx
+AGENTOS_TARGET_TYPE=agent
+AGENTOS_TARGET_ID=assistant
+# Legacy alias for an agent target:
+# AGENTOS_AGENT_ID=assistant
+
+FEISHU_STATE_DB=.data/agno-feishu.sqlite3
+FEISHU_ALLOWED_USER_IDS=
+FEISHU_ALLOWED_CHAT_IDS=
+# user (default: one context per member) or shared (one context per chat/thread)
+FEISHU_GROUP_SESSION_MODE=user
+
+BRIDGE_HOST=127.0.0.1
+BRIDGE_PORT=7788
+```
+
+Allowlist values are comma-separated. If both allowlists are empty, access is open; production deployments should configure at least one allowlist. `AGENTOS_TOKEN` may be empty for a public AgentOS, but a Bearer token is recommended for production.
+
+`FEISHU_GROUP_SESSION_MODE` affects group chats only. In `user` mode, the scope includes `sender.open_id`; in `shared` mode, the scope includes the chat and thread but not the sender. Direct messages are always isolated by their direct-message chat. The default SQLite filename remains `.data/agno-feishu.sqlite3` so existing state data can be reused.
+
+## Quick start with a remote AgentOS
+
+Start AgentOS at `AGENTOS_URL`, then run the bridge:
+
+```bash
+uv run agno-lark
+uv run agno-lark --host 0.0.0.0 --port 7788
+```
+
+The bridge creates a `RemoteAgent`, `RemoteTeam`, or `RemoteWorkflow` from `AGENTOS_TARGET_TYPE` and mounts the Lark/Feishu interface into the local AgentOS gateway. The status endpoint is `GET /feishu/status`; this path is retained for compatibility with existing deployments.
+
+## Embed in an existing AgentOS application
+
+```python
+from agno.os import AgentOS
+from agno_lark import LarkInterface, build_remote_target, load_settings
+
+settings = load_settings()
+target = build_remote_target(settings)
+lark = LarkInterface(target=target, settings=settings)
+
+agent_os = AgentOS(
+    agents=[target] if settings.target_type == "agent" else None,
+    teams=[target] if settings.target_type == "team" else None,
+    workflows=[target] if settings.target_type == "workflow" else None,
+    interfaces=[lark],
+)
+app = agent_os.get_app()
+```
+
+`LarkInterface.get_router()` returns a FastAPI `APIRouter` with a managed lifespan. Startup opens the SQLite store and connects `FeishuChannel`; shutdown disconnects the channel and closes the store. Only the asynchronous AgentOS execution path is supported. `FeishuInterface` remains exported as a compatibility alias.
+
+## Messages, sessions, and commands
+
+- Direct messages are handled immediately; group messages must mention the bot.
+- `user_id` is taken from `sender.open_id`.
+- In the default `user` group mode, a scope can look like `feishu:agent:assistant:chat_oc_xxx:thread_omt_xxx:user:ou_xxx:v3`.
+- In `shared` group mode, the same chat/thread uses a scope such as `feishu:agent:assistant:chat_oc_xxx:thread_omt_xxx:v3` for every member, while each AgentOS run still receives the sender's `user_id`.
+- `/new` increments the generation for the current user scope or shared chat/thread scope.
+
+| Command | Behavior |
+| --- | --- |
+| `/new` | Increment the current scope generation and start a fresh session. |
+| `/status` | Show active and recent runs for the current scope. |
+| `/cancel` | Cancel the most recent active run for the current scope. |
+| `/cancel <run_id>` | Request cancellation of a specific run. |
+| `/help` | Show the command help card. |
+
+Cancellation first records `cancel_requested` and then calls the scoped AgentOS cancel endpoint. The final state comes from the SSE terminal event. Card actions re-check the operator and chat allowlists before starting status or cancellation work.
+
+## State database and troubleshooting
+
+The default database `.data/agno-feishu.sqlite3` uses WAL and a busy timeout. It contains `schema_version`, `dedup_messages`, `session_scopes`, and `runs`. Message deduplication defaults to 24 hours and run records are retained for 7 days.
+
+If no messages arrive, check application publication, WebSocket subscriptions, bot membership, and allowlists. For 401/403 responses, check the AgentOS token, target ID, and AgentOS authorization. For resource failures, check Lark/Feishu resource-read permissions. Logs do not include the App Secret, AgentOS token, raw file contents, or complete user messages.
+
+If your shell exports a SOCKS proxy and the local environment does not have `socksio`, set `NO_PROXY=127.0.0.1,localhost` (and the AgentOS hostname) when testing a local AgentOS. If outbound AgentOS requests must use a SOCKS proxy, install the HTTPX SOCKS extra in the deployment environment with `uv pip install "httpx[socks]>=0.28,<1"`.
+
+## Development
+
+```bash
+uv sync
+uv run pytest
+uv run ruff check .
+uv run mypy src
+uv build
+uv run agno-lark --help
+```
+
+Tests use fake Channel and Agno targets plus `httpx` mocks; they do not contact Lark/Feishu or AgentOS. See [`examples/agent_os_remote.py`](examples/agent_os_remote.py) for the remote integration example.
+
+## Release and publish
+
+The package will be published to [PyPI](https://pypi.org/project/agno-lark/) as `agno-lark`. Every release version must be unique. Update `version` in `pyproject.toml`, then run the local checks and build:
+
+```bash
+uv lock
+uv sync --locked
+uv run pytest
+uv run ruff check .
+uv run mypy src
+uv build
+```
+
+For a first release or a manual release, create a PyPI API token and publish without putting the token in the repository or shell history:
+
+```bash
+export UV_PUBLISH_TOKEN='pypi-...'
+uv publish
+```
+
+To verify a release on TestPyPI first, use a TestPyPI token and the TestPyPI upload endpoint:
+
+```bash
+export UV_PUBLISH_TOKEN='pypi-...'
+uv publish --publish-url https://test.pypi.org/legacy/
+uv pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ agno-lark
+```
+
+This repository also includes a GitHub Actions workflow for PyPI Trusted Publishing. Configure the GitHub repository as a trusted publisher for the `agno-lark` project on PyPI, then push a tag such as `v0.1.0`; the workflow builds and publishes without a long-lived PyPI token.
+
+## License
+
+This project is released under the MIT License. See [`LICENSE`](LICENSE).

agno_lark-0.1.0/README.md

@@ -0,0 +1,204 @@
+# agno-lark
+
+A lightweight Python bridge between Lark/Feishu IM and Agno AgentOS.
+
+`agno-lark` (import package: `agno_lark`) runs as an independent bridge process. It uses the official `lark-channel-sdk` WebSocket channel to receive Lark/Feishu messages, forwards them to an AgentOS agent, team, or workflow, and stores deduplication, session generations, and run records in SQLite.
+
+```mermaid
+flowchart LR
+    U[Lark/Feishu user] --> C[FeishuChannel\nWebSocket]
+    C --> B[agno-lark\nLarkInterface]
+    B --> S[(SQLite\ndedup / sessions / runs)]
+    B --> A[AgentOS\nagent / team / workflow]
+    A --> B
+    B --> C
+```
+
+The Chinese documentation is available in [`READM_ZH.md`](READM_ZH.md).
+
+## Features
+
+- Persistent Lark/Feishu WebSocket connection; HTTP webhook mode is not required.
+- Direct messages and group messages that mention the bot.
+- Text replies, image resources, and file resources converted to Agno media objects.
+- Remote AgentOS targets for `agent`, `team`, and `workflow`.
+- User, chat, and thread session isolation with `/new` generation resets.
+- Configurable group context:
+  - `user` (default): each member who mentions the bot gets an independent context.
+  - `shared`: members share one context for the same chat and thread.
+- SQLite message deduplication, run records, TTL cleanup, WAL, and busy-timeout handling.
+- Streaming Feishu cards with status, run ID, elapsed time, and cancellation actions.
+- `/new`, `/status`, `/cancel [run_id]`, and `/help` commands.
+- User and chat allowlists, reconnect handling, error handling, and structured logging.
+
+The first release does not process audio, video, or voice messages and does not implement HITL resume approval. Long-running tasks use foreground SSE streaming.
+
+## Requirements and installation
+
+Python 3.12 or newer (and lower than 4.0) is required. [uv](https://docs.astral.sh/uv/) is recommended:
+
+```bash
+uv sync
+cp .env.example .env
+```
+
+After the first PyPI release, install the published package in an existing project with either:
+
+```bash
+uv add agno-lark
+# or
+python -m pip install agno-lark
+```
+
+The distribution name uses a hyphen (`agno-lark`), while Python imports use an underscore:
+
+```python
+from agno_lark import LarkInterface, build_remote_target, load_settings
+```
+
+The package also installs the `agno-lark` command. After installation, run the bridge with:
+
+```bash
+agno-lark --help
+agno-lark
+```
+
+## Create the Lark/Feishu application
+
+Create an enterprise application in the Lark or Feishu Open Platform and enable bot capabilities. Record the App ID (`cli_...`) and App Secret. Select the long connection (WebSocket) mode in event subscriptions and subscribe to message events. Grant the permissions required to receive and send messages, read image/file resources, and send card messages. Publish the application and add the bot to the target chats.
+
+The official Channel SDK handles the WebSocket connection, event normalization, resource downloads, deduplication, and card callbacks. This project does not require a separate webhook endpoint.
+
+## Configuration
+
+Copy `.env.example` and fill in the values below. The `FEISHU_*` prefix is retained for compatibility with existing Lark/Feishu application configuration; the distribution and import names are `agno-lark` and `agno_lark`.
+
+```dotenv
+FEISHU_APP_ID=cli_xxx
+FEISHU_APP_SECRET=xxx
+
+AGENTOS_URL=http://127.0.0.1:7777
+AGENTOS_TOKEN=xxx
+AGENTOS_TARGET_TYPE=agent
+AGENTOS_TARGET_ID=assistant
+# Legacy alias for an agent target:
+# AGENTOS_AGENT_ID=assistant
+
+FEISHU_STATE_DB=.data/agno-feishu.sqlite3
+FEISHU_ALLOWED_USER_IDS=
+FEISHU_ALLOWED_CHAT_IDS=
+# user (default: one context per member) or shared (one context per chat/thread)
+FEISHU_GROUP_SESSION_MODE=user
+
+BRIDGE_HOST=127.0.0.1
+BRIDGE_PORT=7788
+```
+
+Allowlist values are comma-separated. If both allowlists are empty, access is open; production deployments should configure at least one allowlist. `AGENTOS_TOKEN` may be empty for a public AgentOS, but a Bearer token is recommended for production.
+
+`FEISHU_GROUP_SESSION_MODE` affects group chats only. In `user` mode, the scope includes `sender.open_id`; in `shared` mode, the scope includes the chat and thread but not the sender. Direct messages are always isolated by their direct-message chat. The default SQLite filename remains `.data/agno-feishu.sqlite3` so existing state data can be reused.
+
+## Quick start with a remote AgentOS
+
+Start AgentOS at `AGENTOS_URL`, then run the bridge:
+
+```bash
+uv run agno-lark
+uv run agno-lark --host 0.0.0.0 --port 7788
+```
+
+The bridge creates a `RemoteAgent`, `RemoteTeam`, or `RemoteWorkflow` from `AGENTOS_TARGET_TYPE` and mounts the Lark/Feishu interface into the local AgentOS gateway. The status endpoint is `GET /feishu/status`; this path is retained for compatibility with existing deployments.
+
+## Embed in an existing AgentOS application
+
+```python
+from agno.os import AgentOS
+from agno_lark import LarkInterface, build_remote_target, load_settings
+
+settings = load_settings()
+target = build_remote_target(settings)
+lark = LarkInterface(target=target, settings=settings)
+
+agent_os = AgentOS(
+    agents=[target] if settings.target_type == "agent" else None,
+    teams=[target] if settings.target_type == "team" else None,
+    workflows=[target] if settings.target_type == "workflow" else None,
+    interfaces=[lark],
+)
+app = agent_os.get_app()
+```
+
+`LarkInterface.get_router()` returns a FastAPI `APIRouter` with a managed lifespan. Startup opens the SQLite store and connects `FeishuChannel`; shutdown disconnects the channel and closes the store. Only the asynchronous AgentOS execution path is supported. `FeishuInterface` remains exported as a compatibility alias.
+
+## Messages, sessions, and commands
+
+- Direct messages are handled immediately; group messages must mention the bot.
+- `user_id` is taken from `sender.open_id`.
+- In the default `user` group mode, a scope can look like `feishu:agent:assistant:chat_oc_xxx:thread_omt_xxx:user:ou_xxx:v3`.
+- In `shared` group mode, the same chat/thread uses a scope such as `feishu:agent:assistant:chat_oc_xxx:thread_omt_xxx:v3` for every member, while each AgentOS run still receives the sender's `user_id`.
+- `/new` increments the generation for the current user scope or shared chat/thread scope.
+
+| Command | Behavior |
+| --- | --- |
+| `/new` | Increment the current scope generation and start a fresh session. |
+| `/status` | Show active and recent runs for the current scope. |
+| `/cancel` | Cancel the most recent active run for the current scope. |
+| `/cancel <run_id>` | Request cancellation of a specific run. |
+| `/help` | Show the command help card. |
+
+Cancellation first records `cancel_requested` and then calls the scoped AgentOS cancel endpoint. The final state comes from the SSE terminal event. Card actions re-check the operator and chat allowlists before starting status or cancellation work.
+
+## State database and troubleshooting
+
+The default database `.data/agno-feishu.sqlite3` uses WAL and a busy timeout. It contains `schema_version`, `dedup_messages`, `session_scopes`, and `runs`. Message deduplication defaults to 24 hours and run records are retained for 7 days.
+
+If no messages arrive, check application publication, WebSocket subscriptions, bot membership, and allowlists. For 401/403 responses, check the AgentOS token, target ID, and AgentOS authorization. For resource failures, check Lark/Feishu resource-read permissions. Logs do not include the App Secret, AgentOS token, raw file contents, or complete user messages.
+
+If your shell exports a SOCKS proxy and the local environment does not have `socksio`, set `NO_PROXY=127.0.0.1,localhost` (and the AgentOS hostname) when testing a local AgentOS. If outbound AgentOS requests must use a SOCKS proxy, install the HTTPX SOCKS extra in the deployment environment with `uv pip install "httpx[socks]>=0.28,<1"`.
+
+## Development
+
+```bash
+uv sync
+uv run pytest
+uv run ruff check .
+uv run mypy src
+uv build
+uv run agno-lark --help
+```
+
+Tests use fake Channel and Agno targets plus `httpx` mocks; they do not contact Lark/Feishu or AgentOS. See [`examples/agent_os_remote.py`](examples/agent_os_remote.py) for the remote integration example.
+
+## Release and publish
+
+The package will be published to [PyPI](https://pypi.org/project/agno-lark/) as `agno-lark`. Every release version must be unique. Update `version` in `pyproject.toml`, then run the local checks and build:
+
+```bash
+uv lock
+uv sync --locked
+uv run pytest
+uv run ruff check .
+uv run mypy src
+uv build
+```
+
+For a first release or a manual release, create a PyPI API token and publish without putting the token in the repository or shell history:
+
+```bash
+export UV_PUBLISH_TOKEN='pypi-...'
+uv publish
+```
+
+To verify a release on TestPyPI first, use a TestPyPI token and the TestPyPI upload endpoint:
+
+```bash
+export UV_PUBLISH_TOKEN='pypi-...'
+uv publish --publish-url https://test.pypi.org/legacy/
+uv pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ agno-lark
+```
+
+This repository also includes a GitHub Actions workflow for PyPI Trusted Publishing. Configure the GitHub repository as a trusted publisher for the `agno-lark` project on PyPI, then push a tag such as `v0.1.0`; the workflow builds and publishes without a long-lived PyPI token.
+
+## License
+
+This project is released under the MIT License. See [`LICENSE`](LICENSE).

agno_lark-0.1.0/pyproject.toml

@@ -0,0 +1,82 @@
+[project]
+name = "agno-lark"
+version = "0.1.0"
+description = "A lightweight Python bridge between Lark/Feishu and Agno AgentOS."
+readme = "README.md"
+keywords = [
+    "agno",
+    "agentos",
+    "lark",
+    "feishu",
+    "im",
+    "websocket",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Communications :: Chat",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+requires-python = ">=3.12,<4"
+dependencies = [
+    "agno[os]>=3.1,<4",
+    "aiosqlite>=0.20,<1",
+    "httpx[socks]>=0.28,<1",
+    "lark-channel-sdk>=1.4,<2",
+    "pydantic-settings>=2.6,<3",
+]
+
+[[project.authors]]
+name = "_白开水_"
+email = "pkk518@gmail.com"
+
+[project.license]
+file = "LICENSE"
+
+[project.scripts]
+agno-lark = "agno_lark.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/pangkk18/agno-lark"
+Repository = "https://github.com/pangkk18/agno-lark"
+Issues = "https://github.com/pangkk18/agno-lark/issues"
+
+[build-system]
+requires = ["uv_build>=0.13.1,<0.14.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "mypy>=1.15,<2",
+    "pytest>=8.3,<9",
+    "pytest-asyncio>=0.25,<1",
+    "respx>=0.22,<1",
+    "ruff>=0.9,<1",
+]
+
+[tool.pytest.ini_options]
+addopts = "-q"
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "I",
+    "UP",
+    "B",
+]
+
+[tool.mypy]
+python_version = "3.12"
+strict = true
+files = ["src"]

agno_lark-0.1.0/pyproject.toml.orig

@@ -0,0 +1,66 @@
+[project]
+name = "agno-lark"
+version = "0.1.0"
+description = "A lightweight Python bridge between Lark/Feishu and Agno AgentOS."
+readme = "README.md"
+authors = [
+    { name = "_白开水_", email = "pkk518@gmail.com" }
+]
+license = { file = "LICENSE" }
+keywords = ["agno", "agentos", "lark", "feishu", "im", "websocket"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Communications :: Chat",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+requires-python = ">=3.12,<4"
+dependencies = [
+    "agno[os]>=3.1,<4",
+    "aiosqlite>=0.20,<1",
+    "httpx[socks]>=0.28,<1",
+    "lark-channel-sdk>=1.4,<2",
+    "pydantic-settings>=2.6,<3",
+]
+
+[build-system]
+requires = ["uv_build>=0.13.1,<0.14.0"]
+build-backend = "uv_build"
+
+[project.scripts]
+agno-lark = "agno_lark.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/pangkk18/agno-lark"
+Repository = "https://github.com/pangkk18/agno-lark"
+Issues = "https://github.com/pangkk18/agno-lark/issues"
+
+[dependency-groups]
+dev = [
+    "mypy>=1.15,<2",
+    "pytest>=8.3,<9",
+    "pytest-asyncio>=0.25,<1",
+    "respx>=0.22,<1",
+    "ruff>=0.9,<1",
+]
+
+[tool.pytest.ini_options]
+addopts = "-q"
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]
+
+[tool.mypy]
+python_version = "3.12"
+strict = true
+files = ["src"]

agno_lark-0.1.0/src/agno_lark/__init__.py

@@ -0,0 +1,28 @@
+"""Lark/Feishu bridge for Agno AgentOS."""
+
+from .app import create_app
+from .bridge import FeishuBridge, LarkBridge
+from .config import FeishuSettings, LarkSettings, load_settings
+from .interface import FeishuInterface, LarkInterface
+from .session import make_scope_key, make_session_id
+from .state import RunRecord, SqliteStateStore
+from .target import TargetDescriptor, build_remote_target
+
+__all__ = [
+    "LarkInterface",
+    "FeishuInterface",
+    "LarkBridge",
+    "FeishuBridge",
+    "LarkSettings",
+    "FeishuSettings",
+    "RunRecord",
+    "SqliteStateStore",
+    "TargetDescriptor",
+    "build_remote_target",
+    "create_app",
+    "load_settings",
+    "make_scope_key",
+    "make_session_id",
+]
+
+__version__ = "0.1.0"