@hasna/bridge 0.1.0

package/LICENSE

@@ -0,0 +1,17 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+Copyright 2026 Hasna
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,94 @@
+# bridge
+
+`bridge` connects local coding agents to external messaging channels. The local
+folder is `open-bridge`; the public package is `@hasna/bridge`; the CLI is
+`bridge`.
+
+## Install
+
+```sh
+bun install -g @hasna/bridge
+```
+
+## Commands
+
+```sh
+bridge init
+bridge doctor
+bridge channels add-telegram telegram-main --token-env TELEGRAM_BOT_TOKEN --allowed-chat-ids 123456789
+bridge profiles add codewith-main --agent-kind codewith --auth-profile account001 --cwd /Users/hasna
+bridge agents add codewith --kind codewith --profile codewith-main
+bridge routes add telegram-codewith --from telegram-main --to codewith --chat-ids 123456789
+bridge serve
+```
+
+Useful inspection commands:
+
+```sh
+bridge config path
+bridge config show
+bridge channels list
+bridge profiles list
+bridge agents list
+bridge routes list
+```
+
+Direct operations:
+
+```sh
+bridge send telegram-main 123456789 "hello"
+bridge ask codewith "summarize this repo"
+bridge route-message --channel telegram-main --chat-id 123456789 --text "status" --json
+```
+
+## Profiles
+
+Profiles let one bridge process route messages to multiple accounts without
+changing global agent login state.
+
+Codewith:
+
+```sh
+bridge profiles add cw-account001 --agent-kind codewith --auth-profile account001 --cwd /repo
+bridge agents add codewith-main --kind codewith --profile cw-account001
+```
+
+Claude:
+
+```sh
+bridge profiles add claude-account001 --agent-kind claude --home ~/.hasna/accounts/profiles/claude/account001
+bridge agents add claude-main --kind claude --profile claude-account001
+```
+
+AIcopilot:
+
+```sh
+bridge profiles add aicopilot-main --agent-kind aicopilot --cwd /repo
+bridge agents add aicopilot-main --kind aicopilot --profile aicopilot-main
+```
+
+## MCP
+
+`bridge-mcp` exposes:
+
+- `bridge_status`
+- `bridge_config`
+- `bridge_route_message`
+
+## State
+
+Default config path:
+
+```sh
+~/.hasna/bridge/config.json
+```
+
+Override with `BRIDGE_HOME` or `BRIDGE_CONFIG`.
+
+`bridge` stores configuration and runtime state with private file permissions.
+Telegram bot tokens should stay in environment variables; config stores the env
+var name, not the token value. Telegram channels fail closed unless
+`allowedChatIds` are set or `allowAllChats` is explicitly enabled.
+Channel-level `allowedChatIds` are enforced before route matching, and long-poll
+offsets are persisted in `~/.hasna/bridge/state.json` so restarts do not replay
+already-seen updates.

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}