@ai-matrx/agents 0.28.1 → 0.29.1

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

@@ -50,14 +50,51 @@ interface ContextRuleResult {
     };
     clamped: boolean;
 }
-/** Text the model actually read for one value (receipt `delivered` / `on_request`). */
-interface ContextDeliveredText {
-    /** Cut at the receipt's cap; `chars` is the whole length. */
+/**
+ * What the model read for one value or block, by SIZE and HASH only — never
+ * the text (RULES.md §5b: a server-shaped value is fetched on demand, never
+ * pushed). The text comes from the viewer (`ContextViewLoader`).
+ */
+interface ContextDeliveredRef {
+    /** Code-point length of the whole text the model read. */
+    chars: number;
+    /** SHA-256 hex of that text (UTF-8). */
+    sha256: string;
+}
+/** What to view: a value's `delivered` element, its `on_request` text, or a `block`. */
+type ContextViewKind = "delivered" | "on_request" | "block";
+interface ContextViewTarget {
+    kind: ContextViewKind;
+    /** The value's key, or the block's id. */
+    key: string;
+}
+/**
+ * The exact text the model received (a sent turn: `GET /ai/context/delivered`)
+ * or will receive (the next turn: `POST /ai/context/preview` with `view`).
+ */
+interface ContextViewedText {
+    kind: ContextViewKind;
+    key: string;
     text: string;
     chars: number;
-    truncated: boolean;
-    /** SHA-256 hex of the whole text (UTF-8). */
     sha256: string;
+    source: "preview" | "wire" | "conversation_prompt" | "turn_record";
+}
+/** The host's door to the viewer API — called only when a person opens a value. */
+type ContextViewLoader = (target: ContextViewTarget) => Promise<ContextViewedText>;
+/**
+ * One block of server text the model received this turn that is not a single
+ * value — the turn's `<active_context>`, earlier-turn context, the sandbox
+ * briefing, skills, memory, the organization catalog… (receipt `blocks`,
+ * RULES.md §5). `delivered` is its exact text, cut at the receipt's cap.
+ */
+interface ContextReceiptBlock {
+    /** Stable id: the per-turn slot it rode in, or the system-prompt addition's name. */
+    id: string;
+    /** The id in words (`humanizeContextKey`). */
+    label: string;
+    /** Size and hash; the text comes from the viewer (`kind: "block"`). */
+    delivered: ContextDeliveredRef;
 }
 type ContextRowOrigin = "page" | "attached" | "system";
 /** Why the server kept a value from the model on this turn (receipt `blocked_by`). */
@@ -80,9 +117,11 @@ interface ResolvedContextRow extends Omit<ContextRuleResult, "delivery"> {
      * Display-only, from a receipt: what the model read for this value. When set,
      * a detail view shows THIS — never `value`, the client's pre-send copy.
      */
-    delivered?: ContextDeliveredText;
-    /** Display-only, from a receipt: what the `context` tool returns for it. */
-    onRequest?: ContextDeliveredText;
+    delivered?: ContextDeliveredRef;
+    /** Display-only, from a receipt: what the `context` tool returns for it (size + hash). */
+    onRequest?: ContextDeliveredRef;
+    /** Display-only, from a receipt: blocks the model received as part of this value. */
+    deliveredBlocks?: ContextReceiptBlock[];
     key: string;
     label: string;
     surfaceKey: string;
@@ -134,8 +173,13 @@ interface ContextRulesTableProps {
 declare function ContextRulesTable({ rows, cap, readOnly, mismatches, onChange, onOpenRow, density, selectedKey, className, }: ContextRulesTableProps): react.JSX.Element;
 
 interface ContextRulesChipProps {
-    /** The page's name — "Notes", "Invoice 1042". */
-    label: string;
+    /**
+     * The group's own name — "Notes", "Invoice 1042". Empty or omitted: the chip
+     * shows NO text (icon + count only). Never pass a generic word such as
+     * "Context" here — when there is no real name, there is no label (Arman,
+     * 2026-10-01).
+     */
+    label?: string | null | undefined;
     rows: readonly ResolvedContextRow[];
     cap: number;
     /** Page context on/off. Omit when there is no page: the master switch is hidden. */
@@ -167,7 +211,7 @@ declare function summarizeContextRows(rows: readonly ResolvedContextRow[]): {
     charsLabel: string;
 };
 /**
- * The composer's context chip and the surface it opens: a header (label,
+ * The composer's value-group chip — far right of the composer's one row — and the surface it opens: a header (label,
  * "N · chars" summary, page master switch, reset-all, full view) over the
  * compact rules table. Popover on desktop, bottom sheet on mobile.
  */
@@ -177,6 +221,10 @@ interface ContextRulesPanelBodyProps {
     rows: readonly ResolvedContextRow[];
     cap: number;
     mismatches?: readonly ContextReceiptMismatch[];
+    /** The latest receipt's `blocks`: listed read-only under "Also sent". */
+    blocks?: readonly ContextReceiptBlock[];
+    /** The viewer door (RULES.md §5b): fetches a value's or block's exact text when it opens. */
+    loadView?: ContextViewLoader;
     readOnly?: boolean | undefined;
     onChange: (key: string, surfaceKey: string, next: SavedContextRule | null) => void;
     /** Host content under the built-in controls (a value preview, source link…). */
@@ -192,7 +240,7 @@ interface ContextRulesPanelBodyProps {
  * the left, the open row's controls, layer breakdown and host detail on the
  * right. On mobile: list, then detail with Back.
  */
-declare function ContextRulesPanelBody({ rows, cap, mismatches, readOnly, onChange, renderDetail, isMobile, selectedKey: selectedProp, onSelectedKeyChange, className, }: ContextRulesPanelBodyProps): react.JSX.Element;
+declare function ContextRulesPanelBody({ rows, cap, mismatches, blocks, loadView, readOnly, onChange, renderDetail, isMobile, selectedKey: selectedProp, onSelectedKeyChange, className, }: ContextRulesPanelBodyProps): react.JSX.Element;
 
 interface InlineMaxInputProps {
     /** The person's own limit, or null when inherited. */
@@ -218,16 +266,47 @@ interface InlineMaxInputProps {
 declare function InlineMaxInput({ value, inherited, cap, onCommit, disabled, label, comfortable, placeholder, }: InlineMaxInputProps): react.JSX.Element;
 
 /**
- * What the model READ for one value — the receipt's `delivered` (its own
- * element in the rendered context block) and, for an on-request value, what
- * the `context` tool returns (`on_request`). Verbatim; never the client's copy.
- * With no receipt yet: a server-authoritative value (RULES.md §5a) says the
- * server fills it — never the client's guess; anything else renders nothing
- * (the host may then show the value the page will send, labelled so). §5.
+ * What the model READ for one value — fetched from the viewer when the detail
+ * opens, never pushed (RULES.md §5b): its own element (`delivered`), the blocks
+ * it rode with (`deliveredBlocks` — the Organization's catalog), and for an
+ * on-request value what the `context` tool returns (`onRequest`). Verbatim;
+ * never the client's copy. With no receipt yet: a server-authoritative value
+ * says the server fills it; anything else renders nothing (the host may show
+ * the value the page will send, labelled so).
  */
-declare function ContextDeliveredValue({ row, className, }: {
-    row: Pick<ResolvedContextRow, "key" | "delivered" | "onRequest">;
+declare function ContextDeliveredValue({ row, load, className, }: {
+    row: Pick<ResolvedContextRow, "key" | "delivered" | "onRequest" | "deliveredBlocks">;
+    /** The host's viewer door; without one, sizes show and the text reads "—". */
+    load?: ContextViewLoader | undefined;
     className?: string;
 }): react.JSX.Element | null;
+/** One viewed text: its title and size, then the exact text, fetched on mount. */
+declare function DeliveredSection({ title, target, ref_, load, }: {
+    title: string;
+    target: ContextViewTarget;
+    ref_: ContextDeliveredRef;
+    load?: ContextViewLoader | undefined;
+}): react.JSX.Element;
+
+interface ContextReceiptBlocksProps {
+    blocks: readonly ContextReceiptBlock[];
+    /** The open block (master/detail). */
+    selectedId?: string | null;
+    onOpenBlock?: (id: string) => void;
+    density?: ContextRulesDensity;
+    className?: string;
+}
+/**
+ * "Also sent" — every block of server text the model received that is not a
+ * single value (receipt `blocks`, RULES.md §5): read-only rows, label + chars,
+ * aligned to the context table's Chars column. Renders nothing when empty.
+ */
+declare function ContextReceiptBlocks({ blocks, selectedId, onOpenBlock, density, className, }: ContextReceiptBlocksProps): react.JSX.Element | null;
+/** One block's detail: its name, its size, and exactly what the agent received (on demand). */
+declare function ContextReceiptBlockDetail({ block, load, className, }: {
+    block: ContextReceiptBlock;
+    load?: ContextViewLoader | undefined;
+    className?: string;
+}): react.JSX.Element;
 
-export { ContextDeliveredValue, ContextRulesChip, type ContextRulesChipProps, type ContextRulesDensity, ContextRulesPanelBody, type ContextRulesPanelBodyProps, ContextRulesTable, type ContextRulesTableProps, InlineMaxInput, type InlineMaxInputProps, summarizeContextRows };
+export { ContextDeliveredValue, ContextReceiptBlockDetail, ContextReceiptBlocks, type ContextReceiptBlocksProps, ContextRulesChip, type ContextRulesChipProps, type ContextRulesDensity, ContextRulesPanelBody, type ContextRulesPanelBodyProps, ContextRulesTable, type ContextRulesTableProps, DeliveredSection, InlineMaxInput, type InlineMaxInputProps, summarizeContextRows };

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

@@ -50,14 +50,51 @@ interface ContextRuleResult {
     };
     clamped: boolean;
 }
-/** Text the model actually read for one value (receipt `delivered` / `on_request`). */
-interface ContextDeliveredText {
-    /** Cut at the receipt's cap; `chars` is the whole length. */
+/**
+ * What the model read for one value or block, by SIZE and HASH only — never
+ * the text (RULES.md §5b: a server-shaped value is fetched on demand, never
+ * pushed). The text comes from the viewer (`ContextViewLoader`).
+ */
+interface ContextDeliveredRef {
+    /** Code-point length of the whole text the model read. */
+    chars: number;
+    /** SHA-256 hex of that text (UTF-8). */
+    sha256: string;
+}
+/** What to view: a value's `delivered` element, its `on_request` text, or a `block`. */
+type ContextViewKind = "delivered" | "on_request" | "block";
+interface ContextViewTarget {
+    kind: ContextViewKind;
+    /** The value's key, or the block's id. */
+    key: string;
+}
+/**
+ * The exact text the model received (a sent turn: `GET /ai/context/delivered`)
+ * or will receive (the next turn: `POST /ai/context/preview` with `view`).
+ */
+interface ContextViewedText {
+    kind: ContextViewKind;
+    key: string;
     text: string;
     chars: number;
-    truncated: boolean;
-    /** SHA-256 hex of the whole text (UTF-8). */
     sha256: string;
+    source: "preview" | "wire" | "conversation_prompt" | "turn_record";
+}
+/** The host's door to the viewer API — called only when a person opens a value. */
+type ContextViewLoader = (target: ContextViewTarget) => Promise<ContextViewedText>;
+/**
+ * One block of server text the model received this turn that is not a single
+ * value — the turn's `<active_context>`, earlier-turn context, the sandbox
+ * briefing, skills, memory, the organization catalog… (receipt `blocks`,
+ * RULES.md §5). `delivered` is its exact text, cut at the receipt's cap.
+ */
+interface ContextReceiptBlock {
+    /** Stable id: the per-turn slot it rode in, or the system-prompt addition's name. */
+    id: string;
+    /** The id in words (`humanizeContextKey`). */
+    label: string;
+    /** Size and hash; the text comes from the viewer (`kind: "block"`). */
+    delivered: ContextDeliveredRef;
 }
 type ContextRowOrigin = "page" | "attached" | "system";
 /** Why the server kept a value from the model on this turn (receipt `blocked_by`). */
@@ -80,9 +117,11 @@ interface ResolvedContextRow extends Omit<ContextRuleResult, "delivery"> {
      * Display-only, from a receipt: what the model read for this value. When set,
      * a detail view shows THIS — never `value`, the client's pre-send copy.
      */
-    delivered?: ContextDeliveredText;
-    /** Display-only, from a receipt: what the `context` tool returns for it. */
-    onRequest?: ContextDeliveredText;
+    delivered?: ContextDeliveredRef;
+    /** Display-only, from a receipt: what the `context` tool returns for it (size + hash). */
+    onRequest?: ContextDeliveredRef;
+    /** Display-only, from a receipt: blocks the model received as part of this value. */
+    deliveredBlocks?: ContextReceiptBlock[];
     key: string;
     label: string;
     surfaceKey: string;
@@ -134,8 +173,13 @@ interface ContextRulesTableProps {
 declare function ContextRulesTable({ rows, cap, readOnly, mismatches, onChange, onOpenRow, density, selectedKey, className, }: ContextRulesTableProps): react.JSX.Element;
 
 interface ContextRulesChipProps {
-    /** The page's name — "Notes", "Invoice 1042". */
-    label: string;
+    /**
+     * The group's own name — "Notes", "Invoice 1042". Empty or omitted: the chip
+     * shows NO text (icon + count only). Never pass a generic word such as
+     * "Context" here — when there is no real name, there is no label (Arman,
+     * 2026-10-01).
+     */
+    label?: string | null | undefined;
     rows: readonly ResolvedContextRow[];
     cap: number;
     /** Page context on/off. Omit when there is no page: the master switch is hidden. */
@@ -167,7 +211,7 @@ declare function summarizeContextRows(rows: readonly ResolvedContextRow[]): {
     charsLabel: string;
 };
 /**
- * The composer's context chip and the surface it opens: a header (label,
+ * The composer's value-group chip — far right of the composer's one row — and the surface it opens: a header (label,
  * "N · chars" summary, page master switch, reset-all, full view) over the
  * compact rules table. Popover on desktop, bottom sheet on mobile.
  */
@@ -177,6 +221,10 @@ interface ContextRulesPanelBodyProps {
     rows: readonly ResolvedContextRow[];
     cap: number;
     mismatches?: readonly ContextReceiptMismatch[];
+    /** The latest receipt's `blocks`: listed read-only under "Also sent". */
+    blocks?: readonly ContextReceiptBlock[];
+    /** The viewer door (RULES.md §5b): fetches a value's or block's exact text when it opens. */
+    loadView?: ContextViewLoader;
     readOnly?: boolean | undefined;
     onChange: (key: string, surfaceKey: string, next: SavedContextRule | null) => void;
     /** Host content under the built-in controls (a value preview, source link…). */
@@ -192,7 +240,7 @@ interface ContextRulesPanelBodyProps {
  * the left, the open row's controls, layer breakdown and host detail on the
  * right. On mobile: list, then detail with Back.
  */
-declare function ContextRulesPanelBody({ rows, cap, mismatches, readOnly, onChange, renderDetail, isMobile, selectedKey: selectedProp, onSelectedKeyChange, className, }: ContextRulesPanelBodyProps): react.JSX.Element;
+declare function ContextRulesPanelBody({ rows, cap, mismatches, blocks, loadView, readOnly, onChange, renderDetail, isMobile, selectedKey: selectedProp, onSelectedKeyChange, className, }: ContextRulesPanelBodyProps): react.JSX.Element;
 
 interface InlineMaxInputProps {
     /** The person's own limit, or null when inherited. */
@@ -218,16 +266,47 @@ interface InlineMaxInputProps {
 declare function InlineMaxInput({ value, inherited, cap, onCommit, disabled, label, comfortable, placeholder, }: InlineMaxInputProps): react.JSX.Element;
 
 /**
- * What the model READ for one value — the receipt's `delivered` (its own
- * element in the rendered context block) and, for an on-request value, what
- * the `context` tool returns (`on_request`). Verbatim; never the client's copy.
- * With no receipt yet: a server-authoritative value (RULES.md §5a) says the
- * server fills it — never the client's guess; anything else renders nothing
- * (the host may then show the value the page will send, labelled so). §5.
+ * What the model READ for one value — fetched from the viewer when the detail
+ * opens, never pushed (RULES.md §5b): its own element (`delivered`), the blocks
+ * it rode with (`deliveredBlocks` — the Organization's catalog), and for an
+ * on-request value what the `context` tool returns (`onRequest`). Verbatim;
+ * never the client's copy. With no receipt yet: a server-authoritative value
+ * says the server fills it; anything else renders nothing (the host may show
+ * the value the page will send, labelled so).
  */
-declare function ContextDeliveredValue({ row, className, }: {
-    row: Pick<ResolvedContextRow, "key" | "delivered" | "onRequest">;
+declare function ContextDeliveredValue({ row, load, className, }: {
+    row: Pick<ResolvedContextRow, "key" | "delivered" | "onRequest" | "deliveredBlocks">;
+    /** The host's viewer door; without one, sizes show and the text reads "—". */
+    load?: ContextViewLoader | undefined;
     className?: string;
 }): react.JSX.Element | null;
+/** One viewed text: its title and size, then the exact text, fetched on mount. */
+declare function DeliveredSection({ title, target, ref_, load, }: {
+    title: string;
+    target: ContextViewTarget;
+    ref_: ContextDeliveredRef;
+    load?: ContextViewLoader | undefined;
+}): react.JSX.Element;
+
+interface ContextReceiptBlocksProps {
+    blocks: readonly ContextReceiptBlock[];
+    /** The open block (master/detail). */
+    selectedId?: string | null;
+    onOpenBlock?: (id: string) => void;
+    density?: ContextRulesDensity;
+    className?: string;
+}
+/**
+ * "Also sent" — every block of server text the model received that is not a
+ * single value (receipt `blocks`, RULES.md §5): read-only rows, label + chars,
+ * aligned to the context table's Chars column. Renders nothing when empty.
+ */
+declare function ContextReceiptBlocks({ blocks, selectedId, onOpenBlock, density, className, }: ContextReceiptBlocksProps): react.JSX.Element | null;
+/** One block's detail: its name, its size, and exactly what the agent received (on demand). */
+declare function ContextReceiptBlockDetail({ block, load, className, }: {
+    block: ContextReceiptBlock;
+    load?: ContextViewLoader | undefined;
+    className?: string;
+}): react.JSX.Element;
 
-export { ContextDeliveredValue, ContextRulesChip, type ContextRulesChipProps, type ContextRulesDensity, ContextRulesPanelBody, type ContextRulesPanelBodyProps, ContextRulesTable, type ContextRulesTableProps, InlineMaxInput, type InlineMaxInputProps, summarizeContextRows };
+export { ContextDeliveredValue, ContextReceiptBlockDetail, ContextReceiptBlocks, type ContextReceiptBlocksProps, ContextRulesChip, type ContextRulesChipProps, type ContextRulesDensity, ContextRulesPanelBody, type ContextRulesPanelBodyProps, ContextRulesTable, type ContextRulesTableProps, DeliveredSection, InlineMaxInput, type InlineMaxInputProps, summarizeContextRows };