@jini-ai/chat 0.1.0

package/dist/core/util/strip.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Remove the first real `<artifact …>…</artifact>` block from `content`.
+ *
+ * "Real" excludes any `<artifact` substring that a Markdown-rendering chat
+ * surface would render as inline code or part of a fenced code block —
+ * those are literal recitations of the protocol and must survive intact,
+ * otherwise a rendered reply gets silently truncated mid-explanation.
+ *
+ * If no real open tag exists, `content` is returned unchanged. If a real
+ * open exists but no matching real close is found, `content` is also
+ * returned unchanged (refusing to strip is safer than truncating to
+ * end-of-string when a tag is malformed or still streaming).
+ *
+ * @complexity O(n) in `content.length` — one skip-range computation plus a
+ *   pair of linear scans for the open/close tags.
+ */
+export declare function stripArtifact(content: string): string;
+/**
+ * Display-only cleanup for a fallback shape some models emit: a complete
+ * HTML document as a standalone reply, or as a single ```html fenced block,
+ * instead of using the `<artifact>` protocol. A host that persists that
+ * recovered document as a real file (see `resolvePersistedArtifactHtml` in
+ * `./recover.js`) uses this helper to remove the now-duplicate raw document
+ * from the rendered chat bubble.
+ *
+ * Must never be used to rewrite the canonical stored message content — only
+ * the *display* copy — because that content is the transcript future agent
+ * turns and forked conversations read from.
+ *
+ * @complexity O(n) in `content.length` (plus one bounded regex scan over `sourceText` for the fence-recovery path).
+ */
+export declare function stripRecoveredHtmlFallbackForDisplay(content: string, sourceText?: string): string;
+/**
+ * A persisted file a host confirms an artifact save wrote to storage.
+ * `identifier` is the artifact manifest's `metadata.identifier` when present
+ * — the strongest link, since it survives a collision-suffix rename that
+ * would break a name-only match.
+ */
+export interface PersistedArtifactFileRef {
+    name: string;
+    identifier?: string;
+}
+/**
+ * Find the persisted file this artifact block was saved to, or `null` when
+ * persistence cannot be confirmed. Match order: manifest identifier first
+ * (strongest — survives collision-suffix renames), then the derived
+ * `<slug><ext>` / `<slug>-<n><ext>` file name.
+ *
+ * @complexity O(m) in `persistedFiles.length` (linear `find`s).
+ */
+export declare function matchPersistedArtifactFile(attrs: Record<string, string>, persistedFiles: ReadonlyArray<PersistedArtifactFileRef>): PersistedArtifactFileRef | null;
+/**
+ * Replace every real `<artifact …>…</artifact>` block whose body is
+ * CONFIRMED persisted to a file with a one-line summary, for use in a
+ * multi-turn transcript sent back to the agent.
+ *
+ * Once an artifact lives on disk, an agent reads/edits it from there, never
+ * from a transcript copy, so re-sending the whole body every turn is pure
+ * waste — a large artifact balloons every subsequent turn's input. The
+ * summary keeps the metadata the agent needs (`identifier`/`title`/`type`
+ * plus the saved file name) and points it at the on-disk file.
+ *
+ * Persistence is confirmed against `persistedFiles` — evidence a host
+ * derives from its own per-turn file-write bookkeeping (see
+ * {@link import('../transcript.js').buildTranscript}'s
+ * `resolvePersistedArtifactFiles` option). A save can fail validation or a
+ * write, in which case the transcript copy is the ONLY surviving artifact
+ * body — an unmatched block is left verbatim so a follow-up turn can still
+ * inspect or repair it.
+ *
+ * Uses the same skip-range / real-open detection as {@link stripArtifact},
+ * so a literal `<artifact …>` recited inside a code fence is left intact —
+ * only genuine protocol blocks are summarized. Malformed / still-streaming
+ * blocks (real open, no real close) are left untouched.
+ *
+ * @complexity O(n) in `content.length` across the whole scan (each iteration
+ *   consumes at least one full artifact block or the remaining tail), times
+ *   O(m) for the `persistedFiles` lookup per block.
+ */
+export declare function summarizeArtifactsForTranscript(content: string, persistedFiles: ReadonlyArray<PersistedArtifactFileRef>): string;
+export interface StreamingArtifact {
+    artifactType: string;
+    title: string;
+    identifier: string;
+    /** The artifact body received so far — raw, possibly mid-token. */
+    content: string;
+}
+/**
+ * Split `content` around the first real `<artifact …>` whose closing
+ * `</artifact>` has NOT yet arrived — i.e. an artifact whose body is still
+ * streaming in. Returns the text *before* the open tag as `head` (safe to
+ * render as Markdown) and the in-flight artifact as `live`.
+ *
+ * This is the streaming-display counterpart to {@link stripArtifact}: the
+ * stripper removes a *completed* block once `</artifact>` lands, whereas
+ * this surfaces the *incomplete* one so a chat surface can show a live
+ * preview instead of leaking the raw `<artifact …>` tag plus half-written
+ * body as text.
+ *
+ * Returns `{ head: content, live: null }` when there is no open artifact,
+ * when the open tag already has a matching close (defer to the stripper),
+ * or when the artifact `type` is a non-text/HTML kind (media artifacts must
+ * not render as a code panel). "Real" open detection reuses the same
+ * skip-range logic as the stripper.
+ *
+ * @complexity O(n) in `content.length`.
+ */
+export declare function splitStreamingArtifact(content: string): {
+    head: string;
+    live: StreamingArtifact | null;
+};
+//# sourceMappingURL=strip.d.ts.map

