studiograph 1.3.48-next.21 → 1.3.48-next.211

package/dist/core/artifact-bundle.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Shared contract for agent-produced canvas artifacts.
+ *
+ * V1 is deliberately text-only: HTML, CSS, JS, SVG, JSON, and plain text files.
+ * Binary assets and network-dependent files are follow-up work, because this
+ * bundle is persisted in chat message metadata and rendered in a sandboxed
+ * iframe.
+ */
+export declare const ARTIFACT_BUNDLE_SCHEMA_VERSION = 1;
+export declare const ARTIFACT_BUNDLE_MAX_BYTES: number;
+export declare const ARTIFACT_KINDS: readonly ["html", "document", "slides", "social", "app", "custom"];
+export type ArtifactKind = typeof ARTIFACT_KINDS[number];
+export declare const ARTIFACT_VIEWPORT_MODES: readonly ["fixed", "responsive", "paged"];
+export type ArtifactViewportMode = typeof ARTIFACT_VIEWPORT_MODES[number];
+export declare const ARTIFACT_FULLSCREEN_FITS: readonly ["contain", "width", "none"];
+export type ArtifactFullscreenFit = typeof ARTIFACT_FULLSCREEN_FITS[number];
+export declare const ARTIFACT_DISPLAY_BACKGROUNDS: readonly ["neutral", "transparent"];
+export type ArtifactDisplayBackground = typeof ARTIFACT_DISPLAY_BACKGROUNDS[number];
+export declare const ARTIFACT_LIBRARY_KEYS: readonly ["three", "d3", "motion"];
+export type ArtifactLibraryKey = typeof ARTIFACT_LIBRARY_KEYS[number];
+export interface ArtifactDisplayViewport {
+    width: number;
+    height: number;
+}
+export interface ArtifactDisplayStepperControl {
+    selector?: string;
+    label?: string;
+}
+export interface ArtifactDisplayControls {
+    stepper?: ArtifactDisplayStepperControl;
+    reset?: boolean;
+}
+export interface ArtifactViewport {
+    width: number;
+    height: number;
+    mode: ArtifactViewportMode;
+}
+export interface ArtifactDisplay {
+    fullscreenFit?: ArtifactFullscreenFit;
+    background?: ArtifactDisplayBackground;
+    fullscreenViewport?: ArtifactDisplayViewport;
+    controls?: ArtifactDisplayControls;
+}
+export interface ArtifactSource {
+    repo?: string;
+    entityType?: string;
+    entityId?: string;
+    skillId?: string;
+}
+export interface ArtifactBundle {
+    schemaVersion: typeof ARTIFACT_BUNDLE_SCHEMA_VERSION;
+    artifactId: string;
+    title: string;
+    kind: ArtifactKind;
+    viewport: ArtifactViewport;
+    display?: ArtifactDisplay;
+    libraries?: ArtifactLibraryKey[];
+    files: Record<string, string>;
+    entrypoint: string;
+    source?: ArtifactSource;
+}
+export interface ArtifactValidationResult {
+    ok: boolean;
+    bundle?: ArtifactBundle;
+    errors: string[];
+    byteSize: number;
+}
+export declare function validateArtifactBundle(input: unknown): ArtifactValidationResult;
+export declare function assertArtifactBundle(input: unknown): ArtifactBundle;

package/dist/core/artifact-bundle.js

