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

package/dist/agent/skill-loader.js

@@ -1,26 +1,22 @@
 /**
  * Skill Loader — prompt skills for the Studiograph agent.
  *
- * Skills are markdown files with YAML frontmatter that inject domain-specific
- * knowledge into the agent's system prompt. Two formats supported:
+ * Skills come from two sources:
  *
- *   Directory skill:
- *     skills/create-deck/
- *       skill.md        ← required entrypoint
- *       slide-types.md  ← optional sub-files
+ *   1. Bundled filesystem skills — shipped with the app. Two formats:
+ *        Directory skill:   skills/create-deck/skill.md (+ optional sub-files)
+ *        Single-file skill: skills/quick-tip.md
+ *      Frontmatter fields: name, description, loading ("eager" | "on-demand").
  *
- *   Single-file skill:
- *     skills/quick-tip.md
- *
- * Frontmatter fields:
- *   name:        kebab-case identifier (defaults to directory/filename)
- *   description: shown in skill index so agent knows when to load it
- *   loading:     "on-demand" (default) | "eager" (inlined in system prompt)
+ *   2. Graph skills — authored by users as `skill` entities in any folder
+ *      (personal or shared). The entity id IS the skill name; `description`
+ *      and `loading` are frontmatter fields; the body markdown is the
+ *      instruction content. Graph skills use a `graph://<repo>/<id>`
+ *      entrypoint sentinel and are resolved via an optional graphResolver
+ *      callback passed to `loadSkillContent` / `loadEagerSkills`.
  */
 import { existsSync, readdirSync, readFileSync } from 'fs';
 import { join, extname, basename } from 'path';
-// Skills gated for MVP — re-enable when sync pipeline is production-ready
-const GATED_SKILLS = new Set(['sync-setup', 'sync-configuration', 'enrich-entities', 'obsidian-source-setup']);
 /**
  * Minimal YAML frontmatter parser — handles the subset used by skills.
  */
