omp-wechat 0.2.0 → 1.1.0

package/LICENSE

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

package/README.md

@@ -12,26 +12,28 @@ WeChat user → iLink Bot API → [OMP/Pi process] → SDK → AI provider
                                   └──── reply ← message_end ─┘
 ```
 
-The extension runs **inside** the OMP/Pi process. On `session_start`, the iLink long-poll loop starts in-process. The host keeps the process alive; the poll loop runs as a background promise. When the process exits, the poll loop stops and all sessions are disposed.
+The extension runs **inside** the OMP/Pi process. On `session_start`, the iLink long-poll loop starts in-process as a background promise. A singleton port lock ensures only one process runs the poll loop at a time — other OMP/Pi processes standby with a 30s failover timer to take over if the lock holder crashes.
 
 For boot-time persistence, install a launchd/systemd service via `/wechat install`. The service runs `omp --mode rpc` (or `pi --mode rpc`) with `KeepAlive`/`Restart=always`, so the host (and the poll loop) survive crashes and reboots.
 
-- **Typing indicator**: shows "Typing..." on WeChat while the model is thinking
 - **No external `bun` required** — OMP/Pi is a standalone binary with an embedded runtime
-- **No detached daemon** — the poll loop runs in-process, lifecycle tied to the host
-- **Cross-platform** — launchd (macOS) or systemd (Linux), no sudo on macOS
+- **Singleton** — port lock guarantees one poll loop across all concurrent OMP/Pi processes
+- **Failover** — non-lock-holder processes check every 30s and take over if the lock holder dies
 - **iLink layer**: long-polls `getupdates` for inbound messages, sends replies via `sendmessage`
 - **AI engine**: one in-memory session per WeChat chat, prompts injected via `session.prompt()`
+- **Typing indicator**: shows "Typing..." on WeChat while the model is thinking
 - **Access control**: pairing-based — strangers must pair before their messages are delivered
 
 ## Features
 
 - **OMP/Pi extension**: installs via `omp plugin link .` or `pi plugin link .`, auto-starts poll loop on `session_start`
 - **Slash commands**: `/wechat login`, `/wechat status`, `/wechat pair`, `/wechat allow`, `/wechat revoke`, `/wechat list`, `/wechat stop`, `/wechat install`, `/wechat uninstall`
+- **Singleton**: port lock guarantees one poll loop across all concurrent OMP/Pi processes — no duplicate replies
+- **Failover**: 30s timer takes over automatically if the lock holder crashes
 - **Bidirectional**: receive and reply to WeChat text messages
 - **Per-chat sessions**: each WeChat chat gets an independent AI session (concurrent, isolated)
 - **LRU pool**: caps memory usage by evicting least-recently-used sessions (default: 50)
-- **Typing indicator**: native WeChat "typing..." shown during AI processing
+- **Typing indicator**: native WeChat "Typing..." shown during AI processing
 - **Access control**: pairing / allowlist / disabled modes
 - **Long text chunking**: splits replies >2000 chars at paragraph/line/space boundaries
 - **Boot service**: optional launchd/systemd service for auto-start on boot
@@ -46,7 +48,7 @@ For boot-time persistence, install a launchd/systemd service via `/wechat instal
 ### Install
 
 ```bash
-git clone <your-repo-url> OMP-Wechat
+git clone https://github.com/mentalfl0w/omp-wechat.git OMP-Wechat
 cd OMP-Wechat
 bun install          # build dependency only
 bun run build
@@ -90,6 +92,7 @@ Configuration is loaded from `~/.omp-wechat/config.yml`, falling back to built-i
 # ~/.omp-wechat/config.yml
 maxSessions: 50
 dmPolicy: pairing
+model: "@smol"              # default model (role alias or provider/id)
 systemPrompt: |
   You are an AI assistant chatting via WeChat.
   Keep replies concise and in plain text.
@@ -99,8 +102,8 @@ systemPrompt: |
 |---|---|---|
 | `maxSessions` | `50` | Session pool cap (LRU eviction) |
 | `dmPolicy` | `pairing` | Access policy: `pairing` / `allowlist` / `disabled` |
+| `model` | OMP default | Default model: role alias (`@smol`, `@slow`) or `provider/id` |
 | `systemPrompt` | Built-in | System prompt for WeChat chat sessions |
-
 > **Model, working directory, and tools are managed by OMP/Pi.** `createAgentSession()` automatically calls `discoverAuthStorage()`, reusing your existing `omp login` / `pi login` OAuth, `~/.omp/agent/agent.db` API keys, or `models.yml` config. This project never touches API keys.
 
 ## Slash Commands
@@ -117,6 +120,14 @@ systemPrompt: |
 | `/wechat install` | Install boot-time launchd/systemd service |
 | `/wechat uninstall` | Remove boot-time service |
 
+### Chat Commands (via WeChat message)
+
+| Command | Description |
+|---|---|
+| `/model` | Show current AI model |
+| `/models` | List all available models |
+| `/model provider/id` | Switch model for this chat (e.g. `/model anthropic/claude-haiku-4-5`) |
+
 ## Access Control
 
 | Mode | Behavior |
@@ -131,34 +142,32 @@ The logged-in user (who scanned the QR code) is automatically added to the allow
 
 | Scenario | Behavior |
 |---|---|
-| Host session starts | Poll loop starts automatically |
-| Host session exits | Poll loop stops, all sessions disposed |
-| Host crashes | launchd/systemd restarts the host (if `/wechat install` was run) |
+| Host process starts | Poll loop starts automatically (acquires singleton lock) |
+| Other host processes | Standby with 30s failover timer, take over if lock holder dies |
+| Host process exits | Poll loop stops, lock released, all sessions disposed |
+| Host crashes | Failover timer in another process detects dead lock and takes over; or launchd/systemd restarts the host (if `/wechat install` was run) |
 | Machine reboots | Service auto-starts the host (if installed), poll loop resumes |
-| No boot service | Poll loop only runs while a host session is active |
+| No boot service | Poll loop only runs while a host process is active |
 
-Logs: `~/.omp-wechat/logs/daemon.log`
+Logs: `~/.omp-wechat/logs/daemon.log` (poll loop) and `~/.omp-wechat/logs/rpc.log` (boot service RPC output)
 
 ## Project Structure
 
 ```
 OMP-Wechat/
 ├── package.json              # omp.extensions / pi.extensions manifest
