@mercury-fw/cli 0.54.0 → 0.56.0

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @mercury-fw/cli
 
+## 0.56.0
+
+### Patch Changes
+
+- 1126106: Every turn tells the model when and where the person wrote it.
+
+  - Each message reaches the model after a line with the weekday, date, time and time zone it was written in (`[Wednesday 2026-10-21 14:32 Europe/Rome]`), and the system prompt says what that line is. The conversation's archive and what a UI shows of it keep the message as written.
+  - A resumed conversation's messages come back stamped from the archive's timestamps.
+  - The Layer 1 summary keeps when things were said; the episodic summary quotes a date only from those lines, never guessing one. The semantic-fact extractor and the capture card's preview leave the line out.
+  - The time zone, always an IANA name (`Europe/Rome`), is the one the person saved, else the one their client is in when the channel passes it on, else the new `i18n.timeZone` in `mercury.config.ts`, else the machine's. A `timeZone` that isn't a zone's name stops the start.
+  - The person saves theirs by telling the assistant (the new `set_time_zone` tool), or from a channel's settings.
+  - Channel contract: `InboundTurn.timeZoneHint`, and `ctx.settings.setTimeZone` for a channel with a settings area; `reads.me` also returns the saved `timeZone`. Both are optional additions: the contract version stays 6.
+  - HTTP channel: the `X-Time-Zone` header on `POST /turn` (allowed by CORS), `timeZone` in `GET /me`, and `PATCH /me` with `{ timeZone }` to save it. Needs the framework at 0.56 or later; an older core ignores the header and offers no `PATCH /me`.
+  - Google Chat channel: the client's time zone (`common.timeZone`), when the event carries it, on messages and on the turn a click resumes.
+
+  To set a default for an app's people, add `timeZone: "Europe/Rome"` (their zone) to `i18n` in `mercury.config.ts`; without it the machine's zone is used, often UTC inside a container.
+
+- Updated dependencies [1126106]
+  - @mercury-fw/core@0.56.0
+  - @mercury-fw/utils@0.56.0
+
+## 0.55.0
+
+### Patch Changes
+
+- Updated dependencies [eac72fa]
+  - @mercury-fw/core@0.55.0
+  - @mercury-fw/utils@0.55.0
+
 ## 0.54.0
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mercury-fw/cli",
-  "version": "0.54.0",
+  "version": "0.56.0",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -41,22 +41,22 @@
   "comment:shape": "The Mercury CLI (`mfw`). `mfw create <dir>` writes a new Mercury app from the template. The framework packages move in lockstep with it, so a new app gets them at the CLI's own version; plugins and channels at the registry's latest. The plugin and channel packages are devDependencies only for the catalog test. `main(argv)` is exported for create-mercury-agent.",
   "dependencies": {
     "@clack/prompts": "^1.8.1",
-    "@mercury-fw/core": "0.54.0",
-    "@mercury-fw/utils": "0.54.0",
+    "@mercury-fw/core": "0.56.0",
+    "@mercury-fw/utils": "0.56.0",
     "commander": "^15.0.0"
   },
   "devDependencies": {
     "@mercury-fw/auth-oidc": "0.2.0",
     "@mercury-fw/auth-static": "0.2.1",
-    "@mercury-fw/channel-google-chat": "0.9.0",
-    "@mercury-fw/channel-http": "0.11.0",
+    "@mercury-fw/channel-google-chat": "0.10.0",
+    "@mercury-fw/channel-http": "0.12.0",
     "@mercury-fw/directory-static": "0.1.1",
-    "@mercury-fw/formatter": "0.54.0",
-    "@mercury-fw/plugin-atlassian-admin": "0.4.0",
-    "@mercury-fw/plugin-bitbucket": "0.5.0",
-    "@mercury-fw/plugin-jira": "0.7.0",
-    "@mercury-fw/plugin-web-search": "0.2.0",
-    "@mercury-fw/plugin-zitadel": "0.4.0",
+    "@mercury-fw/formatter": "0.56.0",
+    "@mercury-fw/plugin-atlassian-admin": "0.5.0",
+    "@mercury-fw/plugin-bitbucket": "0.6.0",
+    "@mercury-fw/plugin-jira": "0.8.0",
+    "@mercury-fw/plugin-web-search": "0.3.0",
+    "@mercury-fw/plugin-zitadel": "0.5.0",
     "@mercury-fw/typescript-config": "*",
     "@mercury-fw/web-search-searxng": "0.1.0",
     "@types/bun": "^1.4.2",

package/src/render.ts

@@ -416,7 +416,7 @@ ${directory ? `- Directory: ${directory.id}\n` : ""}
 ## Layout
 
 - \`mercury.config.ts\`: what the app is made of (tool plugins, channels, how their lists read) and the assistant's persona: its name, who it is and how it answers. Edit them freely.
-- \`locales/\`: the texts people see, one file per language the assistant speaks. \`en.json\` overrides the English ones; add \`it.json\` (and \`it\` to \`i18n.locales\` in the config) for Italian, \`i18n.defaultLocale\` for the language people get when they haven't picked one. The app's own texts (a formatter rule's) are \`app.\` keys, written in English in \`en.json\` and translated in every other file. Mercury logs at startup the keys a file is missing.
+- \`locales/\`: the texts people see, one file per language the assistant speaks. \`en.json\` overrides the English ones; add \`it.json\` (and \`it\` to \`i18n.locales\` in the config) for Italian, \`i18n.defaultLocale\` for the language people get when they haven't picked one, \`i18n.timeZone\` (an IANA name such as \`Europe/Rome\`) for the time zone of whoever saved none and whose app says none. The app's own texts (a formatter rule's) are \`app.\` keys, written in English in \`en.json\` and translated in every other file. Mercury logs at startup the keys a file is missing.
 - \`src/index.ts\`: the service (channels, crons). \`src/repl.ts\`: an interactive terminal for trying things out.
 - \`.env.example\`: every variable the app reads. Copy it to \`.env\` and fill it in.