@ai-matrx/content-ir-react 0.14.0 → 0.15.1

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## 0.15.1 — 2026-10-02
+
+- The applied tally keeps its glyph beside its sentence: a long server
+  sentence ("Already applied — nothing was changed again. Originally: …") wraps
+  next to the icon instead of leaving it alone on a line at phone width. No
+  consumer action.
+
+## 0.15.0 — 2026-10-02
+
+- **A card in a chat message applies under its conversation.** New
+  `DirectiveScopeProvider` / `useDirectiveScope` and a `conversationId` prop on
+  `DirectiveRender`. The Apply control passes it to BOTH `confirm` and
+  `applyState` as `shell.conversationId` — the namespace an agent proposal's
+  Approve uses — so one action rendered twice (proposal card + in-message card)
+  keys once and can never apply twice. A note mounts no scope (person namespace).
+- **Run again.** A clean tally carries "Run again": it calls `ask` with
+  `again: true` (the question must say it runs a SECOND time) and only a yes
+  sends `shell.force = true`; a no leaves the tally as it was. A tally with a
+  failed item carries "Retry" instead — a plain apply, never `force`.
+- `confirm` / `applyState` now take `DirectiveShell` (`__kind`, `items`,
+  optional `conversationId`, optional `force`).
+
+### Consumer action
+
+- Pass the conversation a message renders in (`DirectiveRender conversationId`
+  or `DirectiveScopeProvider`), and forward `shell.conversationId` as
+  `conversation_id` and `shell.force` as `force` to `/directives/confirm`
+  (and `conversationId` to `/directives/apply_state`).
+- Word your `ask` dialog for `request.again`.
+
 ## 0.14.0 — 2026-10-02
 
 - **A card survives a reload.** New host seam `applyState(shell)` →

package/dist/{directive-host-DLp5QFI2.d.cts → directive-host-DJfF35FD.d.cts}

@@ -61,6 +61,28 @@ interface DirectiveAskRequest {
     items: Record<string, unknown>[];
     /** The noun's human label ("Task"), from the host's catalog when it has one. */
     nounLabel: string;
+    /**
+     * True for "Run again": the ledger already holds this block, and a yes runs
+     * it a SECOND time (`force`) — another copy for a create, the same fields
+     * written again for an update, another delete for a restored record. The
+     * question must say so.
+     */
+    again?: boolean;
+}
+/**
+ * The shell a card hands its host — the two keys, plus WHERE it sits.
+ *
+ * `conversationId` is the conversation the card renders in (a chat message),
+ * absent in a person's own content (a note). It is the idempotency NAMESPACE:
+ * a card in an agent's message must apply under the SAME key as that
+ * proposal's Approve button, or the one action could run twice.
+ */
+interface DirectiveShell {
+    __kind: string;
+    items: Record<string, unknown>[];
+    conversationId?: string;
+    /** "Run again": skip the ledger's dedup and apply a second time. */
+    force?: boolean;
 }
 interface DirectiveOpenItemOptions {
     /** The item, `__kind`-stamped when the shape has an item kind. */
@@ -89,10 +111,7 @@ interface DirectiveHost {
      * item against the registered model and runs the ONE handler; idempotent).
      * Reject with an Error whose message is safe to show.
      */
-    confirm?: (shell: {
-        __kind: string;
-        items: Record<string, unknown>[];
-    }) => Promise<DirectiveApplyResult>;
+    confirm?: (shell: DirectiveShell) => Promise<DirectiveApplyResult>;
     /**
      * Ask the person BEFORE anything runs, naming the consequence (the records,
      * what changes). Resolve `true` to go ahead, `false` to leave the card as it
@@ -112,10 +131,7 @@ interface DirectiveHost {
      * read: the card reports it and offers Apply, which is safe because `confirm`
      * is idempotent. Absent → the card starts at Apply, as before.
      */
-    applyState?: (shell: {
-        __kind: string;
-        items: Record<string, unknown>[];
-    }) => Promise<DirectiveApplyState>;
+    applyState?: (shell: DirectiveShell) => Promise<DirectiveApplyState>;
     /**
      * Draw ONE existing record by its live name, as a way to open it. Used on
      * update/delete rows (the record that will change), in the host's own ask
@@ -134,6 +150,20 @@ interface DirectiveHost {
     /** Where a decode failure or an unhonourable shell is reported. Default: console.error. */
     reportError?: (message: string) => void;
 }
