@ai-matrx/agents 0.59.168 → 0.59.169

package/CHANGELOG.md

@@ -4,11 +4,16 @@
 
 - **`toolPriceText` returns null for a zero-cost tool instead of "Free" (2026-10-18, law 14: no "Free").** Positive hints still read "N pts". Consumer action: none (callers already handle null).
 
-## 0.59.168
+## 0.59.169
 
 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.168
+
+Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 5535e3bb42 cae8c2b935 -- apps/shared/matrx-agents/src`
+has no shipped-source changes outside tests, fixtures and docs). No consumer action required.
+
 ## 0.59.167
 
 Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff b25bc946cc 5535e3bb42 -- apps/shared/matrx-agents/src`

package/dist/content-transfer/index.cjs

@@ -651,6 +651,7 @@ var MANDATE_KEYS = {
   table__column_fill_image: "table.column_fill_image",
   tasks__triage: "tasks.triage",
   tool_viz__component_generator: "tool_viz.component_generator",
+  tools__describe_to_form: "tools.describe_to_form",
   tools__summarize_content: "tools.summarize_content",
   transcript_studio__document_edit: "transcript_studio.document_edit",
   transcript_studio__scribe_live: "transcript_studio.scribe_live",
@@ -702,7 +703,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.168 — no longer declared in
+   * @deprecated retiring since 0.59.169 — 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

@@ -628,6 +628,7 @@ var MANDATE_KEYS = {
   table__column_fill_image: "table.column_fill_image",
   tasks__triage: "tasks.triage",
   tool_viz__component_generator: "tool_viz.component_generator",
+  tools__describe_to_form: "tools.describe_to_form",
   tools__summarize_content: "tools.summarize_content",
   transcript_studio__document_edit: "transcript_studio.document_edit",
   transcript_studio__scribe_live: "transcript_studio.scribe_live",
@@ -679,7 +680,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.168 — no longer declared in
+   * @deprecated retiring since 0.59.169 — 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

@@ -604,6 +604,7 @@ var MANDATE_KEYS = {
   table__column_fill_image: "table.column_fill_image",
   tasks__triage: "tasks.triage",
   tool_viz__component_generator: "tool_viz.component_generator",
+  tools__describe_to_form: "tools.describe_to_form",
   tools__summarize_content: "tools.summarize_content",
   transcript_studio__document_edit: "transcript_studio.document_edit",
   transcript_studio__scribe_live: "transcript_studio.scribe_live",
@@ -655,7 +656,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.168 — no longer declared in
+   * @deprecated retiring since 0.59.169 — 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

@@ -576,6 +576,7 @@ var MANDATE_KEYS = {
   table__column_fill_image: "table.column_fill_image",
   tasks__triage: "tasks.triage",
   tool_viz__component_generator: "tool_viz.component_generator",
+  tools__describe_to_form: "tools.describe_to_form",
   tools__summarize_content: "tools.summarize_content",
   transcript_studio__document_edit: "transcript_studio.document_edit",
   transcript_studio__scribe_live: "transcript_studio.scribe_live",
@@ -627,7 +628,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.168 — no longer declared in
+   * @deprecated retiring since 0.59.169 — 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: "cae8c2b935815df1aeca187980cbf5b4565e07ed",
+  aidreamRevision: "e9c25acd070fae3e6f85b1bce3abc175429d6d03",
   generatorVersion: "1.0.0",
-  packageVersion: "0.59.168",
+  packageVersion: "0.59.169",
   retireWindow: 3
 };
 var MANDATE_KEYS = {
@@ -614,6 +614,7 @@ var MANDATE_KEYS = {
   table__column_fill_image: "table.column_fill_image",
   tasks__triage: "tasks.triage",
   tool_viz__component_generator: "tool_viz.component_generator",
+  tools__describe_to_form: "tools.describe_to_form",
   tools__summarize_content: "tools.summarize_content",
   transcript_studio__document_edit: "transcript_studio.document_edit",
   transcript_studio__scribe_live: "transcript_studio.scribe_live",
@@ -665,7 +666,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.168 — no longer declared in
+   * @deprecated retiring since 0.59.169 — no longer declared in
    * aidream. It leaves this union once no snapshot within the last
    * 3 published versions still carries it as active.
    */
@@ -692,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.168",
+  "coding_session.managed_translation_reference": "0.59.169",
   "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,10 +6,10 @@
  * 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:   cae8c2b935815df1aeca187980cbf5b4565e07ed
+ * aidream revision:   e9c25acd070fae3e6f85b1bce3abc175429d6d03
  * generator version:  1.0.0
- * package version:    0.59.168
- * active keys:        605
+ * package version:    0.59.169
+ * active keys:        606
  * retiring keys:      5
  *
  * THE IDENTIFIER RULE: every `.` in a key becomes `__`, any character outside
@@ -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: "cae8c2b935815df1aeca187980cbf5b4565e07ed";
+    readonly aidreamRevision: "e9c25acd070fae3e6f85b1bce3abc175429d6d03";
     readonly generatorVersion: "1.0.0";
-    readonly packageVersion: "0.59.168";
+    readonly packageVersion: "0.59.169";
     readonly retireWindow: 3;
 };
 /** Every declared mandate key, by THE IDENTIFIER RULE. */
@@ -587,6 +587,7 @@ declare const MANDATE_KEYS: {
     readonly table__column_fill_image: "table.column_fill_image";
     readonly tasks__triage: "tasks.triage";
     readonly tool_viz__component_generator: "tool_viz.component_generator";
+    readonly tools__describe_to_form: "tools.describe_to_form";
     readonly tools__summarize_content: "tools.summarize_content";
     readonly transcript_studio__document_edit: "transcript_studio.document_edit";
     readonly transcript_studio__scribe_live: "transcript_studio.scribe_live";
@@ -638,7 +639,7 @@ declare const MANDATE_KEYS: {
      */
     readonly brand_discovery__offering_roles: "brand_discovery.offering_roles";
     /**
-     * @deprecated retiring since 0.59.168 — no longer declared in
+     * @deprecated retiring since 0.59.169 — no longer declared in
      * aidream. It leaves this union once no snapshot within the last
      * 3 published versions still carries it as active.
      */
@@ -669,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.168";
+    readonly "coding_session.managed_translation_reference": "0.59.169";
     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,10 +6,10 @@
  * 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:   cae8c2b935815df1aeca187980cbf5b4565e07ed
+ * aidream revision:   e9c25acd070fae3e6f85b1bce3abc175429d6d03
  * generator version:  1.0.0
- * package version:    0.59.168
- * active keys:        605
+ * package version:    0.59.169
+ * active keys:        606
  * retiring keys:      5
  *
  * THE IDENTIFIER RULE: every `.` in a key becomes `__`, any character outside
@@ -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: "cae8c2b935815df1aeca187980cbf5b4565e07ed";
+    readonly aidreamRevision: "e9c25acd070fae3e6f85b1bce3abc175429d6d03";
     readonly generatorVersion: "1.0.0";
-    readonly packageVersion: "0.59.168";
+    readonly packageVersion: "0.59.169";
     readonly retireWindow: 3;
 };
 /** Every declared mandate key, by THE IDENTIFIER RULE. */
@@ -587,6 +587,7 @@ declare const MANDATE_KEYS: {
     readonly table__column_fill_image: "table.column_fill_image";
     readonly tasks__triage: "tasks.triage";
     readonly tool_viz__component_generator: "tool_viz.component_generator";
+    readonly tools__describe_to_form: "tools.describe_to_form";
     readonly tools__summarize_content: "tools.summarize_content";
     readonly transcript_studio__document_edit: "transcript_studio.document_edit";
     readonly transcript_studio__scribe_live: "transcript_studio.scribe_live";
@@ -638,7 +639,7 @@ declare const MANDATE_KEYS: {
      */
     readonly brand_discovery__offering_roles: "brand_discovery.offering_roles";
     /**
-     * @deprecated retiring since 0.59.168 — no longer declared in
+     * @deprecated retiring since 0.59.169 — no longer declared in
      * aidream. It leaves this union once no snapshot within the last
      * 3 published versions still carries it as active.
      */
@@ -669,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.168";
+    readonly "coding_session.managed_translation_reference": "0.59.169";
     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: "cae8c2b935815df1aeca187980cbf5b4565e07ed",
+  aidreamRevision: "e9c25acd070fae3e6f85b1bce3abc175429d6d03",
   generatorVersion: "1.0.0",
-  packageVersion: "0.59.168",
+  packageVersion: "0.59.169",
   retireWindow: 3
 };
 var MANDATE_KEYS = {
@@ -567,6 +567,7 @@ var MANDATE_KEYS = {
   table__column_fill_image: "table.column_fill_image",
   tasks__triage: "tasks.triage",
   tool_viz__component_generator: "tool_viz.component_generator",
+  tools__describe_to_form: "tools.describe_to_form",
   tools__summarize_content: "tools.summarize_content",
   transcript_studio__document_edit: "transcript_studio.document_edit",
   transcript_studio__scribe_live: "transcript_studio.scribe_live",
@@ -618,7 +619,7 @@ var MANDATE_KEYS = {
    */
   brand_discovery__offering_roles: "brand_discovery.offering_roles",
   /**
-   * @deprecated retiring since 0.59.168 — no longer declared in
+   * @deprecated retiring since 0.59.169 — no longer declared in
    * aidream. It leaves this union once no snapshot within the last
    * 3 published versions still carries it as active.
    */
@@ -645,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.168",
+  "coding_session.managed_translation_reference": "0.59.169",
   "pdf.content_cleaner": "0.59.0",
   "sms.owner_beta": "0.59.0",
   "voice.owner_beta": "0.59.0"

package/dist/models/index.cjs

@@ -1796,7 +1796,7 @@ function memoryLine(v, device, fits) {
   const share = device.fit_fraction < 1 && fits === false ? ` (models may use ${formatMemoryBytes(device.memory_bytes * device.fit_fraction)} of it)` : "";
   return `Needs ${formatMemoryBytes(need)}; this computer has ${formatMemoryBytes(device.memory_bytes)}${share}`;
 }
-function judge(v, want, device, runtimes, checkFormat) {
+function judge(v, device, runtimes, checkFormat) {
   const out = (code, reasons, candidate = null) => ({ variant: v, usable: code === null, reasons, code, candidate });
   const d = v.discovery;
   if (d?.problems.length) return out("incomplete", [...d.problems, memoryLine(v, device, null)]);
@@ -1845,7 +1845,7 @@ function asCandidate(j) {
 function judgeAll(model, want, device, runtimes) {
   const checkFormat = runtimes.length > 0 || device !== null;
   const list = want.variant_policy === "exact" ? model.variants.filter((x) => x.key === want.variant_key) : model.variants;
-  return list.map((v) => judge(v, want, device, runtimes, checkFormat));
+  return list.map((v) => judge(v, device, runtimes, checkFormat));
 }
 function rankVariants(model, want, device, runtimes) {
   const judged = judgeAll(model, want, device, runtimes);
@@ -2041,15 +2041,15 @@ var MAX_COUNT = 1e6;
 var MAX_STRING = 64 * 1024 * 1024;
 var MAX_DIMS = 8;
 var Cursor = class {
+  buf = new Uint8Array(0);
+  base = 0;
+  read;
+  size;
+  pos = 0;
   constructor(read, size) {
     this.read = read;
     this.size = size;
   }
-  read;
-  size;
-  buf = new Uint8Array(0);
-  base = 0;
-  pos = 0;
   async need(n) {
     if (this.pos + n > this.size) throw new GgufError("the file ends inside its header");
     if (this.pos + n > MAX_HEADER) throw new GgufError("its header is larger than any real model's");

package/dist/models/index.js

@@ -1657,7 +1657,7 @@ function memoryLine(v, device, fits) {
   const share = device.fit_fraction < 1 && fits === false ? ` (models may use ${formatMemoryBytes(device.memory_bytes * device.fit_fraction)} of it)` : "";
   return `Needs ${formatMemoryBytes(need)}; this computer has ${formatMemoryBytes(device.memory_bytes)}${share}`;
 }
-function judge(v, want, device, runtimes, checkFormat) {
+function judge(v, device, runtimes, checkFormat) {
   const out = (code, reasons, candidate = null) => ({ variant: v, usable: code === null, reasons, code, candidate });
   const d = v.discovery;
   if (d?.problems.length) return out("incomplete", [...d.problems, memoryLine(v, device, null)]);
@@ -1706,7 +1706,7 @@ function asCandidate(j) {
 function judgeAll(model, want, device, runtimes) {
   const checkFormat = runtimes.length > 0 || device !== null;
   const list = want.variant_policy === "exact" ? model.variants.filter((x) => x.key === want.variant_key) : model.variants;
-  return list.map((v) => judge(v, want, device, runtimes, checkFormat));
+  return list.map((v) => judge(v, device, runtimes, checkFormat));
 }
 function rankVariants(model, want, device, runtimes) {
   const judged = judgeAll(model, want, device, runtimes);
@@ -1902,15 +1902,15 @@ var MAX_COUNT = 1e6;
 var MAX_STRING = 64 * 1024 * 1024;
 var MAX_DIMS = 8;
 var Cursor = class {
+  buf = new Uint8Array(0);
+  base = 0;
+  read;
+  size;
+  pos = 0;
   constructor(read, size) {
     this.read = read;
     this.size = size;
   }
-  read;
-  size;
-  buf = new Uint8Array(0);
-  base = 0;
-  pos = 0;
   async need(n) {
     if (this.pos + n > this.size) throw new GgufError("the file ends inside its header");
     if (this.pos + n > MAX_HEADER) throw new GgufError("its header is larger than any real model's");

package/dist/models/react/index.cjs

@@ -2308,7 +2308,7 @@ function memoryLine(v, device, fits) {
   const share = device.fit_fraction < 1 && fits === false ? ` (models may use ${formatMemoryBytes(device.memory_bytes * device.fit_fraction)} of it)` : "";
   return `Needs ${formatMemoryBytes(need)}; this computer has ${formatMemoryBytes(device.memory_bytes)}${share}`;
 }
-function judge(v, want, device, runtimes, checkFormat) {
+function judge(v, device, runtimes, checkFormat) {
   const out = (code, reasons, candidate = null) => ({ variant: v, usable: code === null, reasons, code, candidate });
   const d = v.discovery;
   if (d?.problems.length) return out("incomplete", [...d.problems, memoryLine(v, device, null)]);
@@ -2357,7 +2357,7 @@ function asCandidate(j) {
 function judgeAll(model, want, device, runtimes) {
   const checkFormat = runtimes.length > 0 || device !== null;
   const list = want.variant_policy === "exact" ? model.variants.filter((x) => x.key === want.variant_key) : model.variants;
-  return list.map((v) => judge(v, want, device, runtimes, checkFormat));
+  return list.map((v) => judge(v, device, runtimes, checkFormat));
 }
 function rankVariants(model, want, device, runtimes) {
   const judged = judgeAll(model, want, device, runtimes);

package/dist/models/react/index.js

@@ -2290,7 +2290,7 @@ function memoryLine(v, device, fits) {
   const share = device.fit_fraction < 1 && fits === false ? ` (models may use ${formatMemoryBytes(device.memory_bytes * device.fit_fraction)} of it)` : "";
   return `Needs ${formatMemoryBytes(need)}; this computer has ${formatMemoryBytes(device.memory_bytes)}${share}`;
 }
-function judge(v, want, device, runtimes, checkFormat) {
+function judge(v, device, runtimes, checkFormat) {
   const out = (code, reasons, candidate = null) => ({ variant: v, usable: code === null, reasons, code, candidate });
   const d = v.discovery;
   if (d?.problems.length) return out("incomplete", [...d.problems, memoryLine(v, device, null)]);
@@ -2339,7 +2339,7 @@ function asCandidate(j) {
 function judgeAll(model, want, device, runtimes) {
   const checkFormat = runtimes.length > 0 || device !== null;
   const list = want.variant_policy === "exact" ? model.variants.filter((x) => x.key === want.variant_key) : model.variants;
-  return list.map((v) => judge(v, want, device, runtimes, checkFormat));
+  return list.map((v) => judge(v, device, runtimes, checkFormat));
 }
 function rankVariants(model, want, device, runtimes) {
   const judged = judgeAll(model, want, device, runtimes);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/agents",
-  "version": "0.59.168",
+  "version": "0.59.169",
   "description": "Portable AI Matrx agent stream protocol, event projection, and safe result-presentation primitives.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -492,8 +492,8 @@
     "@ai-matrx/api": "latest",
     "@ai-matrx/associations": "latest",
     "@ai-matrx/content-ir": "latest",
-    "@ai-matrx/data": "latest",
     "@ai-matrx/design-system": "latest",
+    "@ai-matrx/data": "latest",
     "@ai-matrx/icons": "latest",
     "@ai-matrx/kit": "latest"
   },
@@ -540,5 +540,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": "cae8c2b935815df1aeca187980cbf5b4565e07ed"
+  "gitHead": "e9c25acd070fae3e6f85b1bce3abc175429d6d03"
 }