@vertesia/ui 1.5.0-dev.20260722.120446Z → 1.5.0-dev.20260725.083715Z

package/lib/widgets/markdown/AgentResourceResolver.d.ts

@@ -0,0 +1,31 @@
+import type { AgentResourceAction, AgentResourceType } from '@vertesia/common';
+/** Resource identity accepted by link resolvers from either structured tool metadata or Markdown. */
+export interface AgentResourceLinkReference {
+    type: AgentResourceType;
+    id: string;
+    label?: string;
+    action?: AgentResourceAction;
+    revision_id?: string;
+}
+export type AgentResourceTarget = {
+    kind: 'navigate';
+    href: string;
+} | {
+    kind: 'activate';
+    onActivate: () => void;
+} | {
+    kind: 'none';
+};
+export interface ResourceResolveContext {
+    workflowRunId?: string;
+    source: 'structured' | 'markdown';
+    /** Original custom-scheme URL when the reference came from Markdown. */
+    rawHref?: string;
+}
+export type AgentResourceResolver = (ref: AgentResourceLinkReference, context: ResourceResolveContext) => AgentResourceTarget;
+/** Supplies host-specific navigation for reusable chat and Markdown components. */
+export declare const AgentResourceResolverProvider: import("react").Provider<AgentResourceResolver>;
+export declare function useAgentResourceResolver(): AgentResourceResolver;
+/** Converts a supported agent Markdown scheme into the same resource identity used by tool metadata. */
+export declare function parseAgentResourceHref(rawHref: string): AgentResourceLinkReference | undefined;
+//# sourceMappingURL=AgentResourceResolver.d.ts.map

package/lib/widgets/markdown/AgentResourceResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentResourceResolver.d.ts","sourceRoot":"","sources":["../../../src/widgets/markdown/AgentResourceResolver.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG/E,qGAAqG;AACrG,MAAM,WAAW,0BAA0B;IACvC,IAAI,EAAE,iBAAiB,CAAC;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,mBAAmB,GACzB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,IAAI,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvB,MAAM,WAAW,sBAAsB;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,YAAY,GAAG,UAAU,CAAC;IAClC,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,qBAAqB,GAAG,CAChC,GAAG,EAAE,0BAA0B,EAC/B,OAAO,EAAE,sBAAsB,KAC9B,mBAAmB,CAAC;AAKzB,mFAAmF;AACnF,eAAO,MAAM,6BAA6B,iDAAwC,CAAC;AAEnF,wBAAgB,wBAAwB,IAAI,qBAAqB,CAEhE;AAcD,wGAAwG;AACxG,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS,CAiB9F"}

package/lib/widgets/markdown/AgentResourceResolver.js

@@ -0,0 +1,39 @@
+import { createContext, useContext } from 'react';
+const unresolvedAgentResourceResolver = () => ({ kind: 'none' });
+const AgentResourceResolverContext = createContext(unresolvedAgentResourceResolver);
+/** Supplies host-specific navigation for reusable chat and Markdown components. */
+export const AgentResourceResolverProvider = AgentResourceResolverContext.Provider;
+export function useAgentResourceResolver() {
+    return useContext(AgentResourceResolverContext);
+}
+const RESOURCE_SCHEME_TYPES = {
+    store: 'document',
+    document: 'document',
+    collection: 'collection',
+    interaction: 'interaction',
+    prompt: 'prompt',
+    agent: 'agent',
+    workflow: 'workflow',
+    process: 'process',
+    run: 'interaction_run',
+};
+/** Converts a supported agent Markdown scheme into the same resource identity used by tool metadata. */
+export function parseAgentResourceHref(rawHref) {
+    const colonIndex = rawHref.indexOf(':');
+    if (colonIndex <= 0)
+        return undefined;
+    const scheme = rawHref.slice(0, colonIndex);
+    if (!Object.hasOwn(RESOURCE_SCHEME_TYPES, scheme))
+        return undefined;
+    const id = rawHref
+        .slice(colonIndex + 1)
+        .trim()
+        .replace(/^\/+/, '');
+    if (!id)
+        return undefined;
+    return {
+        type: RESOURCE_SCHEME_TYPES[scheme],
+        id,
+    };
+}
+//# sourceMappingURL=AgentResourceResolver.js.map

package/lib/widgets/markdown/AgentResourceResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentResourceResolver.js","sourceRoot":"","sources":["../../../src/widgets/markdown/AgentResourceResolver.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AA4BlD,MAAM,+BAA+B,GAA0B,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;AACxF,MAAM,4BAA4B,GAAG,aAAa,CAAwB,+BAA+B,CAAC,CAAC;AAE3G,mFAAmF;AACnF,MAAM,CAAC,MAAM,6BAA6B,GAAG,4BAA4B,CAAC,QAAQ,CAAC;AAEnF,MAAM,UAAU,wBAAwB;IACpC,OAAO,UAAU,CAAC,4BAA4B,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,qBAAqB,GAAG;IAC1B,KAAK,EAAE,UAAU;IACjB,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAC1B,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,GAAG,EAAE,iBAAiB;CAC4B,CAAC;AAEvD,wGAAwG;AACxG,MAAM,UAAU,sBAAsB,CAAC,OAAe;IAClD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,UAAU,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAEtC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAEpE,MAAM,EAAE,GAAG,OAAO;SACb,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC;SACrB,IAAI,EAAE;SACN,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACzB,IAAI,CAAC,EAAE;QAAE,OAAO,SAAS,CAAC;IAE1B,OAAO;QACH,IAAI,EAAE,qBAAqB,CAAC,MAA4C,CAAC;QACzE,EAAE;KACL,CAAC;AACN,CAAC"}

