@ai-matrx/content-ir-react 0.13.18 → 0.15.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { C as ComponentResolutionSource, a as ComponentResolution, b as ContentIrErrorReporter } from './component-resolution.types-DLO2w-0n.cjs';
 export { c as ComponentRole, d as ContentIrErrorReport, J as JsonObject, K as KindComponentRow, S as SystemComponentEntry, e as consoleErrorReporter } from './component-resolution.types-DLO2w-0n.cjs';
-import { C as ContentIrHost, K as KindRouteEnv, a as KindDefinitionSource } from './route-DxK1SoPh.cjs';
-export { b as ContentIrRenderSeams, D as DB_KIND_COMPONENT_KEY, c as DIRECTIVE_BLOCK_TYPE, d as DirectiveApplyResult, e as DirectiveAskRequest, f as DirectiveCopyProps, g as DirectiveHost, h as DirectiveHostProvider, i as DirectiveHostProviderProps, j as DirectiveOpenItemOptions, k as DirectiveRecordProps, l as DirectiveRecordRef, G as GENERIC_STRUCTURED_COMPONENT_KEY, m as GenericFallbackReason, I as IR_PROVISIONAL_KEY, n as IR_ROUTE_KEY, o as IrRenderBlock, p as IrRoutableBlock, q as IrRouteMarker, r as KindRouteBinding, s as KindRouteOptions, P as PartialRenderOptions, t as ProvisionalKindRender, S as StructuredValueRenderProps, u as SupersededKindRender, v as applyIrKindRoute, w as createKindRouteBinding, x as envelopeFromPartialKind, y as isPartialReadyKind, z as isProvisionalBlock, A as kindServerDataFromStoredValue, B as markKindPartialUnsafe, E as readIrRouteMarker, F as resetPartialUnsafeKinds, H as resetSourcelessDbRowReports, J as resolveAnnouncedKindLoading, L as resolveProvisionalKindRender, M as resolveSupersededKindRender, N as routeEnvOf, O as useDirectiveHost } from './route-DxK1SoPh.cjs';
+import { C as ContentIrHost, K as KindRouteEnv, a as KindDefinitionSource } from './route-BCtPhF7W.cjs';
+export { b as ContentIrRenderSeams, D as DB_KIND_COMPONENT_KEY, c as DIRECTIVE_BLOCK_TYPE, d as DirectiveApplyResult, e as DirectiveApplyState, f as DirectiveAskRequest, g as DirectiveCopyProps, h as DirectiveHost, i as DirectiveHostProvider, j as DirectiveHostProviderProps, k as DirectiveOpenItemOptions, l as DirectiveRecordProps, m as DirectiveRecordRef, n as DirectiveScope, o as DirectiveScopeProvider, p as DirectiveShell, G as GENERIC_STRUCTURED_COMPONENT_KEY, q as GenericFallbackReason, I as IR_PROVISIONAL_KEY, r as IR_ROUTE_KEY, s as IrRenderBlock, t as IrRoutableBlock, u as IrRouteMarker, v as KindRouteBinding, w as KindRouteOptions, P as PartialRenderOptions, x as ProvisionalKindRender, S as StructuredValueRenderProps, y as SupersededKindRender, z as applyIrKindRoute, A as createKindRouteBinding, B as envelopeFromPartialKind, E as isPartialReadyKind, F as isProvisionalBlock, H as kindServerDataFromStoredValue, J as markKindPartialUnsafe, L as readIrRouteMarker, M as resetPartialUnsafeKinds, N as resetSourcelessDbRowReports, O as resolveAnnouncedKindLoading, Q as resolveProvisionalKindRender, R as resolveSupersededKindRender, T as routeEnvOf, U as useDirectiveHost, V as useDirectiveScope } from './route-BCtPhF7W.cjs';
 import * as react from 'react';
 import react__default, { ReactNode, ComponentType } from 'react';
 export { ComponentResolver, ComponentResolverOptions } from './resolver.cjs';
@@ -292,8 +292,15 @@ interface DirectiveRenderProps {
      * OFF rather than "writing…" forever. Omitted = it may still be arriving.
      */
     streaming?: boolean;
+    /**
+     * The conversation this directive renders in (a chat message). Applies and
+     * ledger reads key on it — the same namespace an agent proposal's Approve
+     * uses — so one action can never apply twice through two doors. Omit in a
+     * person's own content. Overrides any enclosing `DirectiveScopeProvider`.
+     */
+    conversationId?: string | null;
 }
