pocket-coding 0.2.1__tar.gz → 0.3.0__tar.gz

pocket_coding-0.3.0/PKG-INFO

@@ -0,0 +1,129 @@
+Metadata-Version: 2.4
+Name: pocket-coding
+Version: 0.3.0
+Summary: PoCo: Pocket Coding for Feishu
+Author: PoCo contributors
+Keywords: bot,codex,feishu,lark,tui
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.11
+Requires-Dist: lark-oapi==1.5.3
+Requires-Dist: textual<1,>=0.75
+Description-Content-Type: text/markdown
+
+# PoCo
+
+[中文说明](README.zh-CN.md)
+
+**PoCo** (Pocket-Coding) is a bot runtime that connects different coding agents to workplace chat software.
+
+It currently supports Codex, Claude Code, and Feishu bots.
+
+## Quick Start
+
+See [Quick Start](docs/quickstart.md).
+
+## How It Works
+
+- DM with the bot: management console
+- Group chat with the bot: project workspace
+- Each project group gets its own worker process
+- Each project is configured from the DM console card
+- PoCo uses Feishu long-connection mode, so no public callback URL is required
+
+## Usage
+
+DM console:
+
+- send `poco`
+- use the card UI to create a project and manage projects
+
+Project group:
+
+- just talk to the agent
+- if you want to send an image, send one Feishu post message that contains both the image and the text prompt
+
+## Provider
+
+- `codex`: fully implemented through `codex app-server`
+- `claude`: implemented through the Claude Code CLI with streamed JSON output
+
+Current provider notes:
+
+- Codex is the default runtime path
+- Claude currently supports session attach, image input, and streamed replies
+
+## TUI
+
+The TUI is a two-panel terminal UI:
+
+- left panel: logo and runtime summary
+- right panel: the current interaction panel
+- bottom: an input line that is only enabled when a config field needs text input
+
+Shortcuts:
+
+- `Ctrl+R`: Save and restart
+- `q`: go back one level
+- `↑ / ↓`: move in the main menu or config menu
+- `Enter`: open the selected item
+- `Esc`: go back one level
+
+The default home screen is menu-driven:
+
+- the right panel shows:
+  - `Agent & Model`
+  - `Bot (feishu)`
+  - `PoCo`
+  - `Language`
+  - `Quit`
+- use `↑ / ↓` to select an item
+- press `Enter` to open it
+
+Top-level items open their config sections directly:
+
+- the right panel turns into a selection menu
+- `↑ / ↓` moves between sections or fields
+- `Enter` opens the current selection
+- `Esc` returns to the previous level
+- `Language` lets you switch between English and Chinese
+- `Bot (feishu)` contains Feishu settings such as `App ID` and `App Secret`
+- `Agent & Model` contains `codex` and `claude`
+- `claude` opens a provider menu first
+- choose a provider such as `anthropic`, `minimax`, `deepseek`, or `kimi`
+- then edit that provider's `base_url`, `auth_token`, `model`, and `extra_env`
+- `model` opens another menu; pick a model first, then run `set_as_default`
+- `extra_env` also opens a submenu; manage env entries one by one instead of editing raw JSON
+- `show` opens the current config in a scrollable view
+- the bottom input line is only active while editing a text field
+
+## Files
+
+- Workspace bindings: `~/.config/poco/workspaces.json`
+- Per-bot config file: `~/.config/poco/bindings/<app_id>/config.json`
+- Per-bot state directory: `~/.local/state/poco/<app_id>/`
+- Legacy default config/state are still under:
+  - `~/.config/poco/config.json`
+  - `~/.local/state/poco/`
+
+## Development
+
+Build packages:
+
+```bash
+uv build
+```
+
+Quick syntax check:
+
+```bash
+uv run python -m py_compile poco/__init__.py poco/app.py poco/runtime.py poco/relay/app.py poco/config/store.py poco/tui/app.py
+```

pocket_coding-0.3.0/README.md