@@ -70,9 +66,6 @@ export function loadSkillIndex(skillsDirs) {
                     const content = readFileSync(skillMd, 'utf-8');
                     const { meta } = parseFrontmatter(content);
                     const name = meta.name || entry;
-                    // Skip sync/enrich skills for MVP
-                    if (GATED_SKILLS.has(name))
-                        continue;
                     if (!seen.has(name)) {
                         seen.add(name);
                         skills.push({
@@ -99,9 +92,6 @@ export function loadSkillIndex(skillsDirs) {
                     if (!meta.name && !meta.description)
                         continue;
                     const name = meta.name || basename(entry, '.md');
-                    // Skip sync/enrich skills for MVP
-                    if (GATED_SKILLS.has(name))
-                        continue;
                     if (!seen.has(name)) {
                         seen.add(name);
                         skills.push({
@@ -122,11 +112,37 @@ export function loadSkillIndex(skillsDirs) {
     }
     return skills;
 }
+const GRAPH_PREFIX = 'graph://';
+/**
+ * Parse a `graph://<repo>/<id>` entrypoint into its components.
+ * Returns null for filesystem paths.
+ */
+export function parseGraphSkillEntrypoint(entrypoint) {
+    if (!entrypoint.startsWith(GRAPH_PREFIX))
+        return null;
+    const rest = entrypoint.slice(GRAPH_PREFIX.length);
+    const slash = rest.indexOf('/');
+    if (slash === -1)
+        return null;
+    return { repo: rest.slice(0, slash), id: rest.slice(slash + 1) };
+}
 /**
  * Load the full content of a skill's entrypoint or a named sub-file.
- * Sanitises the file parameter to prevent path traversal.
+ * Sanitises the file parameter to prevent path traversal. Graph-authored
+ * skills route through the provided resolver; filesystem skills read from
+ * disk.
  */
-export function loadSkillContent(meta, file) {
+export function loadSkillContent(meta, file, graphResolver) {
+    const graph = parseGraphSkillEntrypoint(meta.entrypoint);
+    if (graph) {
+        if (file) {
+            return `Error: skill "${meta.name}" is a graph skill and has no sub-files. Use wikilinks in the skill body to reference other entries.`;
+        }
+        if (!graphResolver) {
+            return `Error: cannot load graph skill "${meta.name}" — no resolver provided.`;
+        }
+        return graphResolver(graph.repo, graph.id);
+    }
     if (file) {
         if (!meta.isDirectory) {
             return `Error: skill "${meta.name}" is a single-file skill with no sub-files.`;
@@ -152,23 +168,40 @@ export function buildSkillIndexPrompt(skills) {
     const onDemand = skills.filter(s => s.loading === 'on-demand');
     if (onDemand.length === 0)
         return '';
+    const formatSource = (dir) => {
+        const graph = parseGraphSkillEntrypoint(dir + '/');
+        return graph ? ` _(folder: ${graph.repo})_` : '';
+    };
     const lines = [
         '## Available Skills',
         '',
         'Call `load_skill` to load domain-specific guidance when it is relevant to the current task.',
         '',
-        ...onDemand.map(s => `- **${s.name}** — ${s.description}`),
+        ...onDemand.map(s => `- **${s.name}**${formatSource(s.dir)} — ${s.description}`),
     ];
     return lines.join('\n');
 }
+/** Cap on total eager-skill content inlined into the system prompt. */
+export const EAGER_SKILL_BYTE_CAP = 20_000;
 /**
  * Return the full content of all eager skills, to be injected directly
- * into the system prompt at startup.
+ * into the system prompt at startup. Respects `EAGER_SKILL_BYTE_CAP` —
+ * skills beyond the cap are dropped with a warning to stderr.
  */
-export function loadEagerSkills(skills) {
-    return skills
-        .filter(s => s.loading === 'eager')
-        .map(s => loadSkillContent(s))
-        .join('\n\n---\n\n');
+export function loadEagerSkills(skills, graphResolver) {
+    const pieces = [];
+    let total = 0;
+    for (const skill of skills.filter(s => s.loading === 'eager')) {
+        const content = loadSkillContent(skill, undefined, graphResolver);
+        if (total + content.length > EAGER_SKILL_BYTE_CAP) {
+            if (process.env.STUDIOGRAPH_VERBOSE === '1') {
+                console.warn(`[skill-loader] eager skill "${skill.name}" dropped — cap ${EAGER_SKILL_BYTE_CAP}B reached.`);
+            }
+            continue;
+        }
+        pieces.push(content);
+        total += content.length;
+    }
+    return pieces.join('\n\n---\n\n');
 }
 //# sourceMappingURL=skill-loader.js.map

package/dist/agent/skill-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-loader.js","sourceRoot":"","sources":["../../src/agent/skill-loader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skill-loader.js","sourceRoot":"","sources":["../../src/agent/skill-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAW/C;;GAEG;AACH,SAAS,gBAAgB,CAAC,OAAe;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAC3E,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACrC,CAAC;IACD,MAAM,IAAI,GAA2B,EAAE,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,SAAS;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3C,IAAI,GAAG;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC7B,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,UAAoB;IACjD,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAE/B,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS;YACpC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAEnC,oDAAoD;YACpD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YAC5C,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxB,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBAC/C,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;oBAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC;oBAChC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;wBACpB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;wBACf,MAAM,CAAC,IAAI,CAAC;4BACV,IAAI;4BACJ,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;4BACnC,OAAO,EAAE,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW;4BACzD,GAAG,EAAE,SAAS;4BACd,UAAU,EAAE,OAAO;4BACnB,WAAW,EAAE,IAAI;yBAClB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,uBAAuB;gBACzB,CAAC;gBACD,SAAS;YACX,CAAC;YAED,+DAA+D;YAC/D,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC;gBAC7B,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;oBACjD,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;oBAC3C,uDAAuD;oBACvD,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW;wBAAE,SAAS;oBAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;oBACjD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;wBACpB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;wBACf,MAAM,CAAC,IAAI,CAAC;4BACV,IAAI;4BACJ,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;4BACnC,OAAO,EAAE,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW;4BACzD,GAAG;4BACH,UAAU,EAAE,SAAS;4BACrB,WAAW,EAAE,KAAK;yBACnB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO;gBACT,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAKD,MAAM,YAAY,GAAG,UAAU,CAAC;AAEhC;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,UAAkB;IAC1D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;AACnE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAe,EAAE,IAAa,EAAE,aAAkC;IACjG,MAAM,KAAK,GAAG,yBAAyB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzD,IAAI,KAAK,EAAE,CAAC;QACV,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,iBAAiB,IAAI,CAAC,IAAI,sGAAsG,CAAC;QAC1I,CAAC;QACD,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,mCAAmC,IAAI,CAAC,IAAI,2BAA2B,CAAC;QACjF,CAAC;QACD,OAAO,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO,iBAAiB,IAAI,CAAC,IAAI,6CAA6C,CAAC;QACjF,CAAC;QACD,6DAA6D;QAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1C,OAAO,iCAAiC,IAAI,IAAI,CAAC;QACnD,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO,oBAAoB,QAAQ,yBAAyB,IAAI,CAAC,IAAI,IAAI,CAAC;QAC5E,CAAC;QACD,OAAO,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAmB;IACvD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,WAAW,CAAC,CAAC;IAC/D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAErC,MAAM,YAAY,GAAG,CAAC,GAAW,EAAU,EAAE;QAC3C,MAAM,KAAK,GAAG,yBAAyB,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;QACnD,OAAO,KAAK,CAAC,CAAC,CAAC,cAAc,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACnD,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG;QACZ,qBAAqB;QACrB,EAAE;QACF,6FAA6F;QAC7F,EAAE;QACF,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;KACjF,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAE3C;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,MAAmB,EAAE,aAAkC;IACrF,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,EAAE,CAAC;QAC9D,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;QAClE,IAAI,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,oBAAoB,EAAE,CAAC;YAClD,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,GAAG,EAAE,CAAC;gBAC5C,OAAO,CAAC,IAAI,CAAC,+BAA+B,KAAK,CAAC,IAAI,mBAAmB,oBAAoB,YAAY,CAAC,CAAC;YAC7G,CAAC;YACD,SAAS;QACX,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrB,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAC1B,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AACpC,CAAC"}

package/dist/agent/skills/artifact-canvas/skill.md

@@ -0,0 +1,152 @@
+---
+name: artifact-canvas
+description: Create sandboxed canvas artifacts from HTML, CSS, and JavaScript bundles.
+loading: on-demand
+---
+
+# Artifact Canvas
+
+Use this skill when the user asks for a visual or interactive output that should appear in the Studiograph canvas: slide decks, letterhead documents, social graphics, diagrams, prototypes, calculators, one-off tools, or any other artifact you can express as HTML/CSS/JS.
+
+## Workflow
+
+1. Gather the source material from the user's prompt and any relevant entries.
+2. Create a complete `ArtifactBundle` with text files only.
+3. Call `create_artifact` with the bundle.
+4. Call `inspect_artifact` after meaningful visual work to verify layout with Playwright. Inspect the editor context for the canvas overview/grid, and inspect fullscreen when the artifact uses a presentation/share mode. For decks/documents/social sets, inspect individual frames/pages/slides with `frameSelector` or `frameIndexes`.
+5. Keep your chat response short; the canvas carries the artifact itself.
+6. If the chat is scoped to an open artifact entry, `create_artifact` updates that canvas directly. If the user references a different artifact entry, pass `target.entityId` and `target.repo` when known. Otherwise it creates a new `artifact` graph entry and opens it in the center content well.
+
+## Bundle Shape
+
+Use `schemaVersion: 1`.
+
+Set `kind` to one of:
+- `html`
+- `document`
+- `slides`
+- `social`
+- `app`
+- `custom`
+
+Use `viewport` to define the canvas size:
+- Slides: `1280 × 720`, mode `fixed`
+- Social square: `1080 × 1080`, mode `fixed`
+- Social portrait: `1080 × 1350`, mode `fixed`
+- Documents: `816 × 1056`, mode `paged` for US Letter at 96dpi
+- Responsive prototypes: choose a sensible width/height and mode `responsive`
+
+Use optional `display` to describe how the artifact should appear in fullscreen/share contexts. This is generic host behavior, not tied to `kind`:
+- `fullscreenFit: "contain"` fits the declared viewport inside the browser viewport.
+- `fullscreenFit: "width"` fits the declared viewport to the browser width and allows vertical scrolling.
+- `fullscreenFit: "none"` renders at declared size and lets the host scroll if needed.
+- `background: "neutral"` uses a neutral presentation surface behind the artifact.
+- `background: "transparent"` lets the page/background show through.
+- `fullscreenViewport: { "width": 1280, "height": 720 }` optionally tells the host which single frame size to fit in fullscreen/share mode when the editor viewport is larger than one frame.
+- `controls.stepper: { "selector": "[data-artifact-frame]", "label": "Slide" }` asks the Studiograph chrome to provide a generic previous/current/next control in fullscreen/share mode for a sequence of frames.
+- `controls.reset: true` asks the chrome to include a reset/restart button for the sequence control.
+
+If `display` is omitted, the host defaults to `contain` for fixed/responsive viewports and `width` for paged viewports.
+
+Use optional `libraries` when the artifact needs one of Studiograph's curated local runtimes:
+- `"three"` exposes `window.THREE` for 3D/WebGL scenes.
+- `"d3"` exposes `window.d3` for charts, diagrams, data visualization, force layouts, and data art.
+- `"motion"` exposes `window.Motion` for DOM/SVG animation and short interactive explainers.
+
+These libraries are loaded from Studiograph's local runtime, not the network. Do not include CDN `<script>` tags or pasted third-party library source. Put your own artifact logic in JS files in `files`; those files run after requested libraries are ready.
+
+Do not request framework/source component kits such as shadcn, Bits UI, or wireframe-ui as artifact runtime libraries. The Artifact Canvas renders plain HTML/CSS/JS without a React/Svelte/Riot build step. For wireframes and shadcn-style UI mockups, create the components directly as semantic HTML and self-contained CSS inside the bundle. Use accessible roles and states, neutral design tokens, realistic spacing, and component patterns that resemble the requested system, but do not depend on those packages being present in the iframe.
+
+For wireframes, prefer fast low-fidelity primitives:
+- grayscale surfaces, 1px borders, dashed placeholders, skeleton blocks, and simple labels;
+- reusable CSS classes for buttons, inputs, cards, nav items, sidebars, modals, tables, and tabs;
+- lightweight JS only for stateful prototype interactions.
+
+For shadcn-style component mockups, emulate the visual/component conventions in plain CSS:
+- border radius around 6-8px, subtle borders, compact controls, clear focus states;
+- semantic `button`, `input`, `select`, `dialog`, `nav`, `table`, and `section` markup;
+- no Tailwind runtime, React components, Radix primitives, or generated imports.
+
+## Multi-Frame Artifacts
+
+For artifacts made of multiple authored surfaces, use a generic frame sequence. This applies to slide decks, documents, social campaigns, screen flows, and any future multi-page artifact.
+
+Use these markup conventions:
+- `data-artifact-layout="sequence"` on the transparent wrapper that arranges frames.
+- `data-artifact-frame` on each individual surface.
+- `data-artifact-pan-surface` on the wrapper when the editor canvas should pan from the space between frames.
+- Optional `data-sg-name`, `data-sg-role`, and `data-sg-id` attributes on important frames and elements so the user can select them and ask the agent for scoped edits in natural language. Keep names human-facing, such as `Cover title`, `Pricing table`, `Slide 4 image`, or `Primary CTA`; do not use implementation jargon.
+
+Recommended structure:
+
+```html
+<main class="artifact-sequence" data-artifact-layout="sequence" data-artifact-pan-surface>
+  <section class="artifact-frame" data-artifact-frame data-index="1" data-sg-name="Cover slide" data-sg-role="slide">
+    <h1 data-sg-name="Cover title" data-sg-role="headline">...</h1>
+  </section>
+  <section class="artifact-frame" data-artifact-frame data-index="2" data-sg-name="Approach slide" data-sg-role="slide">...</section>
+</main>
+```
+
+Selection guidance:
+- The Studiograph canvas lets users click one or more visible elements and then ask you to revise "this", "these", or "the selected elements".
+- When the chat context includes selected artifact targets, treat those descriptors as the intended edit scope. Preserve the rest of the bundle unless the user asks for a broader change.
+- Prefer updating stable `data-sg-*` targets, nearby semantic structure, or named classes rather than rewriting the entire artifact.
+- Add semantic attributes to major generated surfaces, headings, images, tables, diagrams, captions, buttons, and callouts so future selections are understandable.
+
+Use `data-artifact-context` selectors to make the same DOM serve different contexts:
+- Editor context should usually show all frames on the canvas as a grid or deliberate freeform arrangement.
+- Fullscreen context should present the same frames in the artifact's natural viewing mode: a single-column reader for documents, one active frame at a time for presentations, a lightbox for social sets, or an interactive flow for prototypes.
+- If the editor viewport is a large board but fullscreen should fit one frame, set `display.fullscreenViewport` to that frame's width and height.
+- If fullscreen should advance through one frame at a time, request `display.controls.stepper` and let Studiograph render the controls. Do not build duplicate visible stepper chrome inside the artifact.
+- For editor boards that use `display.fullscreenViewport`, keep `html`, `body`, and the outer sequence wrapper transparent so individual frames appear loose on the host canvas.
+
+Do not duplicate the content into separate editor and fullscreen DOM trees. Reflow the same `[data-artifact-frame]` elements with CSS and local JS.
+
+The `files` object may include only text files such as:
+- `index.html`
+- `style.css`
+- `script.js`
+- `data.json`
+- `graphic.svg`
+
+The `entrypoint` must point to an HTML file in `files`, usually `index.html`.
+
+## JavaScript
+
+JavaScript is allowed, but it runs only inside a sandboxed iframe. Write self-contained JS. Do not rely on network access, arbitrary external packages, cookies, localStorage, parent window access, downloads, forms, or navigation. If you need 3D, data visualization, or animation, request `libraries: ["three"]`, `libraries: ["d3"]`, or `libraries: ["motion"]` instead of using a CDN.
+
+## Constraints
+
+- Keep the whole bundle under 512KB.
+- Do not reference external URLs for scripts, styles, fonts, images, APIs, or tracking.
+- Custom fonts may be referenced only from uploaded Studiograph asset URLs (`/api/assets/...`) or `data:` URLs.
+- Inline CSS and JS in separate files when possible.
+- Use embedded SVG, CSS shapes, data URIs, or text-only layouts for assets in v1.
+- Saved artifact entries can be downloaded as PDF, PNG, or HTML from the artifact toolbar.
+- Agents can use `inspect_artifact` to view the rendered artifact through Playwright. Use it to catch layout issues, clipped text, missing frames, script errors, and blocked network requests before telling the user the artifact is ready.
+- Do not promise other export formats unless an export tool is added later.
+
+## Example
+
+```json
+{
+  "schemaVersion": 1,
+  "artifactId": "client-overview-slides",
+  "title": "Client Overview Slides",
+  "kind": "slides",
+  "viewport": { "width": 1280, "height": 720, "mode": "fixed" },
+  "libraries": ["motion"],
+  "display": {
+    "fullscreenFit": "contain",
+    "background": "neutral",
+    "controls": { "stepper": { "selector": "[data-artifact-frame]", "label": "Slide" }, "reset": true }
+  },
+  "entrypoint": "index.html",
+  "files": {
+    "index.html": "<main class=\"slide\"><h1>Client Overview</h1></main>",
+    "style.css": "body{margin:0;font-family:Inter,system-ui}.slide{width:1280px;height:720px;padding:72px}",
+    "script.js": "document.body.dataset.ready='true'"
+  }
+}
+```