-declare function DirectiveRender({ content, className, streaming }: DirectiveRenderProps): react.JSX.Element;
+declare function DirectiveRender({ conversationId, ...props }: DirectiveRenderProps): react.JSX.Element;
 
 /**
  * WHAT A DIRECTIVE ITEM WILL DO TO AN EXISTING RECORD — for the card, the

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { C as ComponentResolutionSource, a as ComponentResolution, b as ContentIrErrorReporter } from './component-resolution.types-DLO2w-0n.js';
 export { c as ComponentRole, d as ContentIrErrorReport, J as JsonObject, K as KindComponentRow, S as SystemComponentEntry, e as consoleErrorReporter } from './component-resolution.types-DLO2w-0n.js';
-import { C as ContentIrHost, K as KindRouteEnv, a as KindDefinitionSource } from './route-JGZfl2nL.js';
-export { b as ContentIrRenderSeams, D as DB_KIND_COMPONENT_KEY, c as DIRECTIVE_BLOCK_TYPE, d as DirectiveApplyResult, e as DirectiveAskRequest, f as DirectiveCopyProps, g as DirectiveHost, h as DirectiveHostProvider, i as DirectiveHostProviderProps, j as DirectiveOpenItemOptions, k as DirectiveRecordProps, l as DirectiveRecordRef, G as GENERIC_STRUCTURED_COMPONENT_KEY, m as GenericFallbackReason, I as IR_PROVISIONAL_KEY, n as IR_ROUTE_KEY, o as IrRenderBlock, p as IrRoutableBlock, q as IrRouteMarker, r as KindRouteBinding, s as KindRouteOptions, P as PartialRenderOptions, t as ProvisionalKindRender, S as StructuredValueRenderProps, u as SupersededKindRender, v as applyIrKindRoute, w as createKindRouteBinding, x as envelopeFromPartialKind, y as isPartialReadyKind, z as isProvisionalBlock, A as kindServerDataFromStoredValue, B as markKindPartialUnsafe, E as readIrRouteMarker, F as resetPartialUnsafeKinds, H as resetSourcelessDbRowReports, J as resolveAnnouncedKindLoading, L as resolveProvisionalKindRender, M as resolveSupersededKindRender, N as routeEnvOf, O as useDirectiveHost } from './route-JGZfl2nL.js';
+import { C as ContentIrHost, K as KindRouteEnv, a as KindDefinitionSource } from './route-DDbgc-ID.js';
+export { b as ContentIrRenderSeams, D as DB_KIND_COMPONENT_KEY, c as DIRECTIVE_BLOCK_TYPE, d as DirectiveApplyResult, e as DirectiveApplyState, f as DirectiveAskRequest, g as DirectiveCopyProps, h as DirectiveHost, i as DirectiveHostProvider, j as DirectiveHostProviderProps, k as DirectiveOpenItemOptions, l as DirectiveRecordProps, m as DirectiveRecordRef, n as DirectiveScope, o as DirectiveScopeProvider, p as DirectiveShell, G as GENERIC_STRUCTURED_COMPONENT_KEY, q as GenericFallbackReason, I as IR_PROVISIONAL_KEY, r as IR_ROUTE_KEY, s as IrRenderBlock, t as IrRoutableBlock, u as IrRouteMarker, v as KindRouteBinding, w as KindRouteOptions, P as PartialRenderOptions, x as ProvisionalKindRender, S as StructuredValueRenderProps, y as SupersededKindRender, z as applyIrKindRoute, A as createKindRouteBinding, B as envelopeFromPartialKind, E as isPartialReadyKind, F as isProvisionalBlock, H as kindServerDataFromStoredValue, J as markKindPartialUnsafe, L as readIrRouteMarker, M as resetPartialUnsafeKinds, N as resetSourcelessDbRowReports, O as resolveAnnouncedKindLoading, Q as resolveProvisionalKindRender, R as resolveSupersededKindRender, T as routeEnvOf, U as useDirectiveHost, V as useDirectiveScope } from './route-DDbgc-ID.js';
 import * as react from 'react';
 import react__default, { ReactNode, ComponentType } from 'react';
 export { ComponentResolver, ComponentResolverOptions } from './resolver.js';
@@ -292,8 +292,15 @@ interface DirectiveRenderProps {
      * OFF rather than "writing…" forever. Omitted = it may still be arriving.
      */
     streaming?: boolean;