+/** Where a directive renders — today, the conversation it sits in (if any). */
+interface DirectiveScope {
+    conversationId?: string | null;
+}
+/**
+ * Tell every card below WHERE it renders. A host draws a chat message's
+ * directives inside one of these (or passes `conversationId` to
+ * `DirectiveRender`), so the card applies in that conversation's namespace —
+ * the same key the agent's proposal approves under. A note mounts none.
+ */
+declare function DirectiveScopeProvider({ conversationId, children, }: DirectiveScope & {
+    children: ReactNode;
+}): react.JSX.Element;
+declare function useDirectiveScope(): DirectiveScope;
 interface DirectiveHostProviderProps {
     host: DirectiveHost;
     children: ReactNode;
@@ -146,4 +176,4 @@ declare function DirectiveHostProvider({ host, children }: DirectiveHostProvider
  */
 declare function useDirectiveHost(): DirectiveHost;
 
-export { type DirectiveApplyResult as D, type DirectiveApplyState as a, type DirectiveAskRequest as b, type DirectiveCopyProps as c, type DirectiveHost as d, DirectiveHostProvider as e, type DirectiveHostProviderProps as f, type DirectiveOpenItemOptions as g, type DirectiveRecordProps as h, type DirectiveRecordRef as i, useDirectiveHost as u };
+export { type DirectiveApplyResult as D, type DirectiveApplyState as a, type DirectiveAskRequest as b, type DirectiveCopyProps as c, type DirectiveHost as d, DirectiveHostProvider as e, type DirectiveHostProviderProps as f, type DirectiveOpenItemOptions as g, type DirectiveRecordProps as h, type DirectiveRecordRef as i, type DirectiveScope as j, DirectiveScopeProvider as k, type DirectiveShell as l, useDirectiveScope as m, useDirectiveHost as u };

package/dist/{directive-host-DLp5QFI2.d.ts → directive-host-DJfF35FD.d.ts}

@@ -61,6 +61,28 @@ interface DirectiveAskRequest {
     items: Record<string, unknown>[];
     /** The noun's human label ("Task"), from the host's catalog when it has one. */
     nounLabel: string;
+    /**
+     * True for "Run again": the ledger already holds this block, and a yes runs
+     * it a SECOND time (`force`) — another copy for a create, the same fields
+     * written again for an update, another delete for a restored record. The
+     * question must say so.
+     */
+    again?: boolean;
+}
+/**
+ * The shell a card hands its host — the two keys, plus WHERE it sits.
+ *
+ * `conversationId` is the conversation the card renders in (a chat message),
+ * absent in a person's own content (a note). It is the idempotency NAMESPACE:
+ * a card in an agent's message must apply under the SAME key as that
+ * proposal's Approve button, or the one action could run twice.
+ */
+interface DirectiveShell {
+    __kind: string;
+    items: Record<string, unknown>[];
+    conversationId?: string;
+    /** "Run again": skip the ledger's dedup and apply a second time. */
+    force?: boolean;
 }
 interface DirectiveOpenItemOptions {
     /** The item, `__kind`-stamped when the shape has an item kind. */
@@ -89,10 +111,7 @@ interface DirectiveHost {
      * item against the registered model and runs the ONE handler; idempotent).
      * Reject with an Error whose message is safe to show.
      */
-    confirm?: (shell: {
-        __kind: string;
-        items: Record<string, unknown>[];
-    }) => Promise<DirectiveApplyResult>;
+    confirm?: (shell: DirectiveShell) => Promise<DirectiveApplyResult>;
     /**
      * Ask the person BEFORE anything runs, naming the consequence (the records,
      * what changes). Resolve `true` to go ahead, `false` to leave the card as it
@@ -112,10 +131,7 @@ interface DirectiveHost {
      * read: the card reports it and offers Apply, which is safe because `confirm`
      * is idempotent. Absent → the card starts at Apply, as before.
      */
-    applyState?: (shell: {
-        __kind: string;
-        items: Record<string, unknown>[];
-    }) => Promise<DirectiveApplyState>;
+    applyState?: (shell: DirectiveShell) => Promise<DirectiveApplyState>;
     /**
      * Draw ONE existing record by its live name, as a way to open it. Used on
      * update/delete rows (the record that will change), in the host's own ask
@@ -134,6 +150,20 @@ interface DirectiveHost {
     /** Where a decode failure or an unhonourable shell is reported. Default: console.error. */
     reportError?: (message: string) => void;
 }
+/** Where a directive renders — today, the conversation it sits in (if any). */
+interface DirectiveScope {
+    conversationId?: string | null;
+}
+/**
+ * Tell every card below WHERE it renders. A host draws a chat message's
+ * directives inside one of these (or passes `conversationId` to
+ * `DirectiveRender`), so the card applies in that conversation's namespace —
+ * the same key the agent's proposal approves under. A note mounts none.
+ */
+declare function DirectiveScopeProvider({ conversationId, children, }: DirectiveScope & {
+    children: ReactNode;
+}): react.JSX.Element;
+declare function useDirectiveScope(): DirectiveScope;
 interface DirectiveHostProviderProps {
     host: DirectiveHost;
     children: ReactNode;
@@ -146,4 +176,4 @@ declare function DirectiveHostProvider({ host, children }: DirectiveHostProvider
  */
 declare function useDirectiveHost(): DirectiveHost;
 
-export { type DirectiveApplyResult as D, type DirectiveApplyState as a, type DirectiveAskRequest as b, type DirectiveCopyProps as c, type DirectiveHost as d, DirectiveHostProvider as e, type DirectiveHostProviderProps as f, type DirectiveOpenItemOptions as g, type DirectiveRecordProps as h, type DirectiveRecordRef as i, useDirectiveHost as u };
+export { type DirectiveApplyResult as D, type DirectiveApplyState as a, type DirectiveAskRequest as b, type DirectiveCopyProps as c, type DirectiveHost as d, DirectiveHostProvider as e, type DirectiveHostProviderProps as f, type DirectiveOpenItemOptions as g, type DirectiveRecordProps as h, type DirectiveRecordRef as i, type DirectiveScope as j, DirectiveScopeProvider as k, type DirectiveShell as l, useDirectiveScope as m, useDirectiveHost as u };

package/dist/directives.cjs

@@ -27,6 +27,7 @@ __export(directives_exports, {
   DirectiveHostProvider: () => DirectiveHostProvider,
   DirectiveProvisionalCard: () => DirectiveProvisionalCard,
   DirectiveRender: () => DirectiveRender,
+  DirectiveScopeProvider: () => DirectiveScopeProvider,
   SideEffectDirectiveCard: () => SideEffectDirectiveCard,
   TARGETING_CLASSES: () => TARGETING_CLASSES,
   fieldLabel: () => fieldLabel,
@@ -37,7 +38,8 @@ __export(directives_exports, {
   recordFallbackName: () => recordFallbackName,
   registerDirectiveRenderer: () => registerDirectiveRenderer,
   resetDirectiveRenderers: () => resetDirectiveRenderers,
-  useDirectiveHost: () => useDirectiveHost
+  useDirectiveHost: () => useDirectiveHost,
+  useDirectiveScope: () => useDirectiveScope
 });
 module.exports = __toCommonJS(directives_exports);
 
@@ -45,6 +47,16 @@ module.exports = __toCommonJS(directives_exports);
 var import_react = require("react");
 var import_jsx_runtime = require("react/jsx-runtime");
 var DirectiveHostContext = (0, import_react.createContext)(null);
+var DirectiveScopeContext = (0, import_react.createContext)({});
+function DirectiveScopeProvider({
+  conversationId,
+  children
+}) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(DirectiveScopeContext.Provider, { value: { conversationId: conversationId ?? null }, children });
+}
+function useDirectiveScope() {
+  return (0, import_react.useContext)(DirectiveScopeContext);
+}
 function DirectiveHostProvider({ host, children }) {
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(DirectiveHostContext.Provider, { value: host, children });
 }
@@ -197,6 +209,10 @@ var MaximizeIcon = (p) => /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Svg, { .
   /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("line", { x1: "3", x2: "10", y1: "21", y2: "14" })
 ] });
 var LoaderIcon = (p) => /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Svg, { ...p, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("path", { d: "M21 12a9 9 0 1 1-6.219-8.56" }) });
+var RotateCcwIcon = (p) => /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Svg, { ...p, children: [
+  /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("path", { d: "M3 12a9 9 0 1 0 9-9 9.75 9.75 0 0 0-6.74 2.74L3 8" }),
+  /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("path", { d: "M3 3v5h5" })
+] });
 var CheckCircleIcon = (p) => /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Svg, { ...p, children: [
   /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("circle", { cx: "12", cy: "12", r: "10" }),
   /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("path", { d: "m9 12 2 2 4-4" })
@@ -232,6 +248,8 @@ function ApplyDirectiveButton({
   onApplied
 }) {
   const host = useDirectiveHost();
+  const scope = useDirectiveScope();
+  const conversationId = scope.conversationId || void 0;
   const items = directive.items;
   const readsLedger = !!host.applyState && !!host.confirm && directive.parsed.executes && items.length > 0;
   const [state, setState] = (0, import_react2.useState)(
@@ -240,17 +258,19 @@ function ApplyDirectiveButton({
   const [elapsed, setElapsed] = (0, import_react2.useState)(0);
   const startedAt = (0, import_react2.useRef)(null);
   const nounText = (0, import_content_ir2.nounLabel)(directive.noun, host.nouns);
-  const shellKey = readsLedger ? JSON.stringify([directive.slug, items]) : "";
+  const shellKey = readsLedger ? JSON.stringify([directive.slug, items, conversationId ?? null]) : "";
   const read = host.applyState;
   const report = host.reportError;
   (0, import_react2.useEffect)(() => {
     if (!shellKey || !read) return;
-    const [slug, shellItems] = JSON.parse(shellKey);
+    const [slug, shellItems, inConversation] = JSON.parse(shellKey);
+    const shell = { __kind: slug, items: shellItems };
+    if (inConversation) shell.conversationId = inConversation;
     let live = true;
     let polls = 0;
     let timer = null;
     const ask = () => {
-      read({ __kind: slug, items: shellItems }).then((answer) => {
+      read(shell).then((answer) => {
         if (!live) return;
         if (answer.state === "applied") {
           setState(
@@ -296,8 +316,9 @@ function ApplyDirectiveButton({
   if (!directive.parsed.executes) return null;
   const confirm = host.confirm;
   if (!confirm) return null;
-  async function handleApply() {
+  async function handleApply(again = false) {
     if (!confirm) return;
+    const before = state;
     if (host.ask) {
       setState({ status: "asking" });
       let ok = false;
@@ -305,7 +326,8 @@ function ApplyDirectiveButton({
         ok = await host.ask({
           directive,
           items,
-          nounLabel: nounText
+          nounLabel: nounText,
+          ...again ? { again: true } : {}
         });
       } catch (error) {
         setState({
@@ -315,14 +337,17 @@ function ApplyDirectiveButton({
         return;
       }
       if (!ok) {
-        setState({ status: "idle" });
+        setState(again ? before : { status: "idle" });
         return;
       }
     }
     setElapsed(0);
     setState({ status: "applying" });
     try {
-      const result = await confirm({ __kind: directive.slug, items });
+      const shell = { __kind: directive.slug, items };
+      if (conversationId) shell.conversationId = conversationId;
+      if (again) shell.force = true;
+      const result = await confirm(shell);
       setState({
         status: "applied",
         applied: result.applied,
@@ -346,20 +371,35 @@ function ApplyDirectiveButton({
     return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
       "span",
       {
-        className: `inline-flex min-w-0 flex-wrap items-center gap-1 text-xs ${bad ? "text-destructive" : "text-primary"}`,
+        className: `flex min-w-0 flex-wrap items-center gap-x-2 gap-y-0.5 text-xs ${bad ? "text-destructive" : "text-primary"}`,
         "data-apply-state": "applied",
         children: [
-          bad ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(AlertIcon, { className: "h-3.5 w-3.5 shrink-0" }) : /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(CheckCircleIcon, { className: "h-3.5 w-3.5 shrink-0" }),
-          /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("span", { children: [
-            state.message ?? `Applied ${state.applied}`,
-            bad && !state.message ? ` \xB7 ${state.failed} failed` : ""
+          /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("span", { className: "inline-flex min-w-0 items-start gap-1", children: [
+            bad ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(AlertIcon, { className: "mt-px h-3.5 w-3.5 shrink-0" }) : /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(CheckCircleIcon, { className: "mt-px h-3.5 w-3.5 shrink-0" }),
+            /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("span", { className: "min-w-0", children: [
+              state.message ?? `Applied ${state.applied}`,
+              bad && !state.message ? ` \xB7 ${state.failed} failed` : ""
+            ] })
           ] }),
           records.map((record) => /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("span", { className: "inline-flex min-w-0 items-center", children: host.renderRecord?.({
             ...record,
             fallback: recordFallbackName(label2, record.id),
             context: "applied",
             trashed
-          }) }, `${record.noun}:${record.id}`))
+          }) }, `${record.noun}:${record.id}`)),
+          /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(
+            "button",
+            {
+              type: "button",
+              onClick: () => void handleApply(!bad),
+              className: "inline-flex items-center gap-1 rounded px-1 py-0.5 text-muted-foreground hover:bg-accent hover:text-accent-foreground",
+              "data-apply-action": bad ? "retry" : "run-again",
+              children: [
+                /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(RotateCcwIcon, { className: "h-3 w-3" }),
+                bad ? "Retry" : "Run again"
+              ]
+            }
+          )
         ]
       }
     );
@@ -624,7 +664,11 @@ function isWholeJson(content) {
     return false;
   }
 }
-function DirectiveRender({ content, className, streaming }) {
+function DirectiveRender({ conversationId, ...props }) {
+  if (conversationId === void 0) return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(DirectiveRenderInner, { ...props });
+  return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(DirectiveScopeProvider, { conversationId, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(DirectiveRenderInner, { ...props }) });
+}
+function DirectiveRenderInner({ content, className, streaming }) {
   const host = useDirectiveHost();
   const directive = (0, import_content_ir6.tryDecodeDirectiveContent)(content, (message) => {
     const line = `[kind-directives] ${message}`;