@@ -0,0 +1,305 @@
+/**
+ * Shared contract for agent-produced canvas artifacts.
+ *
+ * V1 is deliberately text-only: HTML, CSS, JS, SVG, JSON, and plain text files.
+ * Binary assets and network-dependent files are follow-up work, because this
+ * bundle is persisted in chat message metadata and rendered in a sandboxed
+ * iframe.
+ */
+export const ARTIFACT_BUNDLE_SCHEMA_VERSION = 1;
+export const ARTIFACT_BUNDLE_MAX_BYTES = 512 * 1024;
+export const ARTIFACT_KINDS = ['html', 'document', 'slides', 'social', 'app', 'custom'];
+export const ARTIFACT_VIEWPORT_MODES = ['fixed', 'responsive', 'paged'];
+export const ARTIFACT_FULLSCREEN_FITS = ['contain', 'width', 'none'];
+export const ARTIFACT_DISPLAY_BACKGROUNDS = ['neutral', 'transparent'];
+export const ARTIFACT_LIBRARY_KEYS = ['three', 'd3', 'motion'];
+const TEXT_EXTENSIONS = new Set([
+    '.html', '.htm', '.css', '.js', '.mjs', '.svg', '.json', '.txt', '.md',
+]);
+const ID_RE = /^[a-zA-Z0-9][a-zA-Z0-9._:-]{0,127}$/;
+const PATH_RE = /^[a-zA-Z0-9][a-zA-Z0-9._/-]{0,255}$/;
+function isRecord(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+function byteLength(value) {
+    return new TextEncoder().encode(JSON.stringify(value)).length;
+}
+function extensionOf(path) {
+    const dot = path.lastIndexOf('.');
+    return dot === -1 ? '' : path.slice(dot).toLowerCase();
+}
+function isSafePath(path) {
+    if (!PATH_RE.test(path))
+        return false;
+    if (path.includes('..'))
+        return false;
+    if (path.includes('//'))
+        return false;
+    if (/^[a-z][a-z0-9+.-]*:/i.test(path))
+        return false;
+    return true;
+}
+function normalizeString(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : null;
+}
+function inferArtifactLibraries(files) {
+    const text = Object.entries(files)
+        .filter(([path]) => /\.(html?|m?js|css|svg)$/i.test(path))
+        .map(([, content]) => content)
+        .join('\n');
+    const inferred = [];
+    if (/\b(?:window\.)?THREE\b/.test(text) || /\bfrom\s+['"]three(?:\/[^'"]*)?['"]/.test(text)) {
+        inferred.push('three');
+    }
+    if (/\b(?:window\.)?d3\b/.test(text) || /\bfrom\s+['"]d3(?:\/[^'"]*)?['"]/.test(text)) {
+        inferred.push('d3');
+    }
+    if (/\b(?:window\.)?Motion\b/.test(text)
+        || /\bmotion\.(?:animate|spring|inView|scroll)\b/.test(text)
+        || /\bfrom\s+['"]motion(?:\/[^'"]*)?['"]/.test(text)) {
+        inferred.push('motion');
+    }
+    return inferred;
+}
+export function validateArtifactBundle(input) {
+    const errors = [];
+    const byteSize = byteLength(input);
+    if (byteSize > ARTIFACT_BUNDLE_MAX_BYTES) {
+        errors.push(`Artifact bundle exceeds ${ARTIFACT_BUNDLE_MAX_BYTES} bytes`);
+    }
+    if (!isRecord(input)) {
+        return { ok: false, errors: ['Artifact bundle must be an object', ...errors], byteSize };
+    }
+    if (input.schemaVersion !== ARTIFACT_BUNDLE_SCHEMA_VERSION) {
+        errors.push(`schemaVersion must be ${ARTIFACT_BUNDLE_SCHEMA_VERSION}`);
+    }
+    const artifactId = normalizeString(input.artifactId);
+    if (!artifactId || !ID_RE.test(artifactId)) {
+        errors.push('artifactId must be a stable alphanumeric id');
+    }
+    const title = normalizeString(input.title);
+    if (!title)
+        errors.push('title is required');
+    const kind = normalizeString(input.kind);
+    if (!kind || !ARTIFACT_KINDS.includes(kind)) {
+        errors.push(`kind must be one of: ${ARTIFACT_KINDS.join(', ')}`);
+    }
+    const viewport = input.viewport;
+    let normalizedViewport = null;
+    if (!isRecord(viewport)) {
+        errors.push('viewport is required');
+    }
+    else {
+        const width = viewport.width;
+        const height = viewport.height;
+        const mode = viewport.mode;
+        if (typeof width !== 'number' || !Number.isFinite(width) || width < 120 || width > 10000) {
+            errors.push('viewport.width must be between 120 and 10000');
+        }
+        if (typeof height !== 'number' || !Number.isFinite(height) || height < 120 || height > 10000) {
+            errors.push('viewport.height must be between 120 and 10000');
+        }
+        if (typeof mode !== 'string' || !ARTIFACT_VIEWPORT_MODES.includes(mode)) {
+            errors.push(`viewport.mode must be one of: ${ARTIFACT_VIEWPORT_MODES.join(', ')}`);
+        }
+        if (typeof width === 'number' && typeof height === 'number' && typeof mode === 'string') {
+            normalizedViewport = {
+                width: Math.round(width),
+                height: Math.round(height),
+                mode: mode,
+            };
+        }
+    }
+    const entrypoint = normalizeString(input.entrypoint);
+    if (!entrypoint || !isSafePath(entrypoint)) {
+        errors.push('entrypoint must be a safe relative file path');
+    }
+    const files = input.files;
+    const normalizedFiles = {};
+    if (!isRecord(files)) {
+        errors.push('files must be an object of text file paths to string contents');
+    }
+    else {
+        const entries = Object.entries(files);
+        if (entries.length === 0)
+            errors.push('files must contain at least one file');
+        for (const [path, content] of entries) {
+            if (!isSafePath(path)) {
+                errors.push(`file path "${path}" must be a safe relative path`);
+                continue;
+            }
+            const ext = extensionOf(path);
+            if (!TEXT_EXTENSIONS.has(ext)) {
+                errors.push(`file "${path}" must be a supported text file`);
+            }
+            if (typeof content !== 'string') {
+                errors.push(`file "${path}" must be a string`);
+                continue;
+            }
+            normalizedFiles[path] = content;
+        }
+    }
+    if (entrypoint && !Object.prototype.hasOwnProperty.call(normalizedFiles, entrypoint)) {
+        errors.push('entrypoint must exist in files');
+    }
+    const declaredLibraries = new Set();
+    if (input.libraries !== undefined) {
+        if (!Array.isArray(input.libraries)) {
+            errors.push('libraries must be an array when provided');
+        }
+        else {
+            for (const library of input.libraries) {
+                if (typeof library !== 'string' || !ARTIFACT_LIBRARY_KEYS.includes(library)) {
+                    errors.push(`libraries must contain only: ${ARTIFACT_LIBRARY_KEYS.join(', ')}`);
+                    continue;
+                }
+                declaredLibraries.add(library);
+            }
+        }
+    }
+    let display;
+    if (input.display !== undefined) {
+        if (!isRecord(input.display)) {
+            errors.push('display must be an object when provided');
+        }
+        else {
+            display = {};
+            if (input.display.fullscreenFit !== undefined) {
+                if (typeof input.display.fullscreenFit !== 'string'
+                    || !ARTIFACT_FULLSCREEN_FITS.includes(input.display.fullscreenFit)) {
+                    errors.push(`display.fullscreenFit must be one of: ${ARTIFACT_FULLSCREEN_FITS.join(', ')}`);
+                }
+                else {
+                    display.fullscreenFit = input.display.fullscreenFit;
+                }
+            }
+            if (input.display.background !== undefined) {
+                if (typeof input.display.background !== 'string'
+                    || !ARTIFACT_DISPLAY_BACKGROUNDS.includes(input.display.background)) {
+                    errors.push(`display.background must be one of: ${ARTIFACT_DISPLAY_BACKGROUNDS.join(', ')}`);
+                }
+                else {
+                    display.background = input.display.background;
+                }
+            }
+            if (input.display.fullscreenViewport !== undefined) {
+                if (!isRecord(input.display.fullscreenViewport)) {
+                    errors.push('display.fullscreenViewport must be an object when provided');
+                }
+                else {
+                    const width = input.display.fullscreenViewport.width;
+                    const height = input.display.fullscreenViewport.height;
+                    if (typeof width !== 'number' || !Number.isFinite(width) || width < 120 || width > 10000) {
+                        errors.push('display.fullscreenViewport.width must be between 120 and 10000');
+                    }
+                    if (typeof height !== 'number' || !Number.isFinite(height) || height < 120 || height > 10000) {
+                        errors.push('display.fullscreenViewport.height must be between 120 and 10000');
+                    }
+                    if (typeof width === 'number' && typeof height === 'number') {
+                        display.fullscreenViewport = {
+                            width: Math.round(width),
+                            height: Math.round(height),
+                        };
+                    }
+                }
+            }
+            if (input.display.controls !== undefined) {
+                if (!isRecord(input.display.controls)) {
+                    errors.push('display.controls must be an object when provided');
+                }
+                else {
+                    const controls = {};
+                    let hasControls = false;
+                    if (input.display.controls.stepper !== undefined) {
+                        if (!isRecord(input.display.controls.stepper)) {
+                            errors.push('display.controls.stepper must be an object when provided');
+                        }
+                        else {
+                            const stepper = {};
+                            if (input.display.controls.stepper.selector !== undefined) {
+                                const selector = normalizeString(input.display.controls.stepper.selector);
+                                if (!selector || selector.length > 180) {
+                                    errors.push('display.controls.stepper.selector must be a non-empty string up to 180 characters');
+                                }
+                                else {
+                                    stepper.selector = selector;
+                                }
+                            }
+                            if (input.display.controls.stepper.label !== undefined) {
+                                const label = normalizeString(input.display.controls.stepper.label);
+                                if (!label || label.length > 40) {
+                                    errors.push('display.controls.stepper.label must be a non-empty string up to 40 characters');
+                                }
+                                else {
+                                    stepper.label = label;
+                                }
+                            }
+                            controls.stepper = stepper;
+                            hasControls = true;
+                        }
+                    }
+                    if (input.display.controls.reset !== undefined) {
+                        if (typeof input.display.controls.reset !== 'boolean') {
+                            errors.push('display.controls.reset must be a boolean when provided');
+                        }
+                        else {
+                            controls.reset = input.display.controls.reset;
+                            hasControls = true;
+                        }
+                    }
+                    if (hasControls)
+                        display.controls = controls;
+                }
+            }
+            if (Object.keys(display).length === 0)
+                display = undefined;
+        }
+    }
+    let source;
+    if (input.source !== undefined) {
+        if (!isRecord(input.source)) {
+            errors.push('source must be an object when provided');
+        }
+        else {
+            source = {};
+            for (const key of ['repo', 'entityType', 'entityId', 'skillId']) {
+                if (input.source[key] !== undefined) {
+                    const value = normalizeString(input.source[key]);
+                    if (!value)
+                        errors.push(`source.${key} must be a non-empty string`);
+                    else
+                        source[key] = value;
+                }
+            }
+        }
+    }
+    if (errors.length > 0 || !artifactId || !title || !kind || !entrypoint || !normalizedViewport) {
+        return { ok: false, errors, byteSize };
+    }
+    const libraries = Array.from(new Set([...declaredLibraries, ...inferArtifactLibraries(normalizedFiles)]));
+    return {
+        ok: true,
+        errors: [],
+        byteSize,
+        bundle: {
+            schemaVersion: ARTIFACT_BUNDLE_SCHEMA_VERSION,
+            artifactId,
+            title,
+            kind: kind,
+            viewport: normalizedViewport,
+            ...(display ? { display } : {}),
+            ...(libraries.length > 0 ? { libraries } : {}),
+            files: normalizedFiles,
+            entrypoint,
+            ...(source ? { source } : {}),
+        },
+    };
+}
+export function assertArtifactBundle(input) {
+    const result = validateArtifactBundle(input);
+    if (!result.ok || !result.bundle) {
+        throw new Error(result.errors.join('; ') || 'Invalid artifact bundle');
+    }
+    return result.bundle;
+}
+//# sourceMappingURL=artifact-bundle.js.map

package/dist/core/artifact-bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-bundle.js","sourceRoot":"","sources":["../../src/core/artifact-bundle.ts"],"names":[],"mappings":"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"}

package/dist/core/artifact-escape.d.ts

@@ -0,0 +1,5 @@
+export declare function escapeHtml(text: string): string;
+export declare function escapeAttribute(text: string): string;
+export declare function escapeScript(text: string): string;
+export declare function escapeStyle(text: string): string;
+export declare function encodeBase64(text: string): string;

package/dist/core/artifact-escape.js

@@ -0,0 +1,26 @@
+export function escapeHtml(text) {
+    return text
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+export function escapeAttribute(text) {
+    return escapeHtml(text).replace(/'/g, '&#39;');
+}
+export function escapeScript(text) {
+    return text.replace(/<\/script/gi, '<\\/script');
+}
+export function escapeStyle(text) {
+    return text.replace(/<\/style/gi, '<\\/style');
+}
+export function encodeBase64(text) {
+    const bytes = new TextEncoder().encode(text);
+    let binary = '';
+    const chunkSize = 0x8000;
+    for (let index = 0; index < bytes.length; index += chunkSize) {
+        binary += String.fromCharCode(...bytes.slice(index, index + chunkSize));
+    }
+    return btoa(binary);
+}
+//# sourceMappingURL=artifact-escape.js.map

package/dist/core/artifact-escape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-escape.js","sourceRoot":"","sources":["../../src/core/artifact-escape.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI;SACR,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,MAAM,SAAS,GAAG,MAAM,CAAC;IACzB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,SAAS,EAAE,CAAC;QAC7D,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC"}

package/dist/core/artifact-export.d.ts

@@ -0,0 +1,17 @@
+import type { ArtifactBundle, ArtifactLibraryKey } from './artifact-bundle.js';
+export type ArtifactExportExtension = 'html' | 'png' | 'pdf';
+export type ArtifactLibrarySourceKey = ArtifactLibraryKey | 'threeCore';
+export type ArtifactLibrarySources = Partial<Record<ArtifactLibrarySourceKey, string>>;
+export declare function artifactExportFilename(bundle: Pick<ArtifactBundle, 'artifactId' | 'title'>, extension?: ArtifactExportExtension): string;
+export interface ArtifactHtmlExportOptions {
+    context?: 'editor' | 'fullscreen' | 'export';
+    baseHref?: string;
+    includeRenderHostStyles?: boolean;
+    librarySources?: ArtifactLibrarySources;
+    /** Artifact-asset capability token. When set, `?at=<token>` is appended to
+     *  every `/api/assets/...` ref so a headless render (PNG/PDF) — which loads
+     *  the doc with no session cookie — can fetch workspace images. Not used for
+     *  the self-contained HTML zip (that rewrites refs to relative paths). */
+    assetToken?: string;
+}
+export declare function buildArtifactHtmlExport(bundle: ArtifactBundle, options?: ArtifactHtmlExportOptions): string;