hajimi-claw 0.1.0 → 0.1.1

package/Cargo.lock

@@ -118,6 +118,58 @@ version = "1.5.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "c08606f8c3cbf4ce6ec8e28fb0014a2c086708fe954eaa885384a6165172e7e8"
 
+[[package]]
+name = "axum"
+version = "0.8.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8b52af3cb4058c895d37317bb27508dccc8e5f2d39454016b297bf4a400597b8"
+dependencies = [
+ "axum-core",
+ "bytes",
+ "form_urlencoded",
+ "futures-util",
+ "http",
+ "http-body",
+ "http-body-util",
+ "hyper",
+ "hyper-util",
+ "itoa",
+ "matchit",
+ "memchr",
+ "mime",
+ "percent-encoding",
+ "pin-project-lite",
+ "serde_core",
+ "serde_json",
+ "serde_path_to_error",
+ "serde_urlencoded",
+ "sync_wrapper",
+ "tokio",
+ "tower",
+ "tower-layer",
+ "tower-service",
+ "tracing",
+]
+
+[[package]]
+name = "axum-core"
+version = "0.5.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "08c78f31d7b1291f7ee735c1c6780ccde7785daae9a9206026862dab7d8792d1"
+dependencies = [
+ "bytes",
+ "futures-core",
+ "http",
+ "http-body",
+ "http-body-util",
+ "mime",
+ "pin-project-lite",
+ "sync_wrapper",
+ "tower-layer",
+ "tower-service",
+ "tracing",
+]
+
 [[package]]
 name = "base64"
 version = "0.22.1"
@@ -232,6 +284,12 @@ dependencies = [
  "cipher",
 ]
 
+[[package]]
+name = "data-encoding"
+version = "2.10.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d7a1e2f27636f116493b8b860f5546edb47c8d8f8ea73e1d2a20be88e28d1fea"
+
 [[package]]
 name = "digest"
 version = "0.10.7"
