@ai-matrx/chat 0.7.15 → 0.7.17

package/CHANGELOG.md

@@ -1,6 +1,29 @@
 # @ai-matrx/chat
 
+## 0.7.17
+### Unreleased
+### a turn carries what the person attached (lane A1, Applet builder)
+
+- **`runHeadlessAgentJson({ resources })`** and **`continueAgentJson({ resources })`**: the person's "+" picks (`Resource[]`) go
+  through THE attach path (`attachResourceToConversation`) on the turn's conversation before it executes — a stored file by its
+  file id (`processed_document` in request.context, then the server's `file → conversation` edge), every other kind as its typed
+  resource block. Never the message (THE USER-INPUT LAW). A pick that cannot be attached fails the turn naming it.
+  New export `attachTurnResources`. Tests: `a-turn-carries-what-the-person-attached.test.ts`.
+- **Consumer action:** none (additive options).
+
+## 0.7.16
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/chat/v0.7.15..npm/chat/v0.7.16 -- apps/shared/chat`).
+No source changes intended and no consumer action required.
+
 ## 0.7.15
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/chat/v0.7.14..npm/chat/v0.7.15 -- apps/shared/chat`).
+No source changes intended and no consumer action required.
+
+## 0.7.14
 ### Unreleased
 ### An answer never paints header-first (spend register item 32, cold-load CLS at 1280/1440/1920)
 

package/dist/agents/components/messages-display/AgentConversationDisplay.js

@@ -1,7 +1,7 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useConversationAbilities } from "../../redux/execution-system/host-conversations/conversation-abilities.js";
-import { useEffect, useMemo, useRef, useState } from "react";
+import { Fragment, useEffect, useMemo, useRef, useState } from "react";
 import { useAppDispatch, useAppSelector } from "../../../store/hooks.js";
 import { loadConversation } from "../../redux/execution-system/thunks/load-conversation.thunk.js";
 import { StaleDataNotice } from "../../../host/ui-slots.js";
@@ -48,6 +48,8 @@ import { FollowUpSuggestions } from "./conversation-tools/FollowUpSuggestions.js
 import { groupMessageIds, groupsToRender } from "./conversation-tools/pinned-filter.js";
 import { loadFullConversationHistory } from "../../conversation-export/load-full-history.js";
 import { useMessageListInteractions } from "./conversation-tools/useMessageListInteractions.js";