package/lib/widgets/markdown/ArtifactEditingSurface.d.ts

@@ -0,0 +1,63 @@
+import { type MarkdownEditingAction } from './CollaborativeMarkdownRenderer.js';
+export declare function isArtifactRefreshEvent(details: Record<string, unknown> | undefined, path: string): boolean;
+export declare function applyArtifactRefreshChanges(content: string, details: Record<string, unknown> | undefined): string | undefined;
+export interface ArtifactEditingSurfaceDocumentEdit {
+    /** Working-copy content the agent last knew (hydration, its own edits, or the last hand-off). */
+    previous: string;
+    /** Persisted working-copy content after the user's direct edits. */
+    current: string;
+}
+/** Working-copy save state of the document editor. `idle` means nothing to show. */
+export type ArtifactSaveStatus = 'idle' | 'saving' | 'saved';
+export interface ArtifactEditingSurfaceProps {
+    runId?: string;
+    path: string;
+    initialContent?: string;
+    refreshKey?: number;
+    refreshDetails?: Record<string, unknown>;
+    readOnly?: boolean;
+    /** Keep comment controls enabled when content mutations are read-only. */
+    allowComments?: boolean;
+    viewMode?: 'components' | 'document';
+    /** Canonical Markdown used by the full editor's change ruler. */
+    baselineContent?: string;
+    className?: string;
+    onAction?: (action: MarkdownEditingAction) => void | Promise<void>;
+    /** Send a composed batch of span comments to the agent as one conversation message. */
+    onSendMessage?: (message: string) => void | Promise<void>;
+    /** Hand persisted full-document edits to the active agent. */
+    onSendChangesToAgent?: () => void | Promise<void>;
+    hasUnsentChanges?: boolean;
+    isSendingChanges?: boolean;
+    sendChangesDisabled?: boolean;
+    /** Compact status rendered beside the full editor's document hand-off action. */
+    toolbarStatus?: React.ReactNode;
+    onContentChange?: (content: string, generation?: string) => void;
+    onDocumentEdit?: () => void;
+    /**
+     * Reports document-editor save state so a parent can render its own indicator
+     * (e.g. next to the file name). When provided, the built-in floating badge is
+     * suppressed and the parent owns the display.
+     */
+    onSaveStatusChange?: (status: ArtifactSaveStatus) => void;
+    /**
+     * Imperative flush used before handing direct full-document edits to the agent.
+     * Resolves false when the flush failed; otherwise returns the delta since the
+     * agent's last known state and advances that baseline to the flushed content.
+     */
+    flushChangesRef?: React.MutableRefObject<(() => Promise<false | ArtifactEditingSurfaceDocumentEdit>) | null>;
+}
+export interface MarkdownChangeRegion {
+    startLine: number;
+    endLine: number;
+}
+/** Maps structured diff hunks onto current-document line numbers. */
+export declare function getMarkdownChangeRegions(before: string, after: string): MarkdownChangeRegion[];
+/**
+ * Shared artifact-backed Markdown editor used by both agent workspaces and
+ * document editing sessions. The artifact is updated conditionally using its
+ * backend-neutral blob generation; the previously rendered content stays in
+ * place while a newer generation is loading.
+ */
+export declare function ArtifactEditingSurface({ runId, path, initialContent, refreshKey, refreshDetails, readOnly, allowComments, viewMode, baselineContent, className, onAction, onSendMessage, onSendChangesToAgent, hasUnsentChanges, isSendingChanges, sendChangesDisabled, toolbarStatus, onContentChange, onDocumentEdit, onSaveStatusChange, flushChangesRef, }: ArtifactEditingSurfaceProps): import("react").JSX.Element;
+//# sourceMappingURL=ArtifactEditingSurface.d.ts.map

package/lib/widgets/markdown/ArtifactEditingSurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArtifactEditingSurface.d.ts","sourceRoot":"","sources":["../../../src/widgets/markdown/ArtifactEditingSurface.tsx"],"names":[],"mappings":"AAKA,OAAO,EAGH,KAAK,qBAAqB,EAC7B,MAAM,oCAAoC,CAAC;AAW5C,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAW1G;AAED,wBAAgB,2BAA2B,CACvC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC7C,MAAM,GAAG,SAAS,CAqBpB;AA+CD,MAAM,WAAW,kCAAkC;IAC/C,iGAAiG;IACjG,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;CACnB;AAiBD,oFAAoF;AACpF,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE7D,MAAM,WAAW,2BAA2B;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IACrC,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,uFAAuF;IACvF,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,8DAA8D;IAC9D,oBAAoB,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,iFAAiF;IACjF,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAChC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC1D;;;;OAIG;IACH,eAAe,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,OAAO,CAAC,KAAK,GAAG,kCAAkC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;CAChH;AAED,MAAM,WAAW,oBAAoB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,qEAAqE;AACrE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAE9F;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,EACnC,KAAK,EACL,IAAI,EACJ,cAAmB,EACnB,UAAc,EACd,cAAc,EACd,QAAgB,EAChB,aAAqB,EACrB,QAAuB,EACvB,eAAe,EACf,SAAS,EACT,QAAQ,EACR,aAAa,EACb,oBAAoB,EACpB,gBAAwB,EACxB,gBAAwB,EACxB,mBAA2B,EAC3B,aAAa,EACb,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,eAAe,GAClB,EAAE,2BAA2B,+BA+pB7B"}