@@ -458,7 +516,7 @@ dependencies = [
 
 [[package]]
 name = "hajimi-claw"
-version = "0.1.0"
+version = "0.1.1"
 dependencies = [
  "anyhow",
  "hajimi-claw-daemon",
@@ -467,7 +525,7 @@ dependencies = [
 
 [[package]]
 name = "hajimi-claw-agent"
-version = "0.1.0"
+version = "0.1.1"
 dependencies = [
  "anyhow",
  "chrono",
@@ -478,6 +536,7 @@ dependencies = [
  "hajimi-claw-store",
  "hajimi-claw-tools",
  "hajimi-claw-types",
+ "regex",
  "serde_json",
  "tempfile",
  "tokio",
@@ -487,10 +546,12 @@ dependencies = [
 
 [[package]]
 name = "hajimi-claw-bot"
-version = "0.1.0"
+version = "0.1.1"
 dependencies = [
  "anyhow",
+ "axum",
  "chrono",
+ "futures",
  "hajimi-claw-gateway",
  "hajimi-claw-store",
  "hajimi-claw-types",
@@ -498,12 +559,14 @@ dependencies = [
  "serde",
  "serde_json",
  "tokio",
+ "tokio-tungstenite",
  "tracing",
+ "url",
 ]
 
 [[package]]
 name = "hajimi-claw-daemon"
-version = "0.1.0"
+version = "0.1.1"
 dependencies = [
  "anyhow",
  "chrono",
@@ -516,16 +579,20 @@ dependencies = [
  "hajimi-claw-store",
  "hajimi-claw-tools",
  "hajimi-claw-types",
+ "reqwest",
  "serde",
+ "serde_json",
+ "tempfile",
  "tokio",
  "toml",
  "tracing",
  "tracing-subscriber",
+ "uuid",
 ]
 
 [[package]]
 name = "hajimi-claw-exec"
-version = "0.1.0"
+version = "0.1.1"
 dependencies = [
  "anyhow",
  "async-trait",
@@ -542,7 +609,7 @@ dependencies = [
 
 [[package]]
 name = "hajimi-claw-gateway"
-version = "0.1.0"
+version = "0.1.1"
 dependencies = [
  "anyhow",
  "async-trait",
@@ -563,7 +630,7 @@ dependencies = [
 
 [[package]]
 name = "hajimi-claw-llm"
-version = "0.1.0"
+version = "0.1.1"
 dependencies = [
  "anyhow",
  "async-stream",
@@ -580,7 +647,7 @@ dependencies = [
 
 [[package]]
 name = "hajimi-claw-policy"
-version = "0.1.0"
+version = "0.1.1"
 dependencies = [
  "chrono",
  "hajimi-claw-types",
@@ -591,7 +658,7 @@ dependencies = [
 
 [[package]]
 name = "hajimi-claw-store"
-version = "0.1.0"
+version = "0.1.1"
 dependencies = [
  "aes-gcm",
  "anyhow",
@@ -606,7 +673,7 @@ dependencies = [
 
 [[package]]
 name = "hajimi-claw-tools"
-version = "0.1.0"
+version = "0.1.1"
 dependencies = [
  "anyhow",
  "async-trait",
@@ -623,7 +690,7 @@ dependencies = [
 
 [[package]]
 name = "hajimi-claw-types"
-version = "0.1.0"
+version = "0.1.1"
 dependencies = [
  "async-trait",
  "chrono",
@@ -712,6 +779,12 @@ version = "1.10.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "6dbf3de79e51f3d586ab4cb9d5c3e2c14aa28ed23d180cf89b4df0454a69cc87"
 
+[[package]]
+name = "httpdate"
+version = "1.0.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "df3b46402a9d5adb4c86a0cf463f42e19994e3ee891101b1841f30a545cb49a9"
+
 [[package]]
 name = "hyper"
 version = "1.8.1"
@@ -725,6 +798,7 @@ dependencies = [
  "http",
  "http-body",
  "httparse",
+ "httpdate",
  "itoa",
  "pin-project-lite",
  "pin-utils",
@@ -747,7 +821,7 @@ dependencies = [
  "tokio",
  "tokio-rustls",
  "tower-service",
- "webpki-roots",
+ "webpki-roots 1.0.6",
 ]
 
 [[package]]
@@ -1020,12 +1094,24 @@ dependencies = [
  "regex-automata",
 ]
 
+[[package]]
+name = "matchit"
+version = "0.8.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "47e1ffaa40ddd1f3ed91f717a33c8c0ee23fff369e3aa8772b9605cc1d22f4c3"
+
 [[package]]
 name = "memchr"
 version = "2.8.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "f8ca58f447f06ed17d5fc4043ce1b10dd205e060fb3ce5b979b8ed8e59ff3f79"
 
+[[package]]
+name = "mime"
+version = "0.3.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6877bb514081ee2a7ff5ef9de3281f14a4dd4bceac4c09388074a6b5df8a139a"
+
 [[package]]
 name = "mio"
 version = "1.1.1"
@@ -1321,7 +1407,7 @@ dependencies = [
  "wasm-bindgen-futures",
  "wasm-streams",
  "web-sys",
- "webpki-roots",
+ "webpki-roots 1.0.6",
 ]
 
 [[package]]
@@ -1468,6 +1554,17 @@ dependencies = [
  "zmij",
 ]
 
+[[package]]
+name = "serde_path_to_error"
+version = "0.1.20"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "10a9ff822e371bb5403e391ecd83e182e0e77ba7f6fe0160b795797109d1b457"
+dependencies = [
+ "itoa",
+ "serde",
+ "serde_core",
+]
+
 [[package]]
 name = "serde_spanned"
 version = "0.6.9"
@@ -1489,6 +1586,17 @@ dependencies = [
  "serde",
 ]
 
+[[package]]
+name = "sha1"
+version = "0.10.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e3bf829a2d51ab4a5ddf1352d8470c140cadc8301b2ae1789db023f01cedd6ba"
+dependencies = [
+ "cfg-if",
+ "cpufeatures",
+ "digest",
+]
+
 [[package]]
 name = "sha2"
 version = "0.10.9"
@@ -1694,6 +1802,22 @@ dependencies = [
  "tokio",
 ]
 
+[[package]]
+name = "tokio-tungstenite"
+version = "0.28.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d25a406cddcc431a75d3d9afc6a7c0f7428d4891dd973e4d54c56b46127bf857"
+dependencies = [
+ "futures-util",
+ "log",
+ "rustls",
+ "rustls-pki-types",
+ "tokio",
+ "tokio-rustls",
+ "tungstenite",
+ "webpki-roots 0.26.11",
+]
+
 [[package]]
 name = "tokio-util"
 version = "0.7.18"
@@ -1761,6 +1885,7 @@ dependencies = [
  "tokio",
  "tower-layer",
  "tower-service",
+ "tracing",
 ]
 
 [[package]]
@@ -1799,6 +1924,7 @@ version = "0.1.44"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "63e71662fa4b2a2c3a26f570f037eb95bb1f85397f3cd8076caed2f026a6d100"
 dependencies = [
+ "log",
  "pin-project-lite",
  "tracing-attributes",
  "tracing-core",
@@ -1860,6 +1986,25 @@ version = "0.2.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "e421abadd41a4225275504ea4d6566923418b7f05506fbc9c0fe86ba7396114b"
 
+[[package]]
+name = "tungstenite"
+version = "0.28.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8628dcc84e5a09eb3d8423d6cb682965dea9133204e8fb3efee74c2a0c259442"
+dependencies = [
+ "bytes",
+ "data-encoding",
+ "http",
+ "httparse",
+ "log",
+ "rand",
+ "rustls",
+ "rustls-pki-types",
+ "sha1",
+ "thiserror",
+ "utf-8",
+]
+
 [[package]]
 name = "typenum"
 version = "1.19.0"
@@ -1906,6 +2051,12 @@ dependencies = [
  "serde",
 ]
 
+[[package]]
+name = "utf-8"
+version = "0.7.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "09cc8ee72d2a9becf2f2febe0205bbed8fc6615b7cb429ad062dc7b7ddd036a9"
+
 [[package]]
 name = "utf8_iter"
 version = "1.0.4"
@@ -2101,6 +2252,15 @@ dependencies = [
  "wasm-bindgen",
 ]
 
+[[package]]
+name = "webpki-roots"
+version = "0.26.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "521bc38abb08001b01866da9f51eb7c5d647a19260e00054a8c7fd5f9e57f7a9"
+dependencies = [
+ "webpki-roots 1.0.6",
+]
+
 [[package]]
 name = "webpki-roots"
 version = "1.0.6"

package/Cargo.toml

@@ -15,7 +15,7 @@ members = [
 resolver = "2"
 
 [workspace.package]
-version = "0.1.0"
+version = "0.1.1"
 edition = "2024"
 license = "MIT"
 authors = ["OpenAI Codex"]
@@ -25,6 +25,7 @@ aes-gcm = "0.10"
 anyhow = "1.0"
 async-stream = "0.3"
 async-trait = "0.1"
+axum = "0.8"
 base64 = "0.22"
 chrono = { version = "0.4", features = ["serde"] }
 futures = "0.3"
@@ -36,11 +37,13 @@ serde_json = "1.0"
 sha2 = "0.10"
 tempfile = "3.13"
 thiserror = "2.0"
-tokio = { version = "1.39", features = ["fs", "io-util", "macros", "process", "rt-multi-thread", "signal", "sync", "time"] }
+tokio = { version = "1.39", features = ["fs", "io-util", "macros", "net", "process", "rt-multi-thread", "signal", "sync", "time"] }
 tokio-stream = "0.1"
+tokio-tungstenite = { version = "0.28", features = ["rustls-tls-webpki-roots"] }
 toml = "0.8"
 tracing = "0.1"
 tracing-subscriber = { version = "0.3", features = ["env-filter", "fmt"] }
+url = "2.5"
 uuid = { version = "1.10", features = ["serde", "v4"] }
 windows = { version = "0.58", features = ["Win32_Foundation", "Win32_Security", "Win32_System_JobObjects", "Win32_System_Threading"] }
 

package/LICENSE

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

@@ -1,30 +1,36 @@
 # hajimi-claw
 
-Single-user Telegram-first ops agent in Rust.
+Single-user Telegram/Feishu-first ops agent in Rust.
 
 ## Current scope
 
 - Telegram channel -> gateway -> runtime command flow
+- Feishu webhook channel -> gateway -> runtime command flow
 - Telegram long polling command surface
 - Single active task gate
 - Structured tools for file access, Docker, and systemd
-- Guarded local command execution with approvals and short-lived elevated lease
+- Guarded local command execution with approval mode, short-lived elevated mode, and full elevated mode
 - SQLite audit/task/session persistence
 - Windows-safe execution mode with allowlist checks and Job Object cleanup
-- Telegram onboarding flow for custom providers and chat-level provider binding
+- Channel-aware onboarding for Telegram or Feishu plus provider/model setup
+- Configurable multi-agent orchestration with coordinator/worker/integrator flow
 
 ## Running
 
-1. Copy `config.example.toml` to `config.toml`.
-2. Fill in the Telegram bot token and admin ids.
-3. Set the provider secret key env var before starting:
-   `set HAJIMI_CLAW_MASTER_KEY=replace-me-with-a-long-random-string`
-4. Optional: fill in the `llm` section to bootstrap a default provider on first start.
-5. Run `cargo run`.
-6. In Telegram, use `/onboard` to add or switch providers interactively.
+1. Run `cargo run -- onboard` or `hajimi onboard`.
+2. `hajimi onboard` lets you choose `telegram`, `feishu`, or `skip`, verifies the channel credentials when configured, and then interactively guides provider model selection.
+3. Start the daemon with `cargo run` or `hajimi`.
+4. In Telegram, use `/menu` for the main quick-action panel, or just send plain text and let hajimi reply in natural language.
+5. In Feishu mode, configure the app's event subscription URL to point at `http(s)://<your-host><event_path>` for the local webhook listener.
 
 Set `HAJIMI_CLAW_CONFIG` if you want to load a different config path.
 
+For background use without keeping a terminal open:
+
+- `hajimi launch`
+- `hajimi status`
+- `hajimi stop`
+
 ## Install
 
 ### Windows
@@ -34,7 +40,7 @@ Set `HAJIMI_CLAW_CONFIG` if you want to load a different config path.
 - System-wide install:
   `powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1 -System`
 
-The installer copies `hajimi-claw.exe` and `config.example.toml`, and updates `PATH`.
+The installer copies `hajimi-claw.exe`, creates the `hajimi.exe` alias, copies `config.example.toml`, and updates `PATH`.
 
 ### Linux
 
@@ -45,7 +51,7 @@ The installer copies `hajimi-claw.exe` and `config.example.toml`, and updates `P
 - System-wide install with systemd unit:
   `sudo sh ./scripts/install.sh --system --install-service`
 
-The Linux installer copies the binary to `PREFIX/bin` and `config.example.toml` to `PREFIX/share/hajimi-claw`.
+The Linux installer copies the binary to `PREFIX/bin/hajimi-claw`, creates the `PREFIX/bin/hajimi` alias, and copies `config.example.toml` to `PREFIX/share/hajimi-claw`.
 
 ### npm
 
@@ -54,20 +60,143 @@ The Linux installer copies the binary to `PREFIX/bin` and `config.example.toml`
 - Global install from the repo:
   `npm install -g .`
 
-The npm package builds the Rust binary locally during `postinstall`, so `cargo` must already be installed on the target machine.
+The npm package exposes both `hajimi` and `hajimi-claw`, and builds the Rust binary locally during `postinstall`, so `cargo` must already be installed on the target machine.
+
+## Channels
+
+- `telegram`
+- `feishu`
+
+`hajimi onboard` now lets you pick the primary channel:
+
+- `telegram`: verifies the bot token and can auto-pair the admin user/chat
+- `feishu`: asks for `app_id` and `app_secret`, verifies them by requesting a tenant access token, and supports both `webhook` and `long-connection` modes
+- `skip`: leaves channel setup empty for now so you can finish provider/model setup first
+
+Current Feishu limitations:
+
+- In `webhook` mode, you still need to configure the Feishu event subscription URL manually in the Feishu developer console
+- In `long-connection` mode, message receive events can come through the WebSocket connection, but card button callbacks still need the lightweight HTTP callback path
+- Feishu card support currently targets `menu/provider/model` style button flows; it is not a full parity implementation of Telegram inline interactions
+
+## CLI
+
+- `hajimi`
+- `hajimi daemon`
+- `hajimi launch`
+- `hajimi stop`
+- `hajimi status`
+- `hajimi onboard`
+- `hajimi providers`
+- `hajimi provider current`
+- `hajimi provider use <provider-id>`
+- `hajimi provider models [provider-id]`
+- `hajimi provider set-model <provider-id> <model>`
+- `hajimi model current`
+- `hajimi model use [model]`
+- `hajimi models [provider-id]`
+- `hajimi restart`
+- `hajimi help`
+
+## Multi-Agent
+
+`hajimi` can split one natural-language request into multiple sub-agents. This is configured in
+`config.toml` under `[multi_agent]`:
+
+```toml
+[multi_agent]
+enabled = true
+auto_delegate = false
+default_workers = 3
+max_workers = 8
+worker_timeout_secs = 90
+max_context_chars_per_worker = 24000
+```
+
+Natural-language triggers:
+
+- `use 4 agents to analyze this`
+- `开 6 个 agent 帮我排查`
+- `please use sub agents for this`
+
+Behavior:
+
+- If the prompt explicitly asks for `N agents` or `N workers`, hajimi uses that count up to
+  `max_workers`
+- If the prompt says `sub agent` / `multi agent`, hajimi uses `default_workers`
+- `auto_delegate = true` enables light automatic delegation for obviously parallel analysis tasks
+- Worker agents only perform parallel reasoning in v1; local command execution still stays behind
+  the existing single runtime/policy path
+- Session-level controls are available in chat:
+  - `/agents on`
+  - `/agents off`
+  - `/agents auto`
+  - `/agents status`
+- When a natural-language task is about to run in multi-agent mode, Telegram now shows a temporary
+  progress card and Feishu sends a status card before the final reply
+
+## Persona Files
+
+`hajimi onboard` now creates empty persona files in `~/.hajimi/`:
+
+- `soul.md`
+- `agents.md`
+- `tools.md`
+- `skills.md`
+
+`hajimi` reloads these files on each request, so Telegram edits take effect on the next `/ask`.
+
+- Auto-discovered files: `soul.md`, `agents.md`, `AGENTS.md`, `tools.md`, `skills.md`
+- Search roots: the current working directory, the config directory, and `~/.hajimi`
+- Optional explicit list: set `[persona].prompt_files` in `config.toml`
+
+Use these files for:
+
+- `soul.md`: tone, temperament, and high-level persona
+- `agents.md` or `AGENTS.md`: repo or operator instructions
+- `tools.md`: tool-use policy and operational preferences
+- `skills.md`: extra habits, playbooks, and skill-selection hints
 
 ## Telegram commands
 
 - `/onboard`
 - `/onboard cancel`
 - `/provider list`
+- `/provider add`
 - `/provider current`
 - `/provider use <id>`
 - `/provider bind <id>`
 - `/provider test [id]`
 - `/provider models [id]`
+- `/provider set-model <provider-id> <model>`
+- `/model current`
+- `/model use [model]`
+- `/persona list`
+- `/persona read <soul|agents|tools|skills>`
+- `/persona write <file> <content>`
+- `/persona append <file> <content>`
 - `/ask <text>`
 - `/shell open [name]`
 - `/shell exec <cmd>`
 - `/shell close`
 - `/status`
+- `/menu`
+- `/elevated on`
+- `/elevated off`
+- `/elevated ask`
+- `/elevated full`
+
+Plain Telegram text now defaults to a natural-language task, so `/ask` is optional for normal requests. hajimi sends a Telegram `typing` action, posts a short placeholder, and then edits that message with the final answer.
+
+The bot also registers Telegram slash commands with `setMyCommands` on startup and exposes an inline quick-action menu via `/menu` and `/help`. `/provider current` and `/model current` now return inline buttons so you can switch provider/model directly from Telegram without typing full commands.
+
+## Provider And Model Switching
+
+- Add a new provider: `hajimi onboard` or Telegram `/provider add`
+- List configured providers: `hajimi providers` or Telegram `/provider list`
+- Switch the default provider: `hajimi provider use <provider-id>` or Telegram `/provider use <id>`
+- See the current model: `hajimi model current` or Telegram `/model current`
+- Switch the current model on the active provider: `hajimi model use [model]` or Telegram `/model use [model]`
+- Open the model picker with inline buttons: `hajimi model use` or Telegram `/model use`
+- Switch a specific provider to a specific model: `hajimi provider set-model <provider-id> <model>` or Telegram `/provider set-model <provider-id> <model>`
+- `hajimi onboard` now supports optional fallback models per provider; if the primary model fails, hajimi will retry the provider using the configured fallback models in order