@ai-matrx/agents 0.59.183 → 0.59.185

package/CHANGELOG.md

@@ -1,10 +1,20 @@
 # Changelog
 
-## 0.59.183
+## 0.59.185
 
 UNVERIFIED: this release has no Unreleased entry and the source comparison could not be made (the caller supplied no source comparison). Whether source changed is unknown; consumer action is unknown.
 Check the package's gitHead on npm against this version's gitHead: `git diff <previous gitHead> <this gitHead> -- apps/shared/matrx-agents/src`.
 
+## 0.59.184
+
+Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 9d8e39ac18 9b1ad7d08b -- apps/shared/matrx-agents/src`
+has no shipped-source changes outside tests, fixtures and docs). No consumer action required.
+
+## 0.59.183
+
+Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 4f5dd0a906 9d8e39ac18 -- apps/shared/matrx-agents/src`
+has no shipped-source changes outside tests, fixtures and docs). No consumer action required.
+
 ## 0.59.182
 
 Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff b50b1b48e7 4f5dd0a906 -- apps/shared/matrx-agents/src`

package/dist/content-transfer/index.cjs

@@ -703,7 +703,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.183 — no longer declared in
+   * @deprecated retiring since 0.59.185 — no longer declared in
    * aidream. It leaves this union once no snapshot within the last
    * 3 published versions still carries it as active.
    */

package/dist/content-transfer/index.js

@@ -680,7 +680,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.183 — no longer declared in
+   * @deprecated retiring since 0.59.185 — no longer declared in
    * aidream. It leaves this union once no snapshot within the last
    * 3 published versions still carries it as active.
    */

package/dist/content-transfer/react/index.cjs

@@ -656,7 +656,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.183 — no longer declared in
+   * @deprecated retiring since 0.59.185 — no longer declared in
    * aidream. It leaves this union once no snapshot within the last
    * 3 published versions still carries it as active.
    */

package/dist/content-transfer/react/index.js

@@ -628,7 +628,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.183 — no longer declared in
+   * @deprecated retiring since 0.59.185 — no longer declared in
    * aidream. It leaves this union once no snapshot within the last
    * 3 published versions still carries it as active.
    */

package/dist/mandates/index.cjs

@@ -47,9 +47,9 @@ module.exports = __toCommonJS(mandates_exports);
 
 // mandates/keys.generated.ts
 var MANDATE_KEYS_META = {
-  aidreamRevision: "9d8e39ac18990c8f2200ccc66d8d1ef3e3dba1f4",
+  aidreamRevision: "19a9da1bde4601196f8f87d1bebf787ffe529db3",
   generatorVersion: "1.0.0",
-  packageVersion: "0.59.183",
+  packageVersion: "0.59.185",
   retireWindow: 3
 };
 var MANDATE_KEYS = {
@@ -666,7 +666,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.183 — no longer declared in
+   * @deprecated retiring since 0.59.185 — no longer declared in
    * aidream. It leaves this union once no snapshot within the last
    * 3 published versions still carries it as active.
    */
@@ -693,7 +693,7 @@ var MANDATE_KEYS = {
 var ALL_MANDATE_KEYS = Object.values(MANDATE_KEYS);
 var RETIRING_MANDATE_KEYS = {
   "brand_discovery.offering_roles": "0.59.0",
-  "coding_session.managed_translation_reference": "0.59.183",
+  "coding_session.managed_translation_reference": "0.59.185",
   "pdf.content_cleaner": "0.59.0",
   "sms.owner_beta": "0.59.0",
   "voice.owner_beta": "0.59.0"

package/dist/mandates/index.d.cts

@@ -6,9 +6,9 @@
  * from the IN-PROCESS mandate declarations — the same `declared_mandates()` the
  * boot sync writes to the database from. There is no hand list anywhere.
  *
- * aidream revision:   9d8e39ac18990c8f2200ccc66d8d1ef3e3dba1f4
+ * aidream revision:   19a9da1bde4601196f8f87d1bebf787ffe529db3
  * generator version:  1.0.0
- * package version:    0.59.183
+ * package version:    0.59.185
  * active keys:        606
  * retiring keys:      5
  *
@@ -19,9 +19,9 @@
  */
 /** Where this module came from — surfaced so a report can name the exact build. */
 declare const MANDATE_KEYS_META: {
-    readonly aidreamRevision: "9d8e39ac18990c8f2200ccc66d8d1ef3e3dba1f4";
+    readonly aidreamRevision: "19a9da1bde4601196f8f87d1bebf787ffe529db3";
     readonly generatorVersion: "1.0.0";
-    readonly packageVersion: "0.59.183";
+    readonly packageVersion: "0.59.185";
     readonly retireWindow: 3;
 };
 /** Every declared mandate key, by THE IDENTIFIER RULE. */
@@ -639,7 +639,7 @@ declare const MANDATE_KEYS: {
      */
     readonly brand_discovery__offering_roles: "brand_discovery.offering_roles";
     /**
-     * @deprecated retiring since 0.59.183 — no longer declared in
+     * @deprecated retiring since 0.59.185 — no longer declared in
      * aidream. It leaves this union once no snapshot within the last
      * 3 published versions still carries it as active.
      */
@@ -670,7 +670,7 @@ declare const ALL_MANDATE_KEYS: readonly MandateKey[];
 /** Keys still in the union but no longer declared (two-phase retire, phase 1). */
 declare const RETIRING_MANDATE_KEYS: {
     readonly "brand_discovery.offering_roles": "0.59.0";
-    readonly "coding_session.managed_translation_reference": "0.59.183";
+    readonly "coding_session.managed_translation_reference": "0.59.185";
     readonly "pdf.content_cleaner": "0.59.0";
     readonly "sms.owner_beta": "0.59.0";
     readonly "voice.owner_beta": "0.59.0";

package/dist/mandates/index.d.ts

@@ -6,9 +6,9 @@
  * from the IN-PROCESS mandate declarations — the same `declared_mandates()` the
  * boot sync writes to the database from. There is no hand list anywhere.
  *
- * aidream revision:   9d8e39ac18990c8f2200ccc66d8d1ef3e3dba1f4
+ * aidream revision:   19a9da1bde4601196f8f87d1bebf787ffe529db3
  * generator version:  1.0.0
- * package version:    0.59.183
+ * package version:    0.59.185
  * active keys:        606
  * retiring keys:      5
  *
@@ -19,9 +19,9 @@
  */
 /** Where this module came from — surfaced so a report can name the exact build. */
 declare const MANDATE_KEYS_META: {
-    readonly aidreamRevision: "9d8e39ac18990c8f2200ccc66d8d1ef3e3dba1f4";
+    readonly aidreamRevision: "19a9da1bde4601196f8f87d1bebf787ffe529db3";
     readonly generatorVersion: "1.0.0";
-    readonly packageVersion: "0.59.183";
+    readonly packageVersion: "0.59.185";
     readonly retireWindow: 3;
 };
 /** Every declared mandate key, by THE IDENTIFIER RULE. */
@@ -639,7 +639,7 @@ declare const MANDATE_KEYS: {
      */
     readonly brand_discovery__offering_roles: "brand_discovery.offering_roles";
     /**
-     * @deprecated retiring since 0.59.183 — no longer declared in
+     * @deprecated retiring since 0.59.185 — no longer declared in
      * aidream. It leaves this union once no snapshot within the last
      * 3 published versions still carries it as active.
      */
@@ -670,7 +670,7 @@ declare const ALL_MANDATE_KEYS: readonly MandateKey[];
 /** Keys still in the union but no longer declared (two-phase retire, phase 1). */
 declare const RETIRING_MANDATE_KEYS: {
     readonly "brand_discovery.offering_roles": "0.59.0";
-    readonly "coding_session.managed_translation_reference": "0.59.183";
+    readonly "coding_session.managed_translation_reference": "0.59.185";
     readonly "pdf.content_cleaner": "0.59.0";
     readonly "sms.owner_beta": "0.59.0";
     readonly "voice.owner_beta": "0.59.0";

package/dist/mandates/index.js

@@ -1,8 +1,8 @@
 // mandates/keys.generated.ts
 var MANDATE_KEYS_META = {
-  aidreamRevision: "9d8e39ac18990c8f2200ccc66d8d1ef3e3dba1f4",
+  aidreamRevision: "19a9da1bde4601196f8f87d1bebf787ffe529db3",
   generatorVersion: "1.0.0",
-  packageVersion: "0.59.183",
+  packageVersion: "0.59.185",
   retireWindow: 3
 };
 var MANDATE_KEYS = {
@@ -619,7 +619,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.183 — no longer declared in
+   * @deprecated retiring since 0.59.185 — no longer declared in
    * aidream. It leaves this union once no snapshot within the last
    * 3 published versions still carries it as active.
    */
@@ -646,7 +646,7 @@ var MANDATE_KEYS = {
 var ALL_MANDATE_KEYS = Object.values(MANDATE_KEYS);
 var RETIRING_MANDATE_KEYS = {
   "brand_discovery.offering_roles": "0.59.0",
-  "coding_session.managed_translation_reference": "0.59.183",
+  "coding_session.managed_translation_reference": "0.59.185",
   "pdf.content_cleaner": "0.59.0",
   "sms.owner_beta": "0.59.0",
   "voice.owner_beta": "0.59.0"

package/dist/versions/index.cjs

@@ -24,12 +24,14 @@ __export(versions_exports, {
   AGENT_EXCLUDE_PATHS: () => AGENT_EXCLUDE_PATHS,
   AGENT_IDENTITY_KEYS: () => AGENT_IDENTITY_KEYS,
   AgentVersionsError: () => AgentVersionsError,
+  PROMOTE_HISTORY_OUTCOME: () => PROMOTE_HISTORY_OUTCOME,
   compareAgentDefinitions: () => compareAgentDefinitions,
   computeVersionFetchTargets: () => computeVersionFetchTargets,
   declareContractBreak: () => declareContractBreak,
   enrichVersions: () => enrichVersions,
   listAgentVersions: () => listAgentVersions,
   promoteAgentVersion: () => promoteAgentVersion,
+  promoteConfirmMessage: () => promoteConfirmMessage,
   promoteFailureMessage: () => promoteFailureMessage,
   promoteSuccessMessage: () => promoteSuccessMessage,
   readAgentCurrentVersion: () => readAgentCurrentVersion,
@@ -132,8 +134,13 @@ function promoteFailureMessage(err) {
   const reason = raw.trim();
   return reason ? `${GENERIC}: ${reason}` : GENERIC;
 }
+var PROMOTE_HISTORY_OUTCOME = "no new version";
+function promoteConfirmMessage(version, currentVersion) {
+  const stays = currentVersion != null ? ` v${currentVersion} stays in the history.` : "";
+  return `v${version}'s settings replace the current configuration; ${PROMOTE_HISTORY_OUTCOME} is saved.${stays}`;
+}
 function promoteSuccessMessage(version) {
-  return `v${version}'s settings are now current; no new version was saved`;
+  return `v${version}'s settings are now current; ${PROMOTE_HISTORY_OUTCOME} was saved`;
 }
 
 // versions/enrich.ts