package/dist/core/util/strip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip.d.ts","sourceRoot":"","sources":["../../../src/core/util/strip.ts"],"names":[],"mappings":"AAsDA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAcrD;AA0DD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oCAAoC,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,SAAU,GAAG,MAAM,CASlG;AAED;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAyBD;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,cAAc,EAAE,aAAa,CAAC,wBAAwB,CAAC,GACtD,wBAAwB,GAAG,IAAI,CAUjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,aAAa,CAAC,wBAAwB,CAAC,GAAG,MAAM,CAqChI;AAUD,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAA;CAAE,CAgCxG"}

package/dist/core/util/strip.js

@@ -0,0 +1,333 @@
+/**
+ * @module strip
+ *
+ * Post-stream `<artifact>` removal/summarization and the streaming-display
+ * counterpart that surfaces an in-flight (not-yet-closed) artifact block.
+ */
+import { computeSkipRanges, isRealArtifactOpenAt, rangeContains } from './markdown-context.js';
+import { parseQuotedAttrs } from './markup-attributes.js';
+import { recoverHtmlArtifactFromPrecedingDocument, recoverHtmlDocumentFromMarkdownFence, recoverStandaloneHtmlDocument, } from './recover.js';
+const OPEN = '<artifact';
+const CLOSE = '</artifact>';
+const HTML_FENCE_RE = /```(?:html|HTML)\s*\n([\s\S]*?)\n```/g;
+function findUnskipped(content, needle, fromIndex, ranges) {
+    let from = fromIndex;
+    // `needle` (always `CLOSE`, non-empty) makes `content.indexOf` itself
+    // return -1 once `from` runs past `content.length` — the loop always exits
+    // through the `idx === -1` check below, so no bounded `while` or trailing
+    // fallback return is needed for this to provably terminate.
+    for (;;) {
+        const idx = content.indexOf(needle, from);
+        if (idx === -1)
+            return -1;
+        if (!rangeContains(ranges, idx))
+            return idx;
+        from = idx + needle.length;
+    }
+}
+// Like `findUnskipped(OPEN, …)` but also rejects prefix-shared literals like
+// `<artifactual` — only `<artifact` followed by whitespace counts as a real
+// protocol open. Matches the streaming parser's `findOpenTag` real-open guard
+// so the two paths agree on what a renderer will treat as a tag.
+function findRealOpen(content, fromIndex, ranges) {
+    let from = fromIndex;
+    // Same reasoning as findUnskipped: `OPEN` is a fixed non-empty literal, so
+    // `content.indexOf` alone provides the bound safety once `from` runs past
+    // `content.length` — no separate bounded `while` is needed.
+    for (;;) {
+        const idx = content.indexOf(OPEN, from);
+        if (idx === -1)
+            return -1;
+        if (rangeContains(ranges, idx) || !isRealArtifactOpenAt(content, idx)) {
+            from = idx + OPEN.length;
+            continue;
+        }
+        return idx;
+    }
+}
+/**
+ * Remove the first real `<artifact …>…</artifact>` block from `content`.
+ *
+ * "Real" excludes any `<artifact` substring that a Markdown-rendering chat
+ * surface would render as inline code or part of a fenced code block —
+ * those are literal recitations of the protocol and must survive intact,
+ * otherwise a rendered reply gets silently truncated mid-explanation.
+ *
+ * If no real open tag exists, `content` is returned unchanged. If a real
+ * open exists but no matching real close is found, `content` is also
+ * returned unchanged (refusing to strip is safer than truncating to
+ * end-of-string when a tag is malformed or still streaming).
+ *
+ * @complexity O(n) in `content.length` — one skip-range computation plus a
+ *   pair of linear scans for the open/close tags.
+ */
+export function stripArtifact(content) {
+    const { ranges: baseRanges, unclosedFenceStart } = computeSkipRanges(content);
+    // For complete (non-streaming) content, an unclosed fence renders as a code
+    // block extending to end of input — the stripper mirrors that, otherwise a
+    // literal `<artifact …>` tucked into a trailing code example (no trailing
+    // newline) gets treated as a real protocol tag and eaten.
+    const ranges = unclosedFenceStart !== null ? [...baseRanges, [unclosedFenceStart, content.length]] : baseRanges;
+    const open = findRealOpen(content, 0, ranges);
+    if (open === -1)
+        return content;
+    const closeTag = content.indexOf('>', open);
+    if (closeTag === -1)
+        return content;
+    const end = findUnskipped(content, CLOSE, closeTag, ranges);
+    if (end === -1)
+        return content;
+    return (content.slice(0, open) + content.slice(end + CLOSE.length)).trim();
+}
+function findSingleRecoverableHtmlFence(content) {
+    HTML_FENCE_RE.lastIndex = 0;
+    let recovered = null;
+    let count = 0;
+    let match = HTML_FENCE_RE.exec(content);
+    while (match !== null) {
+        const html = (match[1] || '').replace(/^/, '').trim();
+        if (recoverHtmlDocumentFromMarkdownFence(match[0]) === html) {
+            recovered = { start: match.index, end: match.index + match[0].length, html };
+            count += 1;
+        }
+        match = HTML_FENCE_RE.exec(content);
+    }
+    return count === 1 ? recovered : null;
+}
+function findRecoverablePrecedingHtmlArtifact(sourceText) {
+    const { ranges: baseRanges, unclosedFenceStart } = computeSkipRanges(sourceText);
+    const ranges = unclosedFenceStart !== null ? [...baseRanges, [unclosedFenceStart, sourceText.length]] : baseRanges;
+    let from = 0;
+    // `findRealOpen` already returns -1 once `from` runs past `sourceText.length`
+    // (it inherits the same `indexOf`-based bound safety), so this loop also
+    // always exits through an inner return — no trailing fallback needed.
+    for (;;) {
+        const open = findRealOpen(sourceText, from, ranges);
+        if (open === -1)
+            return null;
+        const closeTag = sourceText.indexOf('>', open);
+        if (closeTag === -1)
+            return null;
+        const end = findUnskipped(sourceText, CLOSE, closeTag, ranges);
+        if (end === -1)
+            return null;
+        const attrs = parseQuotedAttrs(sourceText.slice(open, closeTag));
+        const recovered = recoverHtmlArtifactFromPrecedingDocument({
+            artifactHtml: sourceText.slice(closeTag + 1, end),
+            identifier: attrs['identifier'],
+            sourceText,
+        });
+        if (recovered)
+            return recovered;
+        from = end + CLOSE.length;
+    }
+}
+function stripRecoverablePrecedingHtml(content, sourceText) {
+    const recovered = findRecoverablePrecedingHtmlArtifact(sourceText);
+    if (!recovered)
+        return null;
+    const start = content.lastIndexOf(recovered);
+    if (start === -1)
+        return null;
+    return `${content.slice(0, start)}${content.slice(start + recovered.length)}`.trim();
+}
+/**
+ * Display-only cleanup for a fallback shape some models emit: a complete
+ * HTML document as a standalone reply, or as a single ```html fenced block,
+ * instead of using the `<artifact>` protocol. A host that persists that
+ * recovered document as a real file (see `resolvePersistedArtifactHtml` in
+ * `./recover.js`) uses this helper to remove the now-duplicate raw document
+ * from the rendered chat bubble.
+ *
+ * Must never be used to rewrite the canonical stored message content — only
+ * the *display* copy — because that content is the transcript future agent
+ * turns and forked conversations read from.
+ *
+ * @complexity O(n) in `content.length` (plus one bounded regex scan over `sourceText` for the fence-recovery path).
+ */
+export function stripRecoveredHtmlFallbackForDisplay(content, sourceText = content) {
+    const withoutPrecedingDocument = stripRecoverablePrecedingHtml(content, sourceText);
+    if (withoutPrecedingDocument !== null)
+        return withoutPrecedingDocument;
+    if (recoverStandaloneHtmlDocument(content))
+        return '';
+    const fence = findSingleRecoverableHtmlFence(content);
+    if (!fence)
+        return content;
+    return `${content.slice(0, fence.start)}${content.slice(fence.end)}`.trim();
+}
+// The on-disk extension a persist path would pick from the artifact's type/identifier.
+function artifactExtensionForAttrs(attrs) {
+    const type = (attrs['type'] || '').toLowerCase();
+    const identifier = (attrs['identifier'] || '').toLowerCase();
+    if (type.includes('tsx') || identifier.endsWith('.tsx'))
+        return '.tsx';
+    if (type.includes('jsx') || type.includes('react') || identifier.endsWith('.jsx'))
+        return '.jsx';
+    if (type.includes('css') || identifier.endsWith('.css'))
+        return '.css';
+    if (type.includes('svg') || identifier.endsWith('.svg'))
+        return '.svg';
+    if (type.includes('markdown') || type === 'md' || identifier.endsWith('.md'))
+        return '.md';
+    return '.html';
+}
+// The slug a persist path would derive the file name from.
+function artifactBaseNameForAttrs(attrs) {
+    return ((attrs['identifier'] || attrs['title'] || 'artifact')
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 60) || 'artifact');
+}
+/**
+ * Find the persisted file this artifact block was saved to, or `null` when
+ * persistence cannot be confirmed. Match order: manifest identifier first
+ * (strongest — survives collision-suffix renames), then the derived
+ * `<slug><ext>` / `<slug>-<n><ext>` file name.
+ *
+ * @complexity O(m) in `persistedFiles.length` (linear `find`s).
+ */
+export function matchPersistedArtifactFile(attrs, persistedFiles) {
+    const identifier = attrs['identifier'] ?? '';
+    if (identifier) {
+        const byManifest = persistedFiles.find((f) => f.identifier === identifier);
+        if (byManifest)
+            return byManifest;
+    }
+    const ext = artifactExtensionForAttrs(attrs);
+    const base = artifactBaseNameForAttrs(attrs);
+    const namePattern = new RegExp(`^${base.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}(?:-\\d+)?${ext.replace('.', '\\.')}$`);
+    return persistedFiles.find((f) => namePattern.test(f.name)) ?? null;
+}
+/**
+ * Replace every real `<artifact …>…</artifact>` block whose body is
+ * CONFIRMED persisted to a file with a one-line summary, for use in a
+ * multi-turn transcript sent back to the agent.
+ *
+ * Once an artifact lives on disk, an agent reads/edits it from there, never
+ * from a transcript copy, so re-sending the whole body every turn is pure
+ * waste — a large artifact balloons every subsequent turn's input. The
+ * summary keeps the metadata the agent needs (`identifier`/`title`/`type`
+ * plus the saved file name) and points it at the on-disk file.
+ *
+ * Persistence is confirmed against `persistedFiles` — evidence a host
+ * derives from its own per-turn file-write bookkeeping (see
+ * {@link import('../transcript.js').buildTranscript}'s
+ * `resolvePersistedArtifactFiles` option). A save can fail validation or a
+ * write, in which case the transcript copy is the ONLY surviving artifact
+ * body — an unmatched block is left verbatim so a follow-up turn can still
+ * inspect or repair it.
+ *
+ * Uses the same skip-range / real-open detection as {@link stripArtifact},
+ * so a literal `<artifact …>` recited inside a code fence is left intact —
+ * only genuine protocol blocks are summarized. Malformed / still-streaming
+ * blocks (real open, no real close) are left untouched.
+ *
+ * @complexity O(n) in `content.length` across the whole scan (each iteration
+ *   consumes at least one full artifact block or the remaining tail), times
+ *   O(m) for the `persistedFiles` lookup per block.
+ */
+export function summarizeArtifactsForTranscript(content, persistedFiles) {
+    if (persistedFiles.length === 0)
+        return content;
+    let result = '';
+    let cursor = 0;
+    // Recompute skip ranges per iteration against the remaining tail so indices
+    // stay valid as we consume the string left to right.
+    while (cursor <= content.length) {
+        const tail = content.slice(cursor);
+        const { ranges: baseRanges, unclosedFenceStart } = computeSkipRanges(tail);
+        const ranges = unclosedFenceStart !== null ? [...baseRanges, [unclosedFenceStart, tail.length]] : baseRanges;
+        const open = findRealOpen(tail, 0, ranges);
+        if (open === -1) {
+            result += tail;
+            break;
+        }
+        const gt = tail.indexOf('>', open);
+        if (gt === -1) {
+            result += tail;
+            break;
+        }
+        const end = findUnskipped(tail, CLOSE, gt, ranges);
+        if (end === -1) {
+            // Real open but no real close — refuse to summarize (safer than eating
+            // to end-of-string on a malformed/streaming tag). Keep the rest as-is.
+            result += tail;
+            break;
+        }
+        const attrs = parseQuotedAttrs(tail.slice(open, gt));
+        const persisted = matchPersistedArtifactFile(attrs, persistedFiles);
+        result += persisted
+            ? tail.slice(0, open) + artifactTranscriptSummary(attrs, persisted)
+            : // Unconfirmed save — the transcript copy may be the only surviving
+                // body. Keep the block verbatim and keep scanning past it.
+                tail.slice(0, end + CLOSE.length);
+        cursor += end + CLOSE.length;
+    }
+    return result;
+}
+function artifactTranscriptSummary(attrs, persisted) {
+    const id = attrs['identifier'] ?? '';
+    const title = attrs['title'] ?? '';
+    const type = attrs['type'] ?? 'text/html';
+    const meta = [id ? `identifier="${id}"` : '', title ? `title="${title}"` : '', `type="${type}"`].filter(Boolean).join(', ');
+    return `[artifact emitted on a prior turn — ${meta}. Its full content was saved to the file "${persisted.name}" and is NOT repeated here. Read or modify that file on disk (list/grep the workspace directory if it was since renamed); do not rely on this transcript for its contents.]`;
+}
+/**
+ * Split `content` around the first real `<artifact …>` whose closing
+ * `</artifact>` has NOT yet arrived — i.e. an artifact whose body is still
+ * streaming in. Returns the text *before* the open tag as `head` (safe to
+ * render as Markdown) and the in-flight artifact as `live`.
+ *
+ * This is the streaming-display counterpart to {@link stripArtifact}: the
+ * stripper removes a *completed* block once `</artifact>` lands, whereas
+ * this surfaces the *incomplete* one so a chat surface can show a live
+ * preview instead of leaking the raw `<artifact …>` tag plus half-written
+ * body as text.
+ *
+ * Returns `{ head: content, live: null }` when there is no open artifact,
+ * when the open tag already has a matching close (defer to the stripper),
+ * or when the artifact `type` is a non-text/HTML kind (media artifacts must
+ * not render as a code panel). "Real" open detection reuses the same
+ * skip-range logic as the stripper.
+ *
+ * @complexity O(n) in `content.length`.
+ */
+export function splitStreamingArtifact(content) {
+    const { ranges: baseRanges, unclosedFenceStart } = computeSkipRanges(content);
+    const ranges = unclosedFenceStart !== null ? [...baseRanges, [unclosedFenceStart, content.length]] : baseRanges;
+    const open = findRealOpen(content, 0, ranges);
+    if (open === -1)
+        return { head: content, live: null };
+    const gt = content.indexOf('>', open);
+    if (gt === -1) {
+        // The open tag's attributes are still streaming — the type/title aren't
+        // known yet, but an artifact is starting, so show the box (empty body)
+        // and hide the partial `<artifact …` tail from Markdown.
+        return {
+            head: content.slice(0, open).replace(/\s+$/, ''),
+            live: { artifactType: '', title: '', identifier: '', content: '' },
+        };
+    }
+    // A matching close means the block is complete; defer to stripArtifact.
+    if (findUnskipped(content, CLOSE, gt, ranges) !== -1)
+        return { head: content, live: null };
+    const attrs = parseQuotedAttrs(content.slice(open, gt));
+    const artifactType = attrs['type'] ?? '';
+    // Only HTML/text artifacts read as code. An unknown type (attrs not fully
+    // parsed, or omitted) is treated as code-eligible since the dominant case
+    // is text/html; media/binary types fall through and render as raw text.
+    if (artifactType && !/html|text\//i.test(artifactType))
+        return { head: content, live: null };
+    return {
+        head: content.slice(0, open).replace(/\s+$/, ''),
+        live: {
+            artifactType,
+            title: attrs['title'] ?? '',
+            identifier: attrs['identifier'] ?? '',
+            content: content.slice(gt + 1),
+        },
+    };
+}
+//# sourceMappingURL=strip.js.map

package/dist/core/util/strip.js.map

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

package/dist/core/util/types.d.ts

@@ -0,0 +1,31 @@
+export type ArtifactKind = 'html' | 'deck' | 'react-component' | 'markdown-document' | 'svg' | 'diagram' | 'code-snippet' | 'mini-app' | 'design-system';
+export type ArtifactRendererId = 'html' | 'deck-html' | 'react-component' | 'markdown' | 'svg' | 'diagram' | 'code' | 'mini-app' | 'design-system';
+export type ArtifactExportKind = 'html' | 'pdf' | 'zip' | 'jsx' | 'md' | 'svg' | 'txt';
+export type ArtifactStatus = 'streaming' | 'complete' | 'error';
+/**
+ * The sidecar manifest an artifact-producing turn writes alongside its
+ * generated file, describing how to render/export it. Generic across
+ * artifact kinds — a host's own artifact-file type carries this manifest,
+ * not the other way around (see `ArtifactFile` in r4b §2, owned by
+ * `@jini-ai/artifacts-react`, not this package).
+ */
+export interface ArtifactManifest {
+    version: 1;
+    kind: ArtifactKind;
+    title: string;
+    entry: string;
+    renderer: ArtifactRendererId;
+    /** Optional for backward compatibility with older manifests; treat missing as `'complete'`. */
+    status?: ArtifactStatus | undefined;
+    exports: ArtifactExportKind[];
+    /** Optional primary-entry hint for multi-file outputs; fall back to renderable-file heuristics when omitted. */
+    primary?: string | boolean | undefined;
+    /** Reserved for future multi-file artifact packaging; not yet populated by any known generator. */
+    supportingFiles?: string[] | undefined;
+    createdAt?: string | undefined;
+    updatedAt?: string | undefined;
+    sourceSkillId?: string | undefined;
+    designSystemId?: string | null | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/util/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/util/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,MAAM,GACN,iBAAiB,GACjB,mBAAmB,GACnB,KAAK,GACL,SAAS,GACT,cAAc,GACd,UAAU,GACV,eAAe,CAAC;AAEpB,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN,WAAW,GACX,iBAAiB,GACjB,UAAU,GACV,KAAK,GACL,SAAS,GACT,MAAM,GACN,UAAU,GACV,eAAe,CAAC;AAEpB,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC;AAEvF,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,+FAA+F;IAC/F,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACpC,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,gHAAgH;IAChH,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACvC,mGAAmG;IACnG,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAChD"}

package/dist/core/util/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/util/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/util/types.ts"],"names":[],"mappings":""}

package/dist/core/util/validate.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @module validate
+ *
+ * Pre-write structural sniff for AI-emitted HTML artifacts.
+ *
+ * Defends an HTML-artifact persistence path against the failure mode where a
+ * model emits an `<artifact type="text/html">…</artifact>` block whose body
+ * is a prose summary instead of a complete document. Without this gate, such
+ * content can land on disk as a real `.html` file and pollute a file panel
+ * as a phantom artifact tab.
+ *
+ * Policy (intentionally narrow — false positives here block real saves):
+ * - non-empty after trimming BOM and leading whitespace
+ * - meets a minimum length threshold
+ * - the *first* non-whitespace token is `<!doctype html>` or `<html`
+ *   (anchored at the start; mid-string mentions of these tags do NOT count —
+ *   prose like "Updated the <html lang> attribute…" must be rejected)
+ * - URL-bearing attributes or CSS `url(...)` / `@import` values do not point
+ *   at a reserved internal workspace-storage path
+ *
+ * What this gate is NOT:
+ * - It is **not** an HTML linter or validator. Malformed but
+ *   recognizably document-shaped HTML passes; only content that obviously
+ *   isn't a document fails. The guarantee is "blocks obvious prose-as-HTML",
+ *   not "validates well-formed HTML."
+ * - It does **not** cover `.jsx`/`.tsx` or any other artifact kind — a caller
+ *   should only invoke this for an HTML-typed artifact.
+ * - It does **not** apply to user-driven file saves through some other path;
+ *   those may legitimately persist partial drafts.
+ *
+ * Threshold note: 64 chars rejects minimal empty-body documents like
+ * `<!doctype html><html><body></body></html>` (49 chars) — AI-emitted
+ * artifacts are expected to be non-trivial deliverables, not test fixtures,
+ * so the lower bound favors fewer phantom files over preserving
+ * fixture-grade empties.
+ */
+export type HtmlArtifactValidationResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Sniff-test whether `content` looks like a complete HTML document rather
+ * than prose that happens to mention HTML.
+ *
+ * @complexity O(n) in `content.length` — a handful of linear regex scans.
+ */
+export declare function validateHtmlArtifact(content: string): HtmlArtifactValidationResult;
+//# sourceMappingURL=validate.d.ts.map

package/dist/core/util/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/core/util/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAcH,MAAM,MAAM,4BAA4B,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAExF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,4BAA4B,CAelF"}