create_artifact_group
Bundle multiple web files into one runnable project, save it to HyperVault, and receive a URL that opens an integrated editor/preview with all files working together.
Instructions
Save a multi-file "artifact group" — several .html/.css/.js/.jsx files that run together as one project — to the user's HyperVault.
Unlike save_to_hypervault (a single file), a group bundles a whole
little project: markup, styles, and script(s) as separate files that
reference each other normally (e.g. <link href="style.css">,
<script src="app.js">). It is always run/previewed as a container,
similar to a JSFiddle: the returned URL opens a minimal editor/preview
UI where the files render together, routed through the required root
index.html.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Optional tags for organizing the vault (also power auto-connections between items sharing a tag). | |
| files | Yes | The group's files, e.g. [{"path": "index.html", "content": "<html>...</html>"}, {"path": "style.css", "content": "body { ... }"}, {"path": "app.js", "content": "console.log('hi')"}]. Rules (validated locally before any network call): - Must include exactly one root file at path "index.html" — the entry point the container routes through. A nested one like "public/index.html" does not count. - Paths must be relative, use '/' separators, contain no '..' segments, and only [A-Za-z0-9._/-] characters. - Extensions are limited to .html, .css, .js, .jsx. - At most 50 files; 256 KB per file; 1 MB total. - Paths must be unique (case-insensitively). | |
| title | No | Human-friendly title shown in the user's vault. | Untitled |
| connect_to | No | Titles or slugs of related artifacts/groups to link. | |
| visibility | No | "private" (default) or "public". | private |
| source_prompt | No | The prompt that produced this group, if any — baked in the same way save_to_hypervault embeds it, so a later agent can read it back and iterate. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||