package/dist/versions/index.d.cts

@@ -29,11 +29,17 @@ declare function compareAgentDefinitions(systemAgent: ComparableAgent, personalA
 
 declare function promoteFailureMessage(err: unknown): string;
 /**
- * The sentence a successful restore shows. `agx_promote_version` copies the version's settings onto
- * the agent and SAVES NO NEW VERSION (it sets `app.skip_version_snapshot`; read 2026-10-21), so the
- * history gains no row: the restored version becomes the current one. Saying so keeps a person from
- * looking for a new row that will never come.
+ * What a restore does to the history, said ONCE. `agx_promote_version` copies the version's settings
+ * onto the agent and SAVES NO NEW VERSION (it sets `app.skip_version_snapshot`; probed live
+ * 2026-10-21: three versions stay three rows, the agent's content equals the restored version's).
+ * The confirm dialog and the result notice both build their sentence from this one constant, so
+ * neither can promise a row the other says never came. If the database ever saves a row, change
+ * this constant and the guard test in `__tests__/promote-failure-message.test.ts` tells you where.
  */
+declare const PROMOTE_HISTORY_OUTCOME = "no new version";
+/** The sentence the confirm shows BEFORE a restore (web dialog and desktop confirm). */
+declare function promoteConfirmMessage(version: number, currentVersion?: number | null): string;
+/** The sentence a successful restore shows AFTER it ran. */
 declare function promoteSuccessMessage(version: number): string;
 
 /** One row of `agx_get_version_history`: a saved version of an agent (newest first). */
@@ -168,4 +174,4 @@ declare function declareContractBreak(client: VersionsClient, query: {
     kind: ContractBreakKind | null;
 }): Promise<void>;
 
-export { AGENT_DIFF_OPTIONS, AGENT_EXCLUDE_PATHS, AGENT_IDENTITY_KEYS, type AgentDefinitionComparison, type AgentVersionHistoryEntry, type AgentVersionLookup, AgentVersionsError, type ComparableAgent, type ContractBreakKind, type EnrichedVersion, type PromoteVersionResult, type VersionHistoryLoad, type VersionsClient, type VersionsDbError, compareAgentDefinitions, computeVersionFetchTargets, declareContractBreak, enrichVersions, listAgentVersions, promoteAgentVersion, promoteFailureMessage, promoteSuccessMessage, readAgentCurrentVersion, readAgentVersionSnapshot, resolveAgentVersionId, snapshotToComparable };
+export { AGENT_DIFF_OPTIONS, AGENT_EXCLUDE_PATHS, AGENT_IDENTITY_KEYS, type AgentDefinitionComparison, type AgentVersionHistoryEntry, type AgentVersionLookup, AgentVersionsError, type ComparableAgent, type ContractBreakKind, type EnrichedVersion, PROMOTE_HISTORY_OUTCOME, type PromoteVersionResult, type VersionHistoryLoad, type VersionsClient, type VersionsDbError, compareAgentDefinitions, computeVersionFetchTargets, declareContractBreak, enrichVersions, listAgentVersions, promoteAgentVersion, promoteConfirmMessage, promoteFailureMessage, promoteSuccessMessage, readAgentCurrentVersion, readAgentVersionSnapshot, resolveAgentVersionId, snapshotToComparable };

package/dist/versions/index.d.ts

@@ -29,11 +29,17 @@ declare function compareAgentDefinitions(systemAgent: ComparableAgent, personalA
 
 declare function promoteFailureMessage(err: unknown): string;
 /**
- * The sentence a successful restore shows. `agx_promote_version` copies the version's settings onto
- * the agent and SAVES NO NEW VERSION (it sets `app.skip_version_snapshot`; read 2026-10-21), so the
- * history gains no row: the restored version becomes the current one. Saying so keeps a person from
- * looking for a new row that will never come.
+ * What a restore does to the history, said ONCE. `agx_promote_version` copies the version's settings
+ * onto the agent and SAVES NO NEW VERSION (it sets `app.skip_version_snapshot`; probed live
+ * 2026-10-21: three versions stay three rows, the agent's content equals the restored version's).
+ * The confirm dialog and the result notice both build their sentence from this one constant, so
+ * neither can promise a row the other says never came. If the database ever saves a row, change
+ * this constant and the guard test in `__tests__/promote-failure-message.test.ts` tells you where.
  */
+declare const PROMOTE_HISTORY_OUTCOME = "no new version";
+/** The sentence the confirm shows BEFORE a restore (web dialog and desktop confirm). */
+declare function promoteConfirmMessage(version: number, currentVersion?: number | null): string;
+/** The sentence a successful restore shows AFTER it ran. */
 declare function promoteSuccessMessage(version: number): string;
 
 /** One row of `agx_get_version_history`: a saved version of an agent (newest first). */
@@ -168,4 +174,4 @@ declare function declareContractBreak(client: VersionsClient, query: {
     kind: ContractBreakKind | null;
 }): Promise<void>;
 
-export { AGENT_DIFF_OPTIONS, AGENT_EXCLUDE_PATHS, AGENT_IDENTITY_KEYS, type AgentDefinitionComparison, type AgentVersionHistoryEntry, type AgentVersionLookup, AgentVersionsError, type ComparableAgent, type ContractBreakKind, type EnrichedVersion, type PromoteVersionResult, type VersionHistoryLoad, type VersionsClient, type VersionsDbError, compareAgentDefinitions, computeVersionFetchTargets, declareContractBreak, enrichVersions, listAgentVersions, promoteAgentVersion, promoteFailureMessage, promoteSuccessMessage, readAgentCurrentVersion, readAgentVersionSnapshot, resolveAgentVersionId, snapshotToComparable };
+export { AGENT_DIFF_OPTIONS, AGENT_EXCLUDE_PATHS, AGENT_IDENTITY_KEYS, type AgentDefinitionComparison, type AgentVersionHistoryEntry, type AgentVersionLookup, AgentVersionsError, type ComparableAgent, type ContractBreakKind, type EnrichedVersion, PROMOTE_HISTORY_OUTCOME, type PromoteVersionResult, type VersionHistoryLoad, type VersionsClient, type VersionsDbError, compareAgentDefinitions, computeVersionFetchTargets, declareContractBreak, enrichVersions, listAgentVersions, promoteAgentVersion, promoteConfirmMessage, promoteFailureMessage, promoteSuccessMessage, readAgentCurrentVersion, readAgentVersionSnapshot, resolveAgentVersionId, snapshotToComparable };

package/dist/versions/index.js

@@ -91,8 +91,13 @@ function promoteFailureMessage(err) {
   const reason = raw.trim();
   return reason ? `${GENERIC}: ${reason}` : GENERIC;
 }
+var PROMOTE_HISTORY_OUTCOME = "no new version";
+function promoteConfirmMessage(version, currentVersion) {
+  const stays = currentVersion != null ? ` v${currentVersion} stays in the history.` : "";
+  return `v${version}'s settings replace the current configuration; ${PROMOTE_HISTORY_OUTCOME} is saved.${stays}`;
+}
 function promoteSuccessMessage(version) {
-  return `v${version}'s settings are now current; no new version was saved`;
+  return `v${version}'s settings are now current; ${PROMOTE_HISTORY_OUTCOME} was saved`;
 }
 
 // versions/enrich.ts
@@ -204,12 +209,14 @@ export {
   AGENT_EXCLUDE_PATHS,
   AGENT_IDENTITY_KEYS,
   AgentVersionsError,
+  PROMOTE_HISTORY_OUTCOME,
   compareAgentDefinitions,
   computeVersionFetchTargets,
   declareContractBreak,
   enrichVersions,
   listAgentVersions,
   promoteAgentVersion,
+  promoteConfirmMessage,
   promoteFailureMessage,
   promoteSuccessMessage,
   readAgentCurrentVersion,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/agents",
-  "version": "0.59.183",
+  "version": "0.59.185",
   "description": "Portable AI Matrx agent stream protocol, event projection, and safe result-presentation primitives.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -510,10 +510,10 @@
   "dependencies": {
     "@ai-matrx/alchemy": "latest",
     "@ai-matrx/api": "latest",
-    "@ai-matrx/associations": "latest",
-    "@ai-matrx/content-ir": "latest",
     "@ai-matrx/data": "latest",
     "@ai-matrx/design-system": "latest",
+    "@ai-matrx/content-ir": "latest",
+    "@ai-matrx/associations": "latest",
     "@ai-matrx/diff": "latest",
     "@ai-matrx/icons": "latest",
     "@ai-matrx/kit": "latest"
@@ -561,5 +561,5 @@
     "verify:tarball": "node ./scripts/verify-tarball.mjs",
     "typegen:self-test": "node scripts/typegen/drop-guard.self-test.mjs && node scripts/typegen/check-api-types-fresh.mjs --self-test"
   },
-  "gitHead": "9d8e39ac18990c8f2200ccc66d8d1ef3e3dba1f4"
+  "gitHead": "19a9da1bde4601196f8f87d1bebf787ffe529db3"
 }