-├── tsconfig.json
-├── .env.example
 ├── src/
 │   ├── index.ts              # OMP/Pi extension entry (session_start + /wechat commands)
-│   ├── bridge.ts             # In-process poll loop + message handling
+│   ├── bridge.ts             # In-process poll loop + message handling + singleton port lock
 │   ├── service.ts            # Boot-time launchd/systemd install
-│   ├── config.ts             # Config loading (env + config.yml + defaults)
+│   ├── config.ts             # Config loading (config.yml + defaults)
 │   ├── ilink/
 │   │   ├── types.ts          # iLink Bot API type definitions
 │   │   ├── client.ts         # iLink API client (poll/send/typing)
 │   │   └── login.ts          # QR code login flow
 │   ├── engine/
 │   │   ├── session.ts        # AI session creation + reply subscription
-│   │   ├── pool.ts           # Session pool (LRU eviction, concurrency)
-│   │   └── prompt.ts         # Barrel exports
+│   │   └── pool.ts           # Session pool (LRU eviction, concurrency)
 │   ├── access/
 │   │   └── control.ts        # Access control (pairing/allowlist/disabled)
 │   ├── utils/
@@ -174,15 +183,14 @@ OMP-Wechat/
 
 - **Reply-only**: iLink requires `context_token` from an inbound message; you cannot initiate conversations
 - **1:1 only**: iLink Bot API does not support group chats
-- **No message history**: WeChat provides no history API; session context is lost on restart (in-memory sessions)
 - **Single instance**: iLink allows only one bot connection per account
 - **Text only (Phase 1)**: images/voice/video are represented as `(image)` / `(voice)` placeholders; media support is planned
 
 ## Roadmap
 
 - [ ] **Phase 2**: Media support (inbound images as base64, voice transcription)
-- [ ] **Phase 3**: Persistent sessions (`SessionManager.create()` per chat directory)
-- [ ] **Phase 4**: Per-chat model selection (smol for simple questions, slow for complex)
+- [x] **Phase 3**: Persistent sessions — `SessionManager.continueRecent()` per chat, context survives restarts
+- [x] **Phase 4**: Per-chat model selection — `/model` `/models` chat commands for manual switching
 - [ ] **Phase 5**: Fine-grained permissions (per-user tool restrictions, bash approval via WeChat)
 
 ## License