@ai-matrx/agents 0.30.0 → 0.32.0

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

@@ -83,8 +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>;
@@ -283,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,8 +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>;
@@ -283,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

@@ -407,7 +407,7 @@ function ContextRulesTable({
   const comfortable = density === "comfortable";
   const present = GROUPS.filter((g) => rows.some((r) => r.origin === g.origin));
   const grouped = present.length > 1;
-  return /* @__PURE__ */ jsx3(TooltipProvider, { delayDuration: 300, titleTooltips: false, children: /* @__PURE__ */ jsxs3("div", { role: "table", "aria-label": "Context", "data-density": density, className: cn2("text-xs", className), children: [
+  return /* @__PURE__ */ jsx3(TooltipProvider, { delayDuration: 300, titleTooltips: false, children: /* @__PURE__ */ jsxs3("div", { role: "table", "aria-label": "Values", "data-density": density, className: cn2("text-xs", className), children: [
     /* @__PURE__ */ jsxs3(
       "div",
       {
@@ -424,7 +424,7 @@ function ContextRulesTable({
         ]
       }
     ),
-    rows.length === 0 ? /* @__PURE__ */ jsx3("div", { className: "px-2 py-3 text-center text-muted-foreground", children: "Nothing in context" }) : present.map((g) => /* @__PURE__ */ jsxs3("div", { role: "rowgroup", "aria-label": grouped ? g.label : void 0, children: [
+    rows.length === 0 ? /* @__PURE__ */ jsx3("div", { className: "px-2 py-3 text-center text-muted-foreground", children: "None" }) : present.map((g) => /* @__PURE__ */ jsxs3("div", { role: "rowgroup", "aria-label": grouped ? g.label : void 0, children: [
       grouped ? /* @__PURE__ */ jsx3(
         "div",
         {
@@ -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,
@@ -823,7 +827,14 @@ function DeliveredSection({
     setLoaded({ state: "loading" });
     load({ kind, key }).then(
       (viewed) => {
-        if (live) setLoaded({ state: "done", text: viewed.text, chars: viewed.chars });
+        if (live)
+          setLoaded({
+            state: "done",
+            text: viewed.text,
+            chars: viewed.chars,
+            available: viewed.available !== false,
+            fetched: viewed.fetched ?? null
+          });
       },
       (error) => {
         if (live)
@@ -837,12 +848,28 @@ function DeliveredSection({
       live = false;
     };
   }, [load, kind, key, attempt]);
+  const unavailable = loaded.state === "done" && !loaded.available;
   return /* @__PURE__ */ jsxs5("section", { className: "flex flex-col gap-1", "aria-label": title, "data-view-kind": kind, "data-view-key": key, children: [
     /* @__PURE__ */ jsxs5("div", { className: "flex items-baseline gap-2 text-xs", children: [
       /* @__PURE__ */ jsx5("span", { className: "font-medium", children: title }),
-      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
+      unavailable ? /* @__PURE__ */ jsx5(
+        "span",
+        {
+          "data-testid": "context-delivered-unavailable",
+          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,
+      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
     ] }),
-    !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: [
+    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 }),
       /* @__PURE__ */ jsx5(
         "button",
@@ -1100,7 +1127,7 @@ function ContextRulesPanelBody({
       Input2,
       {
         type: "search",
-        "aria-label": "Search context",
+        "aria-label": "Search values",
         placeholder: "Search",
         value: query,
         onChange: (e) => setQuery(e.target.value),