+import { useTranscriptLayout } from "../shared/transcript-layout.js";
+import { timeGroupLabel, timeGroupStarts } from "./time-groups.js";
 import { Button } from "@ai-matrx/design-system/controls";
 function AgentConversationDisplay({
   conversationId,
@@ -132,6 +134,17 @@ function AgentConversationDisplay({
     pinnedOnly,
     pinned: pinnedIds
   });
+  const { timestamps } = useTranscriptLayout();
+  const groupTimes = useMemo(() => {
+    if (timestamps !== "grouped") return null;
+    const at = new Map(messages.map((m) => [m.id, Date.parse(m.createdAt)]));
+    const timed = visibleGroups.map((g) => {
+      const first = groupMessageIds(g).map((id) => at.get(id)).find((t) => t !== void 0 && Number.isFinite(t));
+      return { key: g.key, atMs: first ?? null };
+    });
+    const starts = timeGroupStarts(timed);
+    return new Map(timed.filter((t) => starts.has(t.key) && t.atMs !== null).map((t) => [t.key, t.atMs]));
+  }, [timestamps, messages, visibleGroups]);
   let latestAssistantKey;
   for (let i = displayGroups.length - 1; i >= 0; i--) {
     if (displayGroups[i].kind === "assistant") {
@@ -392,9 +405,19 @@ function AgentConversationDisplay({
             "aria-label": "Conversation",
             className: `${spacingClass} p-2 scrollbar-hide ${bottomPinned ? "min-h-full flex flex-col justify-end" : ""}`,
             children: [
-              visibleGroups.map(
-                (group, index) => wrapGroup(group, index, renderGroupBody(group))
-              ),
+              visibleGroups.map((group, index) => {
+                const at = groupTimes?.get(group.key);
+                if (at === void 0) return wrapGroup(group, index, renderGroupBody(group));
+                const label = timeGroupLabel(at);
+                return /* @__PURE__ */ jsxs(Fragment, { children: [
+                  /* @__PURE__ */ jsxs("div", { "data-time-group": "", className: "pt-2 text-center text-[11px] leading-[14px] text-muted-foreground", role: "separator", "aria-label": `${label.day} ${label.time}`, children: [
+                    /* @__PURE__ */ jsx("span", { className: "font-semibold", children: label.day }),
+                    " ",
+                    label.time
+                  ] }),
+                  wrapGroup(group, index, renderGroupBody(group))
+                ] }, group.key);
+              }),
               pinnedOnly && visibleGroups.length === 0 && /* @__PURE__ */ jsxs("div", { className: "py-10 text-center text-sm text-muted-foreground", children: [
                 "Nothing pinned in this conversation.",
                 " ",

package/dist/agents/components/messages-display/time-groups.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Messages' time grouping (the transcript layout's `timestamps: "grouped"`): a centred line over the
+ * first message and over any message that follows an hour's quiet — "Today 9:41 AM",
+ * "Yesterday 4:02 PM", "Monday 9:41 AM" within the week, "Oct 6, 2026 at 9:41 AM" before it.
+ */
+/** Quiet this long between two messages starts a new time group (Messages: about an hour). */
+export declare const TIME_GROUP_GAP_MS: number;
+/** The keys of the groups that open a time group: the first, and each after `gapMs` of quiet. */
+export declare function timeGroupStarts(groups: ReadonlyArray<{
+    key: string;
+    atMs: number | null;
+}>, gapMs?: number): Set<string>;
+/** The line's two parts, Messages' way: the day (drawn bold) and the time. */
+export declare function timeGroupLabel(atMs: number, nowMs?: number, locale?: string): {
+    day: string;
+    time: string;
+};

package/dist/agents/components/messages-display/time-groups.js

@@ -0,0 +1,29 @@
+const TIME_GROUP_GAP_MS = 60 * 6e4;
+function timeGroupStarts(groups, gapMs = TIME_GROUP_GAP_MS) {
+  const starts = /* @__PURE__ */ new Set();
+  let last = null;
+  for (const g of groups) {
+    if (g.atMs === null) continue;
+    if (last === null || g.atMs - last >= gapMs) starts.add(g.key);
+    last = g.atMs;
+  }
+  return starts;
+}
+const startOfDay = (ms) => {
+  const d = new Date(ms);
+  d.setHours(0, 0, 0, 0);
+  return d.getTime();
+};
+function timeGroupLabel(atMs, nowMs = Date.now(), locale) {
+  const time = new Date(atMs).toLocaleTimeString(locale, { hour: "numeric", minute: "2-digit" });
+  const days = Math.round((startOfDay(nowMs) - startOfDay(atMs)) / 864e5);
+  if (days <= 0) return { day: "Today", time };
+  if (days === 1) return { day: "Yesterday", time };
+  if (days < 7) return { day: new Date(atMs).toLocaleDateString(locale, { weekday: "long" }), time };
+  return { day: new Date(atMs).toLocaleDateString(locale, { month: "short", day: "numeric", year: "numeric" }), time: `at ${time}` };
+}
+export {
+  TIME_GROUP_GAP_MS,
+  timeGroupLabel,
+  timeGroupStarts
+};

package/dist/agents/components/shared/transcript-layout.d.ts

@@ -22,6 +22,12 @@ export interface TranscriptLayout {
     align?: "center" | "start";
     userMessage?: "card" | "compact" | "bubble";
     answerActions?: "shown" | "latest" | "hover";
+    /**
+     * When each message was sent: `hover` (the web chat: the time at the end of an answer's action
+     * row, shown on hover) or `grouped` (Messages, Xcode's coding assistant: a centred "Today 9:41 AM"
+     * line over the first message and over any that follow an hour's quiet).
+     */
+    timestamps?: "hover" | "grouped";
 }
 export declare const DEFAULT_TRANSCRIPT_LAYOUT: Required<TranscriptLayout>;
 export declare function resolveTranscriptLayout(layout?: TranscriptLayout): Required<TranscriptLayout>;

package/dist/agents/components/shared/transcript-layout.js

@@ -7,7 +7,8 @@ const DEFAULT_TRANSCRIPT_LAYOUT = {
   width: "reading",
   align: "center",
   userMessage: "compact",
-  answerActions: "hover"
+  answerActions: "hover",
+  timestamps: "hover"
 };
 const TranscriptLayoutContext = createContext(DEFAULT_TRANSCRIPT_LAYOUT);
 function resolveTranscriptLayout(layout) {
@@ -19,10 +20,10 @@ function transcriptColumnClass(layout) {
   return ASSISTANT_MESSAGE_COLUMN_CLASS;
 }
 function TranscriptLayoutProvider(props) {
-  const { width, align, userMessage, answerActions } = resolveTranscriptLayout(props.layout);
+  const { width, align, userMessage, answerActions, timestamps } = resolveTranscriptLayout(props.layout);
   const value = useMemo(
-    () => ({ width, align, userMessage, answerActions }),
-    [width, align, userMessage, answerActions]
+    () => ({ width, align, userMessage, answerActions, timestamps }),
+    [width, align, userMessage, answerActions, timestamps]
   );
   return createElement(TranscriptLayoutContext.Provider, { value }, props.children);
 }

package/dist/agents/redux/execution-system/thunks/continue-agent-json.d.ts

@@ -19,6 +19,7 @@
  */
 import type { ChatDispatch, ChatRootState } from "../../../../store/root-state.js";
 import type { RequestInitiation } from "../../../types/instance.types.js";
+import type { Resource } from "../../../resources/types.js";
 import { type HostTurnInput } from "./execute-instance.thunk.js";
 import { type AdoptedAgentJsonOptions, type HeadlessAgentJsonResult } from "./run-headless-agent-json.js";
 export interface ContinueAgentJsonOptions extends Pick<AdoptedAgentJsonOptions, "surfaceKey" | "timeoutMs" | "pollIntervalMs" | "settleMs" | "expect" | "onResult" | "signal" | "failureMessages"> {
@@ -29,6 +30,12 @@ export interface ContinueAgentJsonOptions extends Pick<AdoptedAgentJsonOptions,
     hostTurn?: HostTurnInput;
     /** Per-turn named context: each key is written on the instance; `null` removes it. */
     context?: Record<string, unknown>;
+    /**
+     * What the person attached, sent with THIS turn through THE attach path (see
+     * `HeadlessAgentJsonOptions.resources`). A file already on the conversation is an
+     * idempotent no-op; every other kind rides this turn again.
+     */
+    resources?: readonly Resource[];
     /** "user" when the person pressed send; "auto" for a host-started round. Default by turn kind. */
     initiation?: RequestInitiation;
     /** Fires the instant the turn's request exists (a live view binds to it). */

package/dist/agents/redux/execution-system/thunks/continue-agent-json.js

@@ -3,7 +3,8 @@ import { setUserInputText } from "../instance-user-input/instance-user-input.sli
 import { executeInstance } from "./execute-instance.thunk.js";
 import { loadConversation } from "./load-conversation.thunk.js";
 import {
-  adoptHeadlessAgentJson
+  adoptHeadlessAgentJson,
+  attachTurnResources
 } from "./run-headless-agent-json.js";
 function continuationTurnProblem(opts) {
   const typed = typeof opts.userInput === "string" && opts.userInput.trim().length > 0;
@@ -25,6 +26,7 @@ async function continueAgentJson(dispatch, getState, opts) {
     for (const [key] of context.filter(([, value]) => value === null)) dispatch(removeContextEntry({ conversationId, key }));
     if (writes.length) dispatch(setContextEntries({ conversationId, entries: writes.map(([key, value]) => ({ key, value })) }));
     if (opts.userInput) dispatch(setUserInputText({ conversationId, text: opts.userInput }));
+    await attachTurnResources(dispatch, getState, conversationId, opts.resources);
     let requestId = null;
     const sent = await dispatch(
       executeInstance({

package/dist/agents/redux/execution-system/thunks/run-headless-agent-json.d.ts

@@ -30,6 +30,7 @@ import type { MessagePart } from "@ai-matrx/agents/generated/stream-events";
 import type { ContextAnchor, SourceFeature, RequestInitiation } from "../../../types/instance.types.js";
 import type { ApplicationScope } from "../../../types/scope.types.js";
 import type { AnyMandateKey } from "@ai-matrx/agents/mandates";
+import type { Resource } from "../../../resources/types.js";
 export interface HeadlessAgentJsonOptions {
     /** Exact agent to run. Mutually exclusive with mandateKey and shortcutId. */
     agentId?: string;
@@ -185,6 +186,17 @@ export interface HeadlessAgentJsonOptions {
      * exists once, not per call site — blocked on launcher-level attach support.
      */
     messageParts?: MessagePart[];
+    /**
+     * What the person ATTACHED for this run (files, notes, links, documents — the
+     * "+" picker's `Resource`s). Each goes through THE attach path
+     * (`attachResourceToConversation`) on the launched conversation before it
+     * executes: a stored file is held by its file id (`processed_document` in
+     * request.context until the server keeps its `file → conversation` edge), every
+     * other kind rides the turn as its typed resource block. Never pasted into
+     * `userInput` (THE USER-INPUT LAW). Forces the two-step path, like
+     * `messageParts`. A pick that cannot be attached fails the run, out loud.
+     */
+    resources?: readonly Resource[];
     /** Per-feature user-facing failure copy. */
     failureMessages?: {
         /** Stream errored and the request carries no usable message. */
@@ -338,3 +350,10 @@ export interface AdoptedAgentJsonOptions {
  * throws; resolves a structured result, exactly like `runHeadlessAgentJson`.
  */
 export declare function adoptHeadlessAgentJson(dispatch: ChatDispatch, getState: () => ChatRootState, opts: AdoptedAgentJsonOptions): Promise<HeadlessAgentJsonResult>;
+/**
+ * Attach the person's picks to a conversation before its turn executes — THE attach
+ * path, loaded on demand (only a run that carries resources pays for it). Throws
+ * naming the first pick that could not be attached (the attach path has already
+ * said why on screen).
+ */
+export declare function attachTurnResources(dispatch: ChatDispatch, getState: () => ChatRootState, conversationId: string, resources: readonly Resource[] | undefined): Promise<void>;

package/dist/agents/redux/execution-system/thunks/run-headless-agent-json.js

@@ -279,7 +279,7 @@ async function launchAndWait(dispatch, getState, opts) {
   const pollMs = Math.max(opts.pollIntervalMs ?? DEFAULT_POLL_MS, 100);
   const settleMs = opts.settleMs ?? DEFAULT_SETTLE_MS;
   const msgs = { ...DEFAULT_MESSAGES, ...opts.failureMessages };
-  const twoStep = opts.messageParts !== void 0;
+  const twoStep = opts.messageParts !== void 0 || (opts.resources?.length ?? 0) > 0;
   let conversationId = null;
   let requestIdAnnounced = false;
   const announceRequestId = (id) => {
@@ -350,12 +350,15 @@ async function launchAndWait(dispatch, getState, opts) {
     conversationId = launch.conversationId;
     let requestId = launch.requestId;
     if (twoStep) {
-      dispatch(
-        setUserInputMessageParts({
-          conversationId,
-          parts: opts.messageParts ?? null
-        })
-      );
+      if (opts.messageParts !== void 0) {
+        dispatch(
+          setUserInputMessageParts({
+            conversationId,
+            parts: opts.messageParts ?? null
+          })
+        );
+      }
+      await attachTurnResources(dispatch, getState, conversationId, opts.resources);
       const exec = await dispatch(
         executeInstance({ conversationId, onRequestId: announceRequestId })
       ).unwrap();
@@ -592,8 +595,17 @@ function fuzzyFallback(fullResponse) {
   if (!fullResponse) return null;
   return extractFirstJson(fullResponse, { allowFuzzy: true })?.value ?? null;
 }
+async function attachTurnResources(dispatch, getState, conversationId, resources) {
+  if (!resources?.length) return;
+  const { attachResourceToConversation, resourceLabel } = await import("../../../components/inputs/resources/attach-resource.js");
+  for (const resource of resources) {
+    const ok = await attachResourceToConversation({ dispatch, getState }, conversationId, resource);
+    if (!ok) throw new Error(`Could not attach ${resourceLabel(resource)}.`);
+  }
+}
 export {
   adoptHeadlessAgentJson,
+  attachTurnResources,
   failWarnedOutputMissingKeys,
   livePosture,
   mandateOutputUnusableSentence,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.7.15",
+  "version": "0.7.17",
   "description": "THE one AI Matrx person-to-agent chat system: the full chat (running agents, conversations, tool calls, streaming, context, surfaces, voice) as explicit per-module subpaths @ai-matrx/chat/<domain>/<module> (no wildcards: scripts/public-modules.json) over a host contract (/host, /host/react) whose only required value is a db. One chat, one renderer: the old kernel entries (., /external-store, /matrx, /react, /tools, styles.css, tokens.css) are retired.",
   "type": "module",
   "license": "MIT",
@@ -4681,16 +4681,15 @@
     "server-only": "^0.0.1",
     "uuid": "^14.0.2",
     "zod": "^4.6.5",
-    "@ai-matrx/alchemy": "latest",
+    "@ai-matrx/agents": "latest",
     "@ai-matrx/associations": "latest",
     "@ai-matrx/browser-audio": "latest",
-    "@ai-matrx/canvas": "latest",
+    "@ai-matrx/alchemy": "latest",
     "@ai-matrx/content-ir": "latest",
-    "@ai-matrx/agents": "latest",
-    "@ai-matrx/content-ir-react": "latest",
+    "@ai-matrx/canvas": "latest",
     "@ai-matrx/data": "latest",
-    "@ai-matrx/diff": "latest",
     "@ai-matrx/design-system": "latest",
+    "@ai-matrx/diff": "latest",
     "@ai-matrx/icons": "latest",
     "@ai-matrx/kit": "latest",
     "@ai-matrx/media": "latest",
@@ -4699,7 +4698,8 @@
     "@ai-matrx/records": "latest",
     "@ai-matrx/records-ui": "latest",
     "@ai-matrx/rich-content": "latest",
-    "@ai-matrx/rich-editor": "latest"
+    "@ai-matrx/rich-editor": "latest",
+    "@ai-matrx/content-ir-react": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
@@ -4818,5 +4818,5 @@
     "check:side-effects": "node ../scripts/check-side-effects-listed.mjs . && node ../scripts/check-side-effects-listed.mjs --self-test",
     "check:public-surface": "node ./scripts/sync-public-surface.mjs --check && node ./scripts/sync-public-surface.mjs --self-test"
   },
-  "gitHead": "fe30f9706e88c2c101f1c3ab4beec866c90c2ec1"
+  "gitHead": "d9101c14c9a0338c4468cfd4c7d18aa5400a5762"
 }