@xyne/workflow-ui 1.3.10 → 1.3.12

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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"}

package/dist/components/shared/viewers/PdfView.d.ts

@@ -0,0 +1,38 @@
+import { type ReactNode } from 'react';
+export interface PdfViewProps {
+    /** Same-origin URL for the raw PDF bytes (cookie auth). */
+    url: string;
+    /** Display name shown in the toolbar and used for the download filename. */
+    name?: string | undefined;
+    /** 1-indexed page to scroll to on first load (e.g. a citation's pageNumber). */
+    initialPage?: number | undefined;
+    /**
+     * Initial zoom. A number is a literal scale (1 = 100%); the named pdf.js
+     * modes fit the page to the container. Defaults to `'page-width'` because
+     * this viewer is embedded in a narrow, resizable side panel — a literal
+     * 100% would overflow horizontally. Named modes re-fit on container resize;
+     * once the user zooms manually we stop re-fitting.
+     */
+    initialScale?: number | 'page-width' | 'page-fit' | 'page-actual' | 'auto' | undefined;
+    /**
+     * Bump this to re-jump to `initialPage` even when the value didn't change —
+     * lets a host pull the user back to the cited page on re-click. Also
+     * re-applies `highlightQuery`.
+     */
+    navSeq?: number | undefined;
+    /**
+     * When provided, prefills the Find input and pdf.js's findController
+     * highlights matches in the text layer.
+     */
+    highlightQuery?: string | null | undefined;
+    /** Leading slot in the toolbar (e.g. a Back button). */
+    leading?: ReactNode;
+    /** Optional right-side companion rendered alongside the scroll area. */
+    rightSlot?: ReactNode;
+    /** Extreme-right Close button — only when the host wants a dismiss affordance. */
+    onClose?: (() => void) | undefined;
+    /** Hide the Download link. */
+    hideDownload?: boolean | undefined;
+}
+export default function PdfView({ url, name, initialPage, initialScale, navSeq, highlightQuery, leading, rightSlot, onClose, hideDownload, }: PdfViewProps): import("react").JSX.Element;
+//# sourceMappingURL=PdfView.d.ts.map

package/dist/components/shared/viewers/PdfView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PdfView.d.ts","sourceRoot":"","sources":["../../../../src/components/shared/viewers/PdfView.tsx"],"names":[],"mappings":"AAyBA,OAAO,EAA4C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AA8FjF,MAAM,WAAW,YAAY;IAC3B,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,UAAU,GAAG,aAAa,GAAG,MAAM,GAAG,SAAS,CAAC;IACvF;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3C,wDAAwD;IACxD,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,wEAAwE;IACxE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,kFAAkF;IAClF,OAAO,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACnC,8BAA8B;IAC9B,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACpC;AAKD,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,EAC9B,GAAG,EACH,IAAiB,EACjB,WAAW,EACX,YAA2B,EAC3B,MAAM,EACN,cAAc,EACd,OAAO,EACP,SAAS,EACT,OAAO,EACP,YAAoB,GACrB,EAAE,YAAY,+BA0ed"}