@justfortytwo/telegram 0.1.3 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +13 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -96,7 +96,11 @@ exact-command allowlist is the remaining seam.
96
96
  | `ALLOWED_CHAT_IDS` | bootstrap | Comma-separated chat IDs allowed before any binding exists. Optional once bindings exist. |
97
97
  | `CLAUDE_BIN` | no | Path to the `claude` binary (default `claude`). |
98
98
  | `FORTYTWO_TURN_TIMEOUT` | no | Hard cap (seconds) on a single turn so a stalled model can't wedge the bridge (default 300). |
99
+ | `FORTYTWO_BASH_ALLOW_TTL_HOURS` | no | Default TTL (hours) for "Allow _N_h" bash approvals (default 8). |
99
100
  | `TELEGRAM_BINDINGS_DB` | no | Path to the self-owned bindings db (default `state/telegram-bindings.db`). |
101
+ | `DB_PATH` | no | Path to the memory DB the bridge opens/migrates at startup (default `db/fortytwo.db`, relative to `FORTYTWO_ROOT`). |
102
+ | `EMBED_MODEL` | no | When set, the bridge uses the Ollama embedder for memory (otherwise a deterministic fallback). |
103
+ | `OLLAMA_BASE_URL` | no | Base URL for the Ollama embedder (default `http://localhost:11434`; may be remote). |
100
104
  | `ASSISTANT_NAME` / `ASSISTANT_ACTOR` / `OWNER_ACTOR` | no | Display name + journal actor labels. |
101
105
  | `FORTYTWO_ROOT` | no | Working root for the headless `claude` process + state files. |
102
106
 
@@ -109,6 +113,15 @@ exact-command allowlist is the remaining seam.
109
113
 
110
114
  ## Usage
111
115
 
116
+ ### Prerequisites / first run
117
+
118
+ - The bridge **spawns the `claude` binary**, so Claude Code's `claude` must be on
119
+ your `PATH` (or point `CLAUDE_BIN` at it).
120
+ - It loads `config/adapters.toml` from `$FORTYTWO_ROOT/config/`.
121
+ - On first run it **requires** `TELEGRAM_BOT_TOKEN` and either `ALLOWED_CHAT_IDS`
122
+ or a pre-existing binding — with no authorized chat to reach, the bridge exits
123
+ immediately rather than long-polling a bot nobody can talk to.
124
+
112
125
  ```sh
113
126
  npm run build
114
127
  node dist/bridge.js
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@justfortytwo/telegram",
3
- "version": "0.1.3",
3
+ "version": "0.1.4",
4
4
  "description": "Telegram channel adapter for fortytwo: a long-polling bridge that drives a headless `claude` turn loop per chat, surfaces gate approvals as inline keyboards, and gates inbound access behind a login/pairing binding flow.",
5
5
  "license": "MIT",
6
6
  "author": {