@xyne/workflow-ui 1.3.11 → 1.3.12

package/dist/components/shared/CitationArrow.js

@@ -0,0 +1,83 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * The reader-facing citation affordance: a compact ↗ beside a data point that
+ * opens the source it came from.
+ *
+ * One marker per citation — a value backed by three sources shows three markers,
+ * each opening its own. No popover: every source stays one click away, and the
+ * count itself tells the reader how well-backed the value is.
+ */
+import { useState } from 'react';
+import { cn } from './cn.js';
+import { AttachmentPreviewModal } from './AttachmentCard.js';
+import { useCitationOrigin, useCitationOpener } from './citation-context.js';
+import { useWorkflowClient } from '../../hooks/use-workflow-client.js';
+import { resolveCitationRef, } from '../execution/origin/citation-resolver.js';
+/** Beyond this many markers the row turns to noise; the rest collapse to "+k". */
+const MAX_INLINE_MARKERS = 6;
+function hostOf(url) {
+    try {
+        return new URL(url).host;
+    }
+    catch {
+        return url;
+    }
+}
+/** What the marker says on hover — enough to know where it goes before clicking. */
+function titleFor(resolved, ref) {
+    if (!resolved) {
+        return ref.kind === 'ref' ? `Source: ${ref.ref} (no document)` : 'Source';
+    }
+    if (resolved.kind === 'url')
+        return `Source: ${resolved.title ?? hostOf(resolved.url)}`;
+    const page = resolved.page !== undefined ? `, p.${String(resolved.page)}` : '';
+    return `Source: ${resolved.attachment.name}${page}`;
+}
+/**
+ * A single citation marker. Clicking opens its source directly: a document at
+ * its cited page with the quoted passage highlighted, or an external link.
+ *
+ * Renders nothing outside a {@link CitationOriginContext} provider — without an
+ * execution in scope there's nothing to resolve against.
+ */
+export function CitationArrow({ citation, index, className }) {
+    const client = useWorkflowClient();
+    const ctx = useCitationOrigin();
+    const openInPanel = useCitationOpener();
+    const [openDoc, setOpenDoc] = useState(null);
+    const resolved = ctx ? resolveCitationRef(citation, ctx) : undefined;
+    if (!ctx)
+        return null;
+    const open = () => {
+        if (!resolved)
+            return;
+        if (resolved.kind === 'url') {
+            window.open(resolved.url, '_blank', 'noopener,noreferrer');
+            return;
+        }
+        // Side-by-side where the surface can host it (the run view) — a modal would
+        // cover the very data you're checking. Modal only as a fallback.
+        if (openInPanel)
+            openInPanel(resolved);
+        else
+            setOpenDoc(resolved);
+    };
+    return (_jsxs(_Fragment, { children: [_jsxs("button", { type: "button", onClick: open, disabled: !resolved, title: titleFor(resolved, citation), className: cn('inline-flex shrink-0 items-center gap-px rounded-[var(--wui-radius-sm)] px-0.5 align-middle transition-colors', resolved
+                    ? 'text-[var(--wui-fg-muted)] hover:bg-[color-mix(in_srgb,var(--wui-primary)_12%,transparent)] hover:text-[var(--wui-primary)]'
+                    // A cited value whose source can't be opened still shows a marker —
+                    // the agent claimed a source, and hiding that would read as uncited.
+                    : 'cursor-default text-[var(--wui-border-strong)]', className), children: [_jsxs("svg", { width: "11", height: "11", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: 2.5, strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("line", { x1: "7", y1: "17", x2: "17", y2: "7" }), _jsx("polyline", { points: "7 7 17 7 17 17" })] }), index !== undefined && (_jsx("sup", { className: "text-[8px] font-semibold leading-none", children: index }))] }), openDoc && (_jsx(AttachmentPreviewModal, { attachment: openDoc.attachment, url: client.uploads.url(openDoc.attachment), page: openDoc.page, highlightQuery: openDoc.quote, onClose: () => { setOpenDoc(null); } }))] }));
+}
+/**
+ * Every citation on one data point, as one marker each — numbered once there's
+ * more than one to tell apart. Renders nothing when uncited, so an uncited value
+ * looks exactly as it did before citations existed.
+ */
+export function CitationMarks({ refs, className }) {
+    if (!refs || refs.length === 0)
+        return null;
+    const shown = refs.slice(0, MAX_INLINE_MARKERS);
+    const overflow = refs.length - shown.length;
+    return (_jsxs("span", { className: cn('inline-flex shrink-0 items-center gap-px', className), children: [shown.map((ref, i) => (_jsx(CitationArrow, { citation: ref, index: refs.length > 1 ? i + 1 : undefined }, `${ref.kind}-${ref.kind === 'ref' ? ref.ref : ref.url}-${String(i)}`))), overflow > 0 && (_jsxs("span", { className: "text-[9px] font-semibold text-[var(--wui-fg-muted)]", title: `${String(overflow)} more source(s)`, children: ["+", overflow] }))] }));
+}
+//# sourceMappingURL=CitationArrow.js.map

