Skip to content

v1.8.0

Choose a tag to compare

@github-actions github-actions released this 09 Nov 17:53
· 393 commits to main since this release
v1.8.0
199be35

Welcome to FengSui v1.8.0!

Important

Before you upgrade

  • Nothing to change in .env or docker-compose.yml: every setting the console can now change follows .env until you change it there.
  • Existing tokens keep what they could do: a full-access token gets all four permissions, a read-only one reads SMS as before. Agents no longer see tools their token may not use, and calling one answers TOKEN_NOT_PERMITTED.
  • You can go back to 1.7.7: it keeps the new settings in settings.json but ignores them, so .env applies again, and a token with some but not all permissions works as a read-only token there, which on 1.7.x also reads SMS. Coming back to 1.8.0 finds them as you left them. Recently deleted does not survive the trip: 1.7.7 drops it from sms.json the next time it saves, and removes messages restored from it at its next full sync.
  • From 1.7.4 or earlier: run docker exec cpe-dash node dist/cli.js doctor first. A file it reports as "stored without encryption" is moved aside at the first start of 1.7.5 or later: encrypt it first, with the daemon stopped, by docker compose run --rm cpe-dash node dist/cli.js rekey --plaintext.

Highlights

Choose what each token may do

Every token can read the router's data; what else it may do is up to you: read SMS and codes, change the router, manage devices' internet access, send SMS and edit contacts. You tick it when you create the token and can change it later. The REST API, the MCP tools and the live events follow it, and an agent sees only the tools its token may use. Existing tokens keep exactly what they could do.

Agent, self-healing, alert and SMS settings in the console

The AI agents' switches, the self-healing windows, the alerts and the SMS behaviour can now be set under Settings, and apply at once. Until you change one there, it follows .env as before.

Deleted SMS can be restored

A deleted message still leaves the router at once, but FengSui now keeps it in the SMS centre's new Recently deleted for 30 days (you choose how long, or turn it off), where you can restore it or delete it for good. Deletes from Telegram, tokens and AI agents land there too, and only the signed-in console can empty it.

AI agents can help test your router

With "Let AI agents test this router" on (Settings → Device), an agent connected to FengSui can look, read-only and through FengSui's own session, for router endpoints FengSui does not use yet. On a model FengSui was not verified on, it can also test the experimental writes and draft a compatibility report from a ready-made prompt. If an agent's band lock leaves the WAN down for 3 minutes, FengSui writes back the band setting from before the lock.

What's changed

🚀 Features

  • Per-token permissions for the REST API, MCP and live events.
  • Behaviour settings in the console
  • AI agents can test the router
  • Recently deleted for SMS.
  • A safety net for an agent's band lock.
  • A prompt for testing with an AI agent.

🌟 Enhancements

  • Tokens get permission checkboxes.
  • Self-healing and the alerts are always running
  • An agent that may not test is told which switch to ask for.
  • The self-healing hints point to Settings.

🐛 Bug fixes

  • A one-message conversation says "1 message".

📚 Documentation

  • The AI agents page describes the console switches, token permissions and agent testing

Full Changelog: v1.7.7...v1.8.0


Details of every change: CHANGELOG.md · Documentation: fengsui.iocky.com · Container image: ghcr.io/cky008/cpe-dash:1.8.0