1.1.0
This release puts the GM in charge of what an agent may do. Every command now runs under a
per-command permission policy with an approval flow inside Foundry. The new commands can execute
macros, write settings, manage users, and push content to players, so they ship disabled or behind
approval until a human turns them on.
Command permissions and GM approval
- Every command has one of three behaviors in the GM client that holds the bridge: allow, approve,
or deny. The GM edits them in the new Command permissions window under Module Settings. The
policy belongs to that browser profile, so different machines can hold different policies. - A command set to approve holds until the GM decides. Foundry opens a Command Approval window
with the command, the documents it would touch, and the values it would write, and plays a
notification sound. The sound and the approval timeout are settings. - Command discovery now describes what the connected GM client will actually run. The listing
hides denied commands and marks approval waits in both plain and JSON output. A denied command
refuses to run even as a dry run. - The default policy sorts commands by what a mistake would cost. Reads and ordinary edits run on
their own. Destructive commands, such as deleting documents, moving files, and resetting scene
fog, wait for approval, so after the update a script can no longer delete content without a GM
saying yes. The new high-risk commands are denied until a GM enables them.
New commands
macro executeruns a world macro with named arguments and a bounded timeout, then reports the
return value and the chat messages the run created. A script macro that throws fails the
command, and the error names what the macro raised. Off by default.setting setandsetting set-manywrite world settings and report the value Foundry actually
stored.setting get-manybatch-reads settings and flags unknown keys per row. Writes are off
by default.user create,user update,user delete,user role set, anduser permissions setmanage
users from the CLI. Role and permission changes are off by default. Creating a user asks for
approval.scene region behavior executable create,update, andcloneauthor executeMacro region
behaviors through a dedicated family with its own payload guards. Off by default.- Player-facing actions:
scene activate,scene pull-users,journal show,image show,
game pause,system reload, andchat flush. A broadcast aimed at specific users reports who
was offline.system reloadandchat flushask for approval by default.
Security
- Managed file path checks now reject percent-encoded traversal. An encoded
..segment or an
encoded path separator inside a segment used to survive until after the boundary check.
Fixes and other changes
- The CLI on your machine and the Foundry module now work only as a matched pair from the same
release. A mixed pair refuses to connect, and the error says which side is behind, so update
both together. - The packaged
foundry-world-editorAgent Skill is updated for the permission and approval flow
and the new commands. - Retries are more careful: when the bridge cannot prove a retry is the same request it already
handled, it refuses it rather than risk running the command twice. - A managed file listing no longer fails on an entry it cannot represent, and it names the managed
data root it addresses. - Only GM users see the module's settings.