package/dist/components/shared/CitationArrow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CitationArrow.js","sourceRoot":"","sources":["../../../src/components/shared/CitationArrow.tsx"],"names":[],"mappings":"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"}

package/dist/components/shared/MarkdownCitation.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Renders a `:::citation{…}` block: the statement as normal prose, trailed by a
+ * ↗ marker opening the source it came from.
+ *
+ * Named `MarkdownCitation`, not `Citation` — the SDK already has a `Citation`,
+ * the author-time overlay attached to a step's *config* in the builder. Same
+ * word, different concept; keeping the names apart keeps the two from being
+ * confused for one another.
+ */
+import type { ReactNode } from 'react';
+export interface MarkdownCitationProps {
+    /** Ref path into the workflow, as shown to the agent in a `[source: …]` label. */
+    ref?: string | undefined;
+    /** 1-based page within the resolved document. Arrives as a string from markdown. */
+    page?: string | undefined;
+    /** External source, as an alternative to `ref`. */
+    url?: string | undefined;
+    /** The exact source text, highlighted once the document opens. */
+    quote?: string | undefined;
+    /** Label for the url form. */
+    title?: string | undefined;
+    children?: ReactNode;
+}
+export declare function MarkdownCitation(props: MarkdownCitationProps): import("react").JSX.Element;
+//# sourceMappingURL=MarkdownCitation.d.ts.map

package/dist/components/shared/MarkdownCitation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownCitation.d.ts","sourceRoot":"","sources":["../../../src/components/shared/MarkdownCitation.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,MAAM,WAAW,qBAAqB;IACpC,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AA2BD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,+BAQ5D"}

package/dist/components/shared/MarkdownCitation.js

@@ -0,0 +1,31 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { CitationArrow } from './CitationArrow.js';
+/** Directive attributes are always strings; a page must survive as a real number. */
+function toPage(page) {
+    if (page === undefined)
+        return undefined;
+    const n = Number(page);
+    return Number.isInteger(n) && n >= 1 ? n : undefined;
+}
+function toCitation(props) {
+    // Checked here as well as in the sanitize schema: markdown reaches this
+    // component from an LLM, and a `javascript:` target must not become a link.
+    if (props.url !== undefined && /^https?:\/\//i.test(props.url)) {
+        return { kind: 'url', url: props.url, ...(props.title ? { title: props.title } : {}) };
+    }
+    if (props.ref !== undefined && props.ref !== '') {
+        const page = toPage(props.page);
+        return {
+            kind: 'ref',
+            ref: props.ref,
+            ...(page !== undefined ? { page } : {}),
+            ...(props.quote ? { quote: props.quote } : {}),
+        };
+    }
+    return undefined;
+}
+export function MarkdownCitation(props) {
+    const citation = toCitation(props);
+    return (_jsxs("span", { className: "wui-citation", children: [props.children, citation && _jsx(CitationArrow, { citation: citation })] }));
+}
+//# sourceMappingURL=MarkdownCitation.js.map

package/dist/components/shared/MarkdownCitation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownCitation.js","sourceRoot":"","sources":["../../../src/components/shared/MarkdownCitation.tsx"],"names":[],"mappings":";AAWA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAgBnD,qFAAqF;AACrF,SAAS,MAAM,CAAC,IAAwB;IACtC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,SAAS,UAAU,CAAC,KAA4B;IAC9C,wEAAwE;IACxE,4EAA4E;IAC5E,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/D,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACzF,CAAC;IACD,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,KAAK,EAAE,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO;YACL,IAAI,EAAE,KAAK;YACX,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/C,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAA4B;IAC3D,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,CACL,gBAAM,SAAS,EAAC,cAAc,aAC3B,KAAK,CAAC,QAAQ,EACd,QAAQ,IAAI,KAAC,aAAa,IAAC,QAAQ,EAAE,QAAQ,GAAI,IAC7C,CACR,CAAC;AACJ,CAAC"}

