@ai-matrx/agents 0.31.0 → 0.33.0

package/dist/context/react/index.d.cts

@@ -83,14 +83,25 @@ interface ContextViewedText {
     text: string;
     chars: number;
     sha256: string;
-    /** `fetched_now`: a `fetchable` text — what the agent gets if it asks now. */
-    source: "preview" | "wire" | "conversation_prompt" | "turn_record" | "fetched_now";
+    /**
+     * `fetched_now`: read at request time — a `fetchable` text (what the agent
+     * gets if it asks now) or a lazy `on_request` value the agent never read.
+     * `tool_result`: exactly what the `context` tool returned to the agent.
+     */
+    source: "preview" | "wire" | "conversation_prompt" | "turn_record" | "fetched_now" | "tool_result";
     /**
      * `fetchable` only: `false` when the turn's agent cannot call the tool that
      * returns it (tools off, excluded, a structured-output turn). `text` is then
      * `""`; the screen says so with state, never shows content as fetchable.
      */
     available?: boolean;
+    /**
+     * A lazy `on_request` value of a SENT turn only (a document, a file family,
+     * a scope — the turn never reads one): `true` — the agent called `context`
+     * for it and `text` is what the tool returned; `false` — the agent never
+     * read it and `text` is what it returns now (the screen says so).
+     */
+    fetched?: boolean | null;
 }
 /** The host's door to the viewer API — called only when a person opens a value. */
 type ContextViewLoader = (target: ContextViewTarget) => Promise<ContextViewedText>;
@@ -289,7 +300,7 @@ declare function InlineMaxInput({ value, inherited, cap, onCommit, disabled, lab
  * the value the page will send, labelled so).
  */
 declare function ContextDeliveredValue({ row, load, className, }: {
-    row: Pick<ResolvedContextRow, "key" | "delivered" | "onRequest" | "deliveredBlocks">;
+    row: Pick<ResolvedContextRow, "key" | "delivered" | "onRequest" | "deliveredBlocks"> & Partial<Pick<ResolvedContextRow, "delivery">>;
     /** The host's viewer door; without one, sizes show and the text reads "—". */
     load?: ContextViewLoader | undefined;
     className?: string;

package/dist/context/react/index.d.ts

@@ -83,14 +83,25 @@ interface ContextViewedText {
     text: string;
     chars: number;
     sha256: string;
-    /** `fetched_now`: a `fetchable` text — what the agent gets if it asks now. */
-    source: "preview" | "wire" | "conversation_prompt" | "turn_record" | "fetched_now";
+    /**
+     * `fetched_now`: read at request time — a `fetchable` text (what the agent
+     * gets if it asks now) or a lazy `on_request` value the agent never read.
+     * `tool_result`: exactly what the `context` tool returned to the agent.
+     */
+    source: "preview" | "wire" | "conversation_prompt" | "turn_record" | "fetched_now" | "tool_result";
     /**
      * `fetchable` only: `false` when the turn's agent cannot call the tool that
      * returns it (tools off, excluded, a structured-output turn). `text` is then
      * `""`; the screen says so with state, never shows content as fetchable.
      */
     available?: boolean;
+    /**
+     * A lazy `on_request` value of a SENT turn only (a document, a file family,
+     * a scope — the turn never reads one): `true` — the agent called `context`
+     * for it and `text` is what the tool returned; `false` — the agent never
+     * read it and `text` is what it returns now (the screen says so).
+     */
+    fetched?: boolean | null;
 }
 /** The host's door to the viewer API — called only when a person opens a value. */
 type ContextViewLoader = (target: ContextViewTarget) => Promise<ContextViewedText>;
@@ -289,7 +300,7 @@ declare function InlineMaxInput({ value, inherited, cap, onCommit, disabled, lab
  * the value the page will send, labelled so).
  */
 declare function ContextDeliveredValue({ row, load, className, }: {
-    row: Pick<ResolvedContextRow, "key" | "delivered" | "onRequest" | "deliveredBlocks">;
+    row: Pick<ResolvedContextRow, "key" | "delivered" | "onRequest" | "deliveredBlocks"> & Partial<Pick<ResolvedContextRow, "delivery">>;
     /** The host's viewer door; without one, sizes show and the text reads "—". */
     load?: ContextViewLoader | undefined;
     className?: string;

package/dist/context/react/index.js

@@ -789,14 +789,18 @@ function ContextDeliveredValue({
       },
       block.id
     )),
-    row.onRequest ? /* @__PURE__ */ jsx5(
-      DeliveredSection,
-      {
-        title: "Returned on request",
-        target: { kind: "on_request", key: row.key },
-        ref_: row.onRequest,
-        load
-      }
+    row.onRequest || row.delivery === "on_request" && row.delivered ? (
+      // A lazy value (a document, a file family …) carries no ref: the turn never reads
+      // it. It is fetched — and sized — when opened.
+      /* @__PURE__ */ jsx5(
+        DeliveredSection,
+        {
+          title: "Returned on request",
+          target: { kind: "on_request", key: row.key },
+          ref_: row.onRequest,
+          load
+        }
+      )
     ) : null,
     row.delivered && CONTEXT_FETCHABLE_ROWS[row.key] ? /* @__PURE__ */ jsx5(
       DeliveredSection,
@@ -828,7 +832,8 @@ function DeliveredSection({
             state: "done",
             text: viewed.text,
             chars: viewed.chars,
-            available: viewed.available !== false
+            available: viewed.available !== false,
+            fetched: viewed.fetched ?? null
           });
       },
       (error) => {
@@ -854,7 +859,15 @@ function DeliveredSection({
           className: "rounded border border-border px-1.5 text-[11px] text-muted-foreground",
           children: "Not available to this agent"
         }
-      ) : ref_ || loaded.state === "done" ? /* @__PURE__ */ jsx5("span", { className: "tabular-nums text-muted-foreground", children: `${formatChars(ref_ ? ref_.chars : loaded.state === "done" ? loaded.chars : 0)} chars` }) : null
+      ) : ref_ || loaded.state === "done" ? /* @__PURE__ */ jsx5("span", { className: "tabular-nums text-muted-foreground", children: `${formatChars(ref_ ? ref_.chars : loaded.state === "done" ? loaded.chars : 0)} chars` }) : null,
+      loaded.state === "done" && loaded.fetched === false ? /* @__PURE__ */ jsx5(
+        "span",
+        {
+          "data-testid": "context-delivered-not-read",
+          className: "rounded border border-border px-1.5 text-[11px] text-muted-foreground",
+          children: "Not read by the agent"
+        }
+      ) : null
     ] }),
     unavailable ? null : !load ? /* @__PURE__ */ jsx5("span", { className: "text-xs text-muted-foreground", children: "\u2014" }) : loaded.state === "loading" ? /* @__PURE__ */ jsx5(Skeleton, { "data-testid": "context-delivered-loading", className: "h-16 w-full" }) : loaded.state === "error" ? /* @__PURE__ */ jsxs5(ErrorBox, { as: "div", message: loaded.message, className: "flex items-center gap-2 text-xs text-destructive", children: [
       /* @__PURE__ */ jsx5("span", { className: "min-w-0 truncate", title: loaded.message, children: loaded.message }),