+    /**
+     * The conversation this directive renders in (a chat message). Applies and
+     * ledger reads key on it — the same namespace an agent proposal's Approve
+     * uses — so one action can never apply twice through two doors. Omit in a
+     * person's own content. Overrides any enclosing `DirectiveScopeProvider`.
+     */
+    conversationId?: string | null;
 }
-declare function DirectiveRender({ content, className, streaming }: DirectiveRenderProps): react.JSX.Element;
+declare function DirectiveRender({ conversationId, ...props }: DirectiveRenderProps): react.JSX.Element;
 
 /**
  * WHAT A DIRECTIVE ITEM WILL DO TO AN EXISTING RECORD — for the card, the

package/dist/index.js

@@ -20,6 +20,16 @@ import { createContext as createContext2, useContext as useContext2, useMemo } f
 import { createContext, useContext } from "react";
 import { jsx } from "react/jsx-runtime";
 var DirectiveHostContext = createContext(null);
+var DirectiveScopeContext = createContext({});
+function DirectiveScopeProvider({
+  conversationId,
+  children
+}) {
+  return /* @__PURE__ */ jsx(DirectiveScopeContext.Provider, { value: { conversationId: conversationId ?? null }, children });
+}
+function useDirectiveScope() {
+  return useContext(DirectiveScopeContext);
+}
 function DirectiveHostProvider({ host, children }) {
   return /* @__PURE__ */ jsx(DirectiveHostContext.Provider, { value: host, children });
 }
@@ -867,6 +877,10 @@ var MaximizeIcon = (p) => /* @__PURE__ */ jsxs(Svg, { ...p, children: [
   /* @__PURE__ */ jsx3("line", { x1: "3", x2: "10", y1: "21", y2: "14" })
 ] });
 var LoaderIcon = (p) => /* @__PURE__ */ jsx3(Svg, { ...p, children: /* @__PURE__ */ jsx3("path", { d: "M21 12a9 9 0 1 1-6.219-8.56" }) });