package/dist/components/shared/MarkdownView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MarkdownView.d.ts","sourceRoot":"","sources":["../../../src/components/shared/MarkdownView.tsx"],"names":[],"mappings":"AAOA,MAAM,WAAW,iBAAiB;IAChC,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,iBAAiB,+BA4D5E"}
+{"version":3,"file":"MarkdownView.d.ts","sourceRoot":"","sources":["../../../src/components/shared/MarkdownView.tsx"],"names":[],"mappings":"AAUA,MAAM,WAAW,iBAAiB;IAChC,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,iBAAiB,+BAmE5E"}

package/dist/components/shared/MarkdownView.js

@@ -1,10 +1,13 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import ReactMarkdown from 'react-markdown';
+import ReactMarkdown, {} from 'react-markdown';
 import remarkGfm from 'remark-gfm';
+import remarkDirective from 'remark-directive';
 import rehypeRaw from 'rehype-raw';
 import rehypeSanitize from 'rehype-sanitize';
 import { cn } from './cn.js';
 import { JsonView, tryParseJson } from './JsonView.js';
+import { MarkdownCitation } from './MarkdownCitation.js';
+import { remarkCitationDirective, citationSanitizeSchema } from './markdown-citation-directive.js';
 /**
  * Renders markdown (GitHub-flavored) to safe React nodes — no
  * `dangerouslySetInnerHTML`. Used for the workflow summary in both the builder
@@ -12,7 +15,20 @@ import { JsonView, tryParseJson } from './JsonView.js';
  * it works without a Tailwind typography plugin.
  */
 export function MarkdownView({ children, className, bare }) {
-    return (_jsx("div", { className: cn('wui-markdown min-w-0 max-w-full', !bare && 'text-[13px] leading-relaxed text-[var(--wui-fg)]', className), children: _jsx(ReactMarkdown, { remarkPlugins: [remarkGfm], rehypePlugins: [rehypeRaw, rehypeSanitize], components: {
+    return (_jsx("div", { className: cn('wui-markdown min-w-0 max-w-full', !bare && 'text-[13px] leading-relaxed text-[var(--wui-fg)]', className), children: _jsx(ReactMarkdown
+        // remarkDirective must precede remarkCitationDirective (the nodes have to
+        // exist before we map them). rehypeRaw stays ahead of rehypeSanitize so
+        // raw HTML is still sanitized — our <citation> survives the round-trip
+        // because the schema below admits it.
+        , { 
+            // remarkDirective must precede remarkCitationDirective (the nodes have to
+            // exist before we map them). rehypeRaw stays ahead of rehypeSanitize so
+            // raw HTML is still sanitized — our <citation> survives the round-trip
+            // because the schema below admits it.
+            remarkPlugins: [remarkGfm, remarkDirective, remarkCitationDirective], rehypePlugins: [rehypeRaw, [rehypeSanitize, citationSanitizeSchema]], 
+            // `citation` isn't an intrinsic element, so the map needs the cast;
+            // hast-util-to-jsx-runtime dispatches any tag present here by name.
+            components: {
                 h1: ({ node: _n, ...p }) => _jsx("h1", { className: "mb-2.5 mt-4 border-b border-[var(--wui-border)] pb-1.5 text-[15px] font-semibold text-[var(--wui-fg)] first:mt-0", ...p }),
                 h2: ({ node: _n, ...p }) => _jsx("h2", { className: "mb-2 mt-4 border-b border-[var(--wui-border)] pb-1 text-[13.5px] font-semibold text-[var(--wui-fg)] first:mt-0", ...p }),
                 h3: ({ node: _n, ...p }) => _jsx("h3", { className: "mb-1.5 mt-3 text-[12.5px] font-semibold text-[var(--wui-fg)] first:mt-0", ...p }),
@@ -45,6 +61,7 @@ export function MarkdownView({ children, className, bare }) {
                 th: ({ node: _n, ...p }) => _jsx("th", { className: "border-b border-[var(--wui-border)] bg-[var(--wui-bg-muted)] px-3 py-2 text-left font-semibold text-[var(--wui-fg)] [&:not(:last-child)]:border-r [&:not(:last-child)]:border-[var(--wui-border)]", ...p }),
                 td: ({ node: _n, ...p }) => _jsx("td", { className: "border-b border-[var(--wui-border)] px-3 py-2 align-top text-[var(--wui-fg)] [&:not(:last-child)]:border-r [&:not(:last-child)]:border-[var(--wui-border)]", ...p }),
                 hr: ({ node: _n, ...p }) => _jsx("hr", { className: "my-4 border-t border-[var(--wui-border)]", ...p }),
+                citation: MarkdownCitation,
             }, children: children }) }));
 }
 //# sourceMappingURL=MarkdownView.js.map

package/dist/components/shared/MarkdownView.js.map

@@ -1 +1 @@
-{"version":3,"file":"MarkdownView.js","sourceRoot":"","sources":["../../../src/components/shared/MarkdownView.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"MarkdownView.js","sourceRoot":"","sources":["../../../src/components/shared/MarkdownView.tsx"],"names":[],"mappings":"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"}

package/dist/components/shared/citation-context.d.ts

@@ -0,0 +1,35 @@
+import type { OriginResolverCtx } from '../execution/origin/origin-resolver.js';
+import type { ResolvedCitation } from '../execution/origin/citation-resolver.js';
+/**
+ * What a citation marker needs to turn a cited ref into an openable source: the
+ * workflow config + step outputs of the execution being read.
+ *
+ * Supplied by context rather than props because markers mount deep inside
+ * renderers that are otherwise data-only — the layout DSL's components and the
+ * markdown renderer — and threading a resolver through every one of them (and
+ * every existing caller) would be invasive for something most surfaces don't use.
+ *
+ * The default is `null`, and markers render nothing without it. So a surface that
+ * has no execution in scope (a summary, an approval reason, any of the many
+ * string-only markdown callers) keeps working untouched, and citations light up
+ * only where a provider is mounted.
+ */
+export declare const CitationOriginContext: import("react").Context<OriginResolverCtx | null>;
+export declare function useCitationOrigin(): OriginResolverCtx | null;
+/** Show a cited document. */
+export type OpenCitationDoc = (doc: Extract<ResolvedCitation, {
+    kind: 'doc';
+}>) => void;
+/**
+ * Where a cited document should open.
+ *
+ * A surface that can host a side-by-side panel (the run view) provides this, and
+ * the source opens as a resizable column beside the data — you keep the value and
+ * its evidence on screen together, which is the whole point of checking a citation.
+ *
+ * Without a provider the marker falls back to a modal, so surfaces with nowhere to
+ * put a panel (a preview, an embedded snippet) still open their sources.
+ */
+export declare const CitationOpenContext: import("react").Context<OpenCitationDoc | null>;
+export declare function useCitationOpener(): OpenCitationDoc | null;
+//# sourceMappingURL=citation-context.d.ts.map

package/dist/components/shared/citation-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citation-context.d.ts","sourceRoot":"","sources":["../../../src/components/shared/citation-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAEjF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qBAAqB,mDAAgD,CAAC;AAEnF,wBAAgB,iBAAiB,IAAI,iBAAiB,GAAG,IAAI,CAE5D;AAED,6BAA6B;AAC7B,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,gBAAgB,EAAE;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC,KAAK,IAAI,CAAC;AAExF;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,iDAA8C,CAAC;AAE/E,wBAAgB,iBAAiB,IAAI,eAAe,GAAG,IAAI,CAE1D"}

package/dist/components/shared/citation-context.js

@@ -0,0 +1,34 @@
+import { createContext, useContext } from 'react';
+/**
+ * What a citation marker needs to turn a cited ref into an openable source: the
+ * workflow config + step outputs of the execution being read.
+ *
+ * Supplied by context rather than props because markers mount deep inside
+ * renderers that are otherwise data-only — the layout DSL's components and the
+ * markdown renderer — and threading a resolver through every one of them (and
+ * every existing caller) would be invasive for something most surfaces don't use.
+ *
+ * The default is `null`, and markers render nothing without it. So a surface that
+ * has no execution in scope (a summary, an approval reason, any of the many
+ * string-only markdown callers) keeps working untouched, and citations light up
+ * only where a provider is mounted.
+ */
+export const CitationOriginContext = createContext(null);
+export function useCitationOrigin() {
+    return useContext(CitationOriginContext);
+}
+/**
+ * Where a cited document should open.
+ *
+ * A surface that can host a side-by-side panel (the run view) provides this, and
+ * the source opens as a resizable column beside the data — you keep the value and
+ * its evidence on screen together, which is the whole point of checking a citation.
+ *
+ * Without a provider the marker falls back to a modal, so surfaces with nowhere to
+ * put a panel (a preview, an embedded snippet) still open their sources.
+ */
+export const CitationOpenContext = createContext(null);
+export function useCitationOpener() {
+    return useContext(CitationOpenContext);
+}
+//# sourceMappingURL=citation-context.js.map

package/dist/components/shared/citation-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"citation-context.js","sourceRoot":"","sources":["../../../src/components/shared/citation-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAIlD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAA2B,IAAI,CAAC,CAAC;AAEnF,MAAM,UAAU,iBAAiB;IAC/B,OAAO,UAAU,CAAC,qBAAqB,CAAC,CAAC;AAC3C,CAAC;AAKD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAyB,IAAI,CAAC,CAAC;AAE/E,MAAM,UAAU,iBAAiB;IAC/B,OAAO,UAAU,CAAC,mBAAmB,CAAC,CAAC;AACzC,CAAC"}

package/dist/components/shared/citation.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Runtime-citation helpers for the reader side.
+ *
+ * The types live in the SDK (`@xyne/workflow-sdk/common`) — one definition, so
+ * the producer (agent step) and the renderers can't drift. This module adds only
+ * what reading needs: unwrapping a cited agent response, and walking the
+ * citation mirror alongside the data.
+ */
+import type { CitationRef, CitationMap } from '@xyne/workflow-sdk/common';
+import { isCitationRef, isCitationRefArray } from '@xyne/workflow-sdk/common';
+export type { CitationRef, CitationMap };
+export { isCitationRef, isCitationRefArray };
+/**
+ * The citation branch belonging to a child, indexed exactly as the value is.
+ *
+ * How containers walk data and citations in lockstep: since the mirror follows
+ * the value's shape, the key or index used to descend into one descends into the
+ * other. `undefined` in, `undefined` out — an uncited subtree just stays quiet.
+ */
+export declare function citeAt(cite: unknown, key: string | number): unknown;
+/**
+ * The citations for one data point, addressed by its path into the rendered data
+ * (`['response', 'total']`, `['response', 'lineItems', 0, 'amount']`).
+ *
+ * Exact match, not prefix: the mirror follows the data exactly, so a hit is the
+ * citations *for that leaf* and nothing is inherited from an ancestor. (Contrast
+ * `getFieldCitations` in origin-resolver, which is prefix-aware because author
+ * citations are written at a different granularity than they're read.)
+ */
+export declare function citationsAt(map: CitationMap, path: ReadonlyArray<string | number>): CitationRef[];
+/**
+ * Split a step's output into the data to render and a citation mirror **aligned
+ * to it**.
+ *
+ * A cited agent returns `output.response = { value, citation }`. We hoist `value`
+ * back into `response` so the panel shows the data itself rather than a wrapper,
+ * and nest the mirror under the same key — leaving citation and data the same
+ * shape, so one walk indexes both (`data.response.total` ↔ `citation.response.total`).
+ *
+ * Everything else — uncited agents, every other step type — passes through with
+ * `citation: undefined`, so renderers can call this unconditionally.
+ */
+export declare function unwrapResponse(output: Record<string, unknown> | undefined): {
+    data: Record<string, unknown>;
+    citation: CitationMap | undefined;
+};
+/**
+ * The matching unwrap for the declared output schema: `resolveOutputJsonSchema`
+ * describes a cited response as `{ value, citation }`, so hoist `value` back to
+ * `response` exactly as {@link unwrapResponse} does to the data. Without this the
+ * schema and the data would disagree about what `response` is, and the
+ * schema-driven renderer would fall back to a raw JSON dump.
+ */
+export declare function unwrapResponseSchema(schema: Record<string, unknown> | undefined, output: Record<string, unknown> | undefined): Record<string, unknown> | undefined;
+//# sourceMappingURL=citation.d.ts.map

package/dist/components/shared/citation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citation.d.ts","sourceRoot":"","sources":["../../../src/components/shared/citation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE9E,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,CAAC;AAE7C;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAInE;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,GACnC,WAAW,EAAE,CAOf;AAkBD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG;IAC3E,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,QAAQ,EAAE,WAAW,GAAG,SAAS,CAAC;CACnC,CAQA;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC1C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAOrC"}

package/dist/components/shared/citation.js

@@ -0,0 +1,83 @@
+import { isCitationRef, isCitationRefArray } from '@xyne/workflow-sdk/common';
+export { isCitationRef, isCitationRefArray };
+/**
+ * The citation branch belonging to a child, indexed exactly as the value is.
+ *
+ * How containers walk data and citations in lockstep: since the mirror follows
+ * the value's shape, the key or index used to descend into one descends into the
+ * other. `undefined` in, `undefined` out — an uncited subtree just stays quiet.
+ */
+export function citeAt(cite, key) {
+    return cite !== null && typeof cite === 'object'
+        ? cite[key]
+        : undefined;
+}
+/**
+ * The citations for one data point, addressed by its path into the rendered data
+ * (`['response', 'total']`, `['response', 'lineItems', 0, 'amount']`).
+ *
+ * Exact match, not prefix: the mirror follows the data exactly, so a hit is the
+ * citations *for that leaf* and nothing is inherited from an ancestor. (Contrast
+ * `getFieldCitations` in origin-resolver, which is prefix-aware because author
+ * citations are written at a different granularity than they're read.)
+ */
+export function citationsAt(map, path) {
+    let cur = map;
+    for (const seg of path) {
+        if (cur === null || typeof cur !== 'object')
+            return [];
+        cur = cur[seg];
+    }
+    return isCitationRefArray(cur) ? cur : [];
+}
+function citedWrapper(output) {
+    const response = output?.['response'];
+    if (response === null
+        || typeof response !== 'object'
+        || Array.isArray(response)
+        || !('value' in response || 'citation' in response)) {
+        return undefined;
+    }
+    const w = response;
+    return { value: w.value, citation: w.citation ?? {} };
+}
+/**
+ * Split a step's output into the data to render and a citation mirror **aligned
+ * to it**.
+ *
+ * A cited agent returns `output.response = { value, citation }`. We hoist `value`
+ * back into `response` so the panel shows the data itself rather than a wrapper,
+ * and nest the mirror under the same key — leaving citation and data the same
+ * shape, so one walk indexes both (`data.response.total` ↔ `citation.response.total`).
+ *
+ * Everything else — uncited agents, every other step type — passes through with
+ * `citation: undefined`, so renderers can call this unconditionally.
+ */
+export function unwrapResponse(output) {
+    const wrapper = citedWrapper(output);
+    if (!wrapper)
+        return { data: output ?? {}, citation: undefined };
+    return {
+        // Sibling agent fields (attachments, usage, toolCalls) are preserved.
+        data: { ...output, response: wrapper.value },
+        citation: { response: wrapper.citation },
+    };
+}
+/**
+ * The matching unwrap for the declared output schema: `resolveOutputJsonSchema`
+ * describes a cited response as `{ value, citation }`, so hoist `value` back to
+ * `response` exactly as {@link unwrapResponse} does to the data. Without this the
+ * schema and the data would disagree about what `response` is, and the
+ * schema-driven renderer would fall back to a raw JSON dump.
+ */
+export function unwrapResponseSchema(schema, output) {
+    if (!schema || !citedWrapper(output))
+        return schema;
+    const props = schema['properties'];
+    const response = props?.['response'];
+    const inner = response?.['properties']?.['value'];
+    if (!props || !inner)
+        return schema;
+    return { ...schema, properties: { ...props, response: inner } };
+}
+//# sourceMappingURL=citation.js.map

package/dist/components/shared/citation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"citation.js","sourceRoot":"","sources":["../../../src/components/shared/citation.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAG9E,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAAC,IAAa,EAAE,GAAoB;IACxD,OAAO,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAC9C,CAAC,CAAE,IAAqC,CAAC,GAAG,CAAC;QAC7C,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CACzB,GAAgB,EAChB,IAAoC;IAEpC,IAAI,GAAG,GAAY,GAAG,CAAC;IACvB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QACvD,GAAG,GAAI,GAAoC,CAAC,GAAG,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5C,CAAC;AAED,SAAS,YAAY,CACnB,MAA2C;IAE3C,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,CAAC;IACtC,IACE,QAAQ,KAAK,IAAI;WACd,OAAO,QAAQ,KAAK,QAAQ;WAC5B,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;WACvB,CAAC,CAAC,OAAO,IAAI,QAAQ,IAAI,UAAU,IAAI,QAAQ,CAAC,EACnD,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,CAAC,GAAG,QAAuD,CAAC;IAClE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;AACxD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,MAA2C;IAIxE,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjE,OAAO;QACL,sEAAsE;QACtE,IAAI,EAAE,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE;QAC5C,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE;KACzC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAA2C,EAC3C,MAA2C;IAE3C,IAAI,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IACpD,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAwC,CAAC;IAC1E,MAAM,QAAQ,GAAG,KAAK,EAAE,CAAC,UAAU,CAAwC,CAAC;IAC5E,MAAM,KAAK,GAAI,QAAQ,EAAE,CAAC,YAAY,CAAyC,EAAE,CAAC,OAAO,CAAC,CAAC;IAC3F,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK;QAAE,OAAO,MAAM,CAAC;IACpC,OAAO,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC;AAClE,CAAC"}

package/dist/components/shared/markdown-citation-directive.d.ts

@@ -0,0 +1,34 @@
+import type { Root } from 'mdast';
+import type { VFile } from 'vfile';
+/** The element the directive becomes; `components` maps it to MarkdownCitation. */
+export declare const CITATION_TAG = "citation";
+/**
+ * Map `:::citation{…}` onto a `<citation>` element carrying its attributes, and
+ * neutralise every other directive (see {@link revertToSource}).
+ */
+export declare function remarkCitationDirective(): (tree: Root, file: VFile) => void;
+/**
+ * `defaultSchema` plus the `citation` element.
+ *
+ * Without this, sanitize doesn't merely ignore `<citation>` — it **unwraps** it,
+ * dropping the marker while keeping the text, so citations would silently vanish.
+ * Only our five attributes are allowed through, and `url` is confined to http(s),
+ * so the directive can't smuggle in markup or a `javascript:` target.
+ */
+export declare const citationSanitizeSchema: {
+    tagNames: string[];
+    attributes: {
+        citation: ("ref" | "title" | "url" | "page" | "quote")[];
+    };
+    protocols: {
+        url: string[];
+    };
+    allowComments?: boolean | null | undefined;
+    allowDoctypes?: boolean | null | undefined;
+    ancestors?: Record<string, Array<string>> | null | undefined;
+    clobber?: Array<string> | null | undefined;
+    clobberPrefix?: string | null | undefined;
+    required?: Record<string, Record<string, import("hast").Properties[keyof import("hast").Properties]>> | null | undefined;
+    strip?: Array<string> | null | undefined;
+};
+//# sourceMappingURL=markdown-citation-directive.d.ts.map

package/dist/components/shared/markdown-citation-directive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-citation-directive.d.ts","sourceRoot":"","sources":["../../../src/components/shared/markdown-citation-directive.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAInC,mFAAmF;AACnF,eAAO,MAAM,YAAY,aAAa,CAAC;AAgDvC;;;GAGG;AACH,wBAAgB,uBAAuB,KAC7B,MAAM,IAAI,EAAE,MAAM,KAAK,KAAG,IAAI,CAiCvC;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;CAWlC,CAAC"}

package/dist/components/shared/markdown-citation-directive.js

@@ -0,0 +1,110 @@
+/**
+ * `:::citation{…}` support for {@link MarkdownView} — the markdown half of runtime
+ * citations, mirroring what `cite={…}` does for structured data.
+ *
+ * An agent writing prose wraps each sourced statement in a container directive:
+ *
+ *   :::citation{ref="steps.ocr.output.results.0.data" page=3 quote="TOTAL 5000"}
+ *   The invoice totals ₹5,000.
+ *   :::
+ *
+ * which renders the statement plus a ↗ marker opening the source.
+ */
+import { visit, SKIP } from 'unist-util-visit';
+import { defaultSchema } from 'rehype-sanitize';
+import { CITATION_DIRECTIVE_ATTRS } from '@xyne/workflow-sdk/common';
+/** The element the directive becomes; `components` maps it to MarkdownCitation. */
+export const CITATION_TAG = 'citation';
+const DIRECTIVE_TYPES = new Set(['containerDirective', 'leafDirective', 'textDirective']);
+/**
+ * Replace a node with the exact markdown it was parsed from.
+ *
+ * Enabling remark-directive turns on `:name` / `::name` / `:::name` **globally**,
+ * for every MarkdownView caller — so text that merely looks like a directive
+ * (`:release:`, a `:shrug` shortcode) would parse into an unknown node that
+ * rehype-sanitize then unwraps, silently deleting the author's words. Restoring
+ * the original source keeps this feature from changing any prose but our own.
+ *
+ * The source is sliced by the node's own offsets, so it round-trips exactly
+ * rather than being re-serialised approximately.
+ */
+function revertToSource(node, source) {
+    const start = node.position?.start.offset;
+    const end = node.position?.end.offset;
+    if (start === undefined || end === undefined)
+        return false;
+    const literal = source.slice(start, end);
+    delete node.name;
+    delete node.attributes;
+    delete node.data;
+    if (node.type === 'textDirective') {
+        node.type = 'text';
+        node.value = literal;
+        delete node.children;
+        return true;
+    }
+    // Block-level: `text` isn't valid where a block directive sat, so wrap it.
+    node.type = 'paragraph';
+    node.children = [{ type: 'text', value: literal }];
+    return true;
+}
+/**
+ * Map `:::citation{…}` onto a `<citation>` element carrying its attributes, and
+ * neutralise every other directive (see {@link revertToSource}).
+ */
+export function remarkCitationDirective() {
+    return (tree, file) => {
+        const source = String(file.value);
+        visit(tree, (node) => {
+            const n = node;
+            if (!DIRECTIVE_TYPES.has(n.type))
+                return;
+            if (n.type === 'containerDirective' && n.name === CITATION_TAG) {
+                const attrs = n.attributes ?? {};
+                const props = {};
+                for (const key of CITATION_DIRECTIVE_ATTRS) {
+                    const v = attrs[key];
+                    if (typeof v === 'string' && v !== '')
+                        props[key] = v;
+                }
+                // A lone paragraph would put a block inside our inline wrapper and push
+                // the marker onto its own line; unwrap it so the marker trails the text.
+                const kids = n.children;
+                if (Array.isArray(kids) && kids.length === 1) {
+                    const only = kids[0];
+                    if (only.type === 'paragraph' && Array.isArray(only.children)) {
+                        n.children = only.children;
+                    }
+                }
+                const data = n.data ?? (n.data = {});
+                data['hName'] = CITATION_TAG;
+                data['hProperties'] = props;
+                return;
+            }
+            if (revertToSource(n, source))
+                return SKIP;
+            return;
+        });
+    };
+}
+/**
+ * `defaultSchema` plus the `citation` element.
+ *
+ * Without this, sanitize doesn't merely ignore `<citation>` — it **unwraps** it,
+ * dropping the marker while keeping the text, so citations would silently vanish.
+ * Only our five attributes are allowed through, and `url` is confined to http(s),
+ * so the directive can't smuggle in markup or a `javascript:` target.
+ */
+export const citationSanitizeSchema = {
+    ...defaultSchema,
+    tagNames: [...(defaultSchema.tagNames ?? []), CITATION_TAG],
+    attributes: {
+        ...defaultSchema.attributes,
+        [CITATION_TAG]: [...CITATION_DIRECTIVE_ATTRS],
+    },
+    protocols: {
+        ...defaultSchema.protocols,
+        url: ['http', 'https'],
+    },
+};
+//# sourceMappingURL=markdown-citation-directive.js.map

package/dist/components/shared/markdown-citation-directive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-citation-directive.js","sourceRoot":"","sources":["../../../src/components/shared/markdown-citation-directive.ts"],"names":[],"mappings":"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"}