@@ -0,0 +1,108 @@
+# PoCo
+
+[中文说明](README.zh-CN.md)
+
+**PoCo** (Pocket-Coding) is a bot runtime that connects different coding agents to workplace chat software.
+
+It currently supports Codex, Claude Code, and Feishu bots.
+
+## Quick Start
+
+See [Quick Start](docs/quickstart.md).
+
+## How It Works
+
+- DM with the bot: management console
+- Group chat with the bot: project workspace
+- Each project group gets its own worker process
+- Each project is configured from the DM console card
+- PoCo uses Feishu long-connection mode, so no public callback URL is required
+
+## Usage
+
+DM console:
+
+- send `poco`
+- use the card UI to create a project and manage projects
+
+Project group:
+
+- just talk to the agent
+- if you want to send an image, send one Feishu post message that contains both the image and the text prompt
+
+## Provider
+
+- `codex`: fully implemented through `codex app-server`
+- `claude`: implemented through the Claude Code CLI with streamed JSON output
+
+Current provider notes:
+
+- Codex is the default runtime path
+- Claude currently supports session attach, image input, and streamed replies
+
+## TUI
+
+The TUI is a two-panel terminal UI:
+
+- left panel: logo and runtime summary
+- right panel: the current interaction panel
+- bottom: an input line that is only enabled when a config field needs text input
+
+Shortcuts:
+
+- `Ctrl+R`: Save and restart
+- `q`: go back one level
+- `↑ / ↓`: move in the main menu or config menu
+- `Enter`: open the selected item
+- `Esc`: go back one level
+
+The default home screen is menu-driven:
+
+- the right panel shows:
+  - `Agent & Model`
+  - `Bot (feishu)`
+  - `PoCo`
+  - `Language`
+  - `Quit`
+- use `↑ / ↓` to select an item
+- press `Enter` to open it
+
+Top-level items open their config sections directly:
+
+- the right panel turns into a selection menu
+- `↑ / ↓` moves between sections or fields
+- `Enter` opens the current selection
+- `Esc` returns to the previous level
+- `Language` lets you switch between English and Chinese
+- `Bot (feishu)` contains Feishu settings such as `App ID` and `App Secret`
+- `Agent & Model` contains `codex` and `claude`
+- `claude` opens a provider menu first
+- choose a provider such as `anthropic`, `minimax`, `deepseek`, or `kimi`
+- then edit that provider's `base_url`, `auth_token`, `model`, and `extra_env`
+- `model` opens another menu; pick a model first, then run `set_as_default`
+- `extra_env` also opens a submenu; manage env entries one by one instead of editing raw JSON
+- `show` opens the current config in a scrollable view
+- the bottom input line is only active while editing a text field
+
+## Files
+
+- Workspace bindings: `~/.config/poco/workspaces.json`
+- Per-bot config file: `~/.config/poco/bindings/<app_id>/config.json`
+- Per-bot state directory: `~/.local/state/poco/<app_id>/`
+- Legacy default config/state are still under:
+  - `~/.config/poco/config.json`
+  - `~/.local/state/poco/`
+
+## Development
+
+Build packages:
+
+```bash
+uv build
+```
+
+Quick syntax check:
+
+```bash
+uv run python -m py_compile poco/__init__.py poco/app.py poco/runtime.py poco/relay/app.py poco/config/store.py poco/tui/app.py
+```

pocket_coding-0.3.0/README.zh-CN.md