+var RotateCcwIcon = (p) => /* @__PURE__ */ jsxs(Svg, { ...p, children: [
+  /* @__PURE__ */ jsx3("path", { d: "M3 12a9 9 0 1 0 9-9 9.75 9.75 0 0 0-6.74 2.74L3 8" }),
+  /* @__PURE__ */ jsx3("path", { d: "M3 3v5h5" })
+] });
 var CheckCircleIcon = (p) => /* @__PURE__ */ jsxs(Svg, { ...p, children: [
   /* @__PURE__ */ jsx3("circle", { cx: "12", cy: "12", r: "10" }),
   /* @__PURE__ */ jsx3("path", { d: "m9 12 2 2 4-4" })
@@ -893,6 +907,8 @@ function classIcon(directiveClass, noun) {
 
 // directives/ApplyDirectiveButton.tsx
 import { jsx as jsx4, jsxs as jsxs2 } from "react/jsx-runtime";
+var FINISH_POLL_MS = 2e3;
+var FINISH_POLLS_MAX = 30;
 function ApplyDirectiveButton({
   directive,
   label = "Apply",
@@ -900,9 +916,62 @@ function ApplyDirectiveButton({
   onApplied
 }) {
   const host = useDirectiveHost();
-  const [state, setState] = useState({ status: "idle" });
+  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] = useState(
+    readsLedger ? { status: "checking" } : { status: "idle" }
+  );
   const [elapsed, setElapsed] = useState(0);
   const startedAt = useRef(null);
+  const nounText = nounLabel(directive.noun, host.nouns);
+  const shellKey = readsLedger ? JSON.stringify([directive.slug, items, conversationId ?? null]) : "";
+  const read = host.applyState;
+  const report = host.reportError;
+  useEffect(() => {
+    if (!shellKey || !read) return;
+    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(shell).then((answer) => {
+        if (!live) return;
+        if (answer.state === "applied") {
+          setState(
+            (prev) => prev.status === "checking" || prev.status === "finishing" ? {
+              status: "applied",
+              applied: shellItems.length,
+              failed: 0,
+              message: answer.message?.trim() ? answer.message.trim() : null,
+              records: answer.records ?? []
+            } : prev
+          );
+        } else if (answer.state === "in_flight" && polls < FINISH_POLLS_MAX) {
+          polls += 1;
+          setState((prev) => prev.status === "checking" || prev.status === "finishing" ? { status: "finishing" } : prev);
+          timer = setTimeout(ask, FINISH_POLL_MS);
+        } else {
+          setState((prev) => prev.status === "checking" || prev.status === "finishing" ? { status: "idle" } : prev);
+        }
+      }).catch((error) => {
+        if (!live) return;
+        const why = error instanceof Error && error.message ? error.message : String(error);
+        (report ?? console.error)(
+          `[kind-directives] Could not read whether ${slug} was already applied: ${why}`
+        );
+        setState((prev) => prev.status === "checking" || prev.status === "finishing" ? { status: "idle" } : prev);
+      });
+    };
+    ask();
+    return () => {
+      live = false;
+      if (timer) clearTimeout(timer);
+    };
+  }, [shellKey, read, report]);
   useEffect(() => {
     if (state.status !== "applying") return;
     startedAt.current = Date.now();
@@ -915,9 +984,9 @@ function ApplyDirectiveButton({
   if (!directive.parsed.executes) return null;
   const confirm = host.confirm;
   if (!confirm) return null;
-  const items = directive.items;
-  async function handleApply() {
+  async function handleApply(again = false) {
     if (!confirm) return;
+    const before = state;
     if (host.ask) {
       setState({ status: "asking" });
       let ok = false;
@@ -925,7 +994,8 @@ function ApplyDirectiveButton({
         ok = await host.ask({
           directive,
           items,
-          nounLabel: nounLabel(directive.noun, host.nouns)
+          nounLabel: nounText,
+          ...again ? { again: true } : {}
         });
       } catch (error) {
         setState({
@@ -935,14 +1005,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,
@@ -961,7 +1034,7 @@ function ApplyDirectiveButton({
   if (state.status === "applied") {
     const bad = state.failed > 0;
     const trashed = directive.directiveClass === "delete";
-    const label2 = nounLabel(directive.noun, host.nouns);
+    const label2 = nounText;
     const records = host.renderRecord ? state.records : [];
     return /* @__PURE__ */ jsxs2(
       "span",
@@ -979,7 +1052,46 @@ function ApplyDirectiveButton({
             fallback: recordFallbackName(label2, record.id),
             context: "applied",
             trashed
-          }) }, `${record.noun}:${record.id}`))
+          }) }, `${record.noun}:${record.id}`)),
+          /* @__PURE__ */ jsxs2(
+            "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__ */ jsx4(RotateCcwIcon, { className: "h-3 w-3" }),
+                bad ? "Retry" : "Run again"
+              ]
+            }
+          )
+        ]
+      }
+    );
+  }
+  if (state.status === "checking") {
+    return /* @__PURE__ */ jsx4(
+      "span",
+      {
+        className: "inline-flex h-6 w-6 items-center justify-center text-muted-foreground",
+        role: "status",
+        "aria-label": "Checking whether this already ran",
+        "data-apply-state": "checking",
+        children: /* @__PURE__ */ jsx4(LoaderIcon, { className: "h-3.5 w-3.5 animate-spin" })
+      }
+    );
+  }
+  if (state.status === "finishing") {
+    return /* @__PURE__ */ jsxs2(
+      "span",
+      {
+        className: "inline-flex items-center gap-1 text-xs text-muted-foreground",
+        role: "status",
+        "data-apply-state": "finishing",
+        children: [
+          /* @__PURE__ */ jsx4(LoaderIcon, { className: "h-3.5 w-3.5 animate-spin" }),
+          "Finishing\u2026"
         ]
       }
     );
@@ -1245,7 +1357,11 @@ function isWholeJson(content) {
     return false;
   }
 }
-function DirectiveRender({ content, className, streaming }) {
+function DirectiveRender({ conversationId, ...props }) {
+  if (conversationId === void 0) return /* @__PURE__ */ jsx8(DirectiveRenderInner, { ...props });
+  return /* @__PURE__ */ jsx8(DirectiveScopeProvider, { conversationId, children: /* @__PURE__ */ jsx8(DirectiveRenderInner, { ...props }) });
+}
+function DirectiveRenderInner({ content, className, streaming }) {
   const host = useDirectiveHost();
   const directive = tryDecodeDirectiveContent(content, (message) => {
     const line = `[kind-directives] ${message}`;
@@ -1709,6 +1825,7 @@ export {
   DirectiveHostProvider,
   DirectiveProvisionalCard,
   DirectiveRender,
+  DirectiveScopeProvider,
   GENERIC_STRUCTURED_COMPONENT_KEY,
   GenericStructuredView,
   IR_PROVISIONAL_KEY,
@@ -1751,6 +1868,7 @@ export {
   useContentIrHostOrNull,
   useContentIrKindVersion,
   useDirectiveHost,
+  useDirectiveScope,
   useKindRouteEnv
 };
 //# sourceMappingURL=index.js.map