@@ -0,0 +1,110 @@
+# PoCo
+
+[English](README.md)
+
+**PoCo** (Pocket-Coding) 是一个把不同 Coding-Agent 接入办公软件机器人程序。
+
+当前已经支持了 Codex, Claude Code 等 Coding-Agent；已经支持了飞书机器人。
+
+## 快速开始
+
+点击这里[快速开始](docs/quickstart.zh-CN.md)。
+
+## 工作方式
+
+- 单聊机器人：管理控制台
+- 群聊机器人：项目工作区
+- 每个项目群会启动一个独立的 worker 进程
+- 每个项目都通过 DM 控制台卡片配置
+- PoCo 使用飞书长连接模式，不需要公网回调地址
+
+## 使用方式
+
+单聊控制台：
+
+- 发 `poco`
+- 用卡片完成新建项目和管理项目
+
+项目群：
+
+- 直接聊天即可
+- 如果要发图片，请发送一条同时包含图片和文字说明的飞书图文消息
+
+## Provider
+
+- `codex`：已通过 `codex app-server` 完整接通
+- `claude`：已通过 Claude Code CLI 接通，支持流式 JSON 输出
+
+当前 provider 能力说明：
+
+- Codex 是默认运行路径
+- Claude 当前支持 session attach、图片输入和流式回复
+
+## TUI
+
+页面：
+
+当前 TUI 是一个双栏终端界面：
+
+- 左侧：logo 和运行状态摘要
+- 右侧：当前交互面板
+- 底部：一个输入栏，但只有在需要输入配置值时才会启用
+
+快捷键：
+
+- `Ctrl+R`：保存并重启
+- `q`：返回上一级
+- `↑ / ↓`：在主菜单或 config 菜单中移动
+- `Enter`：进入当前选项
+- `Esc`：返回上一级
+
+默认首页是菜单驱动的：
+
+- 右侧会显示：
+  - `Agent & Model`
+  - `Bot (feishu)`
+  - `PoCo`
+  - `Language`
+  - `Quit`
+- 用 `↑ / ↓` 选择项目
+- 按 `Enter` 进入
+
+顶层菜单会直接进入对应配置分类：
+
+- 右侧面板会变成选择菜单
+- `↑ / ↓` 可以切换 section 或字段
+- `Enter` 进入当前项
+- `Esc` 返回上一级
+- `Language` 可以切换英文和中文
+- `Bot (feishu)` 里包含 `feishu` 相关设置，比如 `App ID`、`App Secret`
+- `Agent & Model` 里包含 `codex` 和 `claude`
+- `claude` 会先进入 provider 菜单
+- 先选一个 provider，例如 `anthropic`、`minimax`、`deepseek`、`kimi`
+- 再编辑这个 provider 的 `base_url`、`auth_token`、`model`、`extra_env`
+- `model` 会再进入一个模型菜单；先选模型，再执行 `set_as_default`
+- `extra_env` 也会进入子菜单；按项管理环境变量，不再直接编辑原始 JSON
+- `show` 会打开当前配置文件的滚动视图
+- 只有在编辑文本字段时，底部输入栏才会启用
+
+## 文件位置
+
+- 工作区绑定：`~/.config/poco/workspaces.json`
+- 每个 bot 的配置文件：`~/.config/poco/bindings/<app_id>/config.json`
+- 每个 bot 的状态目录：`~/.local/state/poco/<app_id>/`
+- 兼容旧版时，默认配置 / 状态仍在：
+  - `~/.config/poco/config.json`
+  - `~/.local/state/poco/`
+
+## 开发
+
+构建安装包：
+
+```bash
+uv build
+```
+
+快速语法检查：
+
+```bash
+uv run python -m py_compile poco/__init__.py poco/app.py poco/runtime.py poco/relay/app.py poco/config/store.py poco/tui/app.py
+```

{pocket_coding-0.2.1 → pocket_coding-0.3.0}/poco/__init__.py

@@ -1,4 +1,4 @@
 """PoCo package."""
 
 __all__ = ["__version__"]
-__version__ = "0.2.1"
+__version__ = "0.3.0"

pocket_coding-0.3.0/poco/app.py

@@ -0,0 +1,124 @@
+#!/usr/bin/env python3
+import argparse
+import json
+import logging
+import os
+import sys
+from logging.handlers import RotatingFileHandler
+from pathlib import Path
+from .runtime import (
+    PoCoService,
+    RingLogHandler,
+)
+from .config import ConfigStore, bind_workspace, build_paths, ensure_dirs, get_nested, workspace_binding
+from .tui import PoCoTui
+
+
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(description="PoCo")
+    parser.add_argument("--log-level", default="INFO")
+    sub = parser.add_subparsers(dest="command")
+    config_cmd = sub.add_parser("config", help="open PoCo and focus config tab")
+    config_cmd.add_argument("--show", action="store_true", help="show masked config and exit")
+    config_cmd.add_argument("key", nargs="?", help="config key, e.g. app_id or feishu.app_id")
+    config_cmd.add_argument("value", nargs="?", help="config value")
+    return parser.parse_args()
+
+
+def _env_flag(name: str) -> bool:
+    value = os.getenv(name, "").strip().lower()
+    return value in {"1", "true", "yes", "on"}
+
+
+def _env_feishu_binding() -> tuple[str, str, str] | None:
+    if not _env_flag("POCO_BIND_SKIP"):
+        return None
+    app_id = os.getenv("POCO_FEISHU_APP_ID", "").strip()
+    app_secret = os.getenv("POCO_FEISHU_APP_SECRET", "").strip()
+    if not app_id or not app_secret:
+        return None
+    alias = os.getenv("POCO_FEISHU_ALIAS", "").strip()
+    return app_id, app_secret, alias
+
+
+def _apply_env_binding(workspace: Path, app_id: str, app_secret: str, alias: str) -> str:
+    bind_workspace(workspace, app_id)
+    paths = build_paths(app_id)
+    ensure_dirs(paths)
+    store = ConfigStore(paths.config_path, paths)
+    config = store.load()
+    feishu = config.setdefault("feishu", {})
+    feishu["app_id"] = app_id
+    feishu["app_secret"] = app_secret
+    if alias:
+        feishu["alias"] = alias
+    store.save(config)
+    return app_id
+
+
+def main() -> None:
+    args = parse_args()
+    workspace = Path.cwd()
+    env_binding = _env_feishu_binding()
+    binding = workspace_binding(workspace)
+    if env_binding is not None:
+        binding = _apply_env_binding(workspace, *env_binding)
+    root_logger = logging.getLogger()
+    root_logger.setLevel(getattr(logging, str(getattr(args, "log_level", "INFO")).upper(), logging.INFO))
+    for handler in list(root_logger.handlers):
+        if isinstance(handler, logging.StreamHandler) and not isinstance(handler, logging.FileHandler):
+            root_logger.removeHandler(handler)
+    ring = RingLogHandler()
+    ring.setFormatter(logging.Formatter("%(asctime)s %(levelname)s %(name)s: %(message)s"))
+    root_logger.addHandler(ring)
+    file_handler: RotatingFileHandler | None = None
+
+    def build_service_for(app_id: str | None) -> PoCoService:
+        nonlocal file_handler
+        paths = build_paths(app_id or "default")
+        ensure_dirs(paths)
+        if file_handler is not None:
+            root_logger.removeHandler(file_handler)
+            file_handler.close()
+        file_handler = RotatingFileHandler(
+            paths.log_path,
+            maxBytes=2_000_000,
+            backupCount=3,
+            encoding="utf-8",
+            mode="w",
+        )
+        file_handler.setFormatter(logging.Formatter("%(asctime)s %(levelname)s %(name)s: %(message)s"))
+        root_logger.addHandler(file_handler)
+        logging.getLogger("poco").info(
+            "Persistent log file enabled at %s (instance=%s)",
+            paths.log_path,
+            app_id or "default",
+        )
+        store = ConfigStore(paths.config_path, paths)
+        return PoCoService(store, ring, paths)
+
+    service = build_service_for(binding)
+
+    if args.command == "config" and args.show:
+        print(json.dumps(service.masked_config(), ensure_ascii=False, indent=2))
+        return
+    if args.command == "config" and args.key:
+        if args.value is None:
+            raise SystemExit("usage: poco config <key> <value>")
+        path, _ = service.set_config_value(args.key, args.value)
+        current = get_nested(service.masked_config(), path)
+        print(json.dumps({path: current}, ensure_ascii=False, indent=2))
+        return
+    app = PoCoTui(
+        service,
+        service_factory=build_service_for,
+        focus_config=args.command == "config",
+        skip_bind_on_boot=env_binding is not None,
+    )
+    result = app.run()
+    if result == "restart":
+        os.execv(sys.executable, [sys.executable, *sys.argv])
+
+
+if __name__ == "__main__":
+    main()

{pocket_coding-0.2.1 → pocket_coding-0.3.0}/poco/config/__init__.py

@@ -1,4 +1,7 @@
 from .store import (
+    PoCoPaths,
+    SavedFeishuBot,
+    WORKSPACE_BINDINGS_PATH,
     CONFIG_KEY_ALIASES,
     CONFIG_PATH,
     DEFAULT_CONFIG,
@@ -8,17 +11,27 @@ from .store import (
     THREAD_STATE_PATH,
     WORKER_STATE_PATH,
     ConfigStore,
+    build_paths,
+    bind_workspace,
     config_ready,
     ensure_dirs,
     get_nested,
+    load_workspace_bindings,
     mask_secret,
     missing_required_config_paths,
+    normalize_instance_name,
     normalize_config_key,
     parse_config_value,
+    saved_feishu_bot_ids,
+    saved_feishu_bots,
     set_nested,
+    workspace_binding,
 )
 
 __all__ = [
+    "PoCoPaths",
+    "SavedFeishuBot",
+    "WORKSPACE_BINDINGS_PATH",
     "CONFIG_KEY_ALIASES",
     "CONFIG_PATH",
     "DEFAULT_CONFIG",
@@ -28,12 +41,19 @@ __all__ = [
     "THREAD_STATE_PATH",
     "WORKER_STATE_PATH",
     "ConfigStore",
+    "build_paths",
+    "bind_workspace",
     "config_ready",
     "ensure_dirs",
     "get_nested",
+    "load_workspace_bindings",
     "mask_secret",
     "missing_required_config_paths",
+    "normalize_instance_name",
     "normalize_config_key",
     "parse_config_value",
+    "saved_feishu_bot_ids",
+    "saved_feishu_bots",
     "set_nested",
+    "workspace_binding",
 ]