@multiplayer-app/sandbox 0.0.32 → 0.0.33-beta.1

package/dist/agents/content-generator.agent.d.ts

@@ -1,4 +1,12 @@
 import type { AgentConfig } from '@multiplayer-app/ai-agent-types';
 import type { BuilderApiAgentDeps } from '../builder-api-config';
+/**
+ * Parent stop budget. Models otherwise round-robin updateSessionArtifact on
+ * every published file ("polish index, then contact, then index…") until the
+ * old 16-step cap. Count tool names conservatively from serialized steps.
+ */
+export declare function shouldStopContentGenerator({ steps }: {
+    steps: unknown[];
+}): boolean;
 export declare function createContentGeneratorAgent(deps: BuilderApiAgentDeps): AgentConfig;
 //# sourceMappingURL=content-generator.agent.d.ts.map

package/dist/agents/content-generator.agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content-generator.agent.d.ts","sourceRoot":"","sources":["../../src/agents/content-generator.agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAElE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAOhE,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,mBAAmB,GAAG,WAAW,CAgClF"}
+{"version":3,"file":"content-generator.agent.d.ts","sourceRoot":"","sources":["../../src/agents/content-generator.agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAElE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAUhE;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,GAAG,OAAO,CAUnF;AAOD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,mBAAmB,GAAG,WAAW,CAqDlF"}

package/dist/agents/content-generator.agent.js

@@ -1,32 +1,76 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldStopContentGenerator = shouldStopContentGenerator;
 exports.createContentGeneratorAgent = createContentGeneratorAgent;
 const ai_agent_types_1 = require("@multiplayer-app/ai-agent-types");
 const publish_session_artifacts_tool_1 = require("./shared/publish-session-artifacts.tool");
+const app_vm_tools_1 = require("./shared/app-vm.tools");
 const content_generator_system_prompt_1 = require("./shared/content-generator-system-prompt");
 const update_session_artifacts_tool_1 = require("./shared/update-session-artifacts.tool");
+const session_quality_report_tool_1 = require("./shared/session-quality-report.tool");
 const session_pages_1 = require("../lib/session-pages");
 const agent_context_1 = require("./shared/agent-context");
+const skills_1 = require("./skills");
+/**
+ * Parent stop budget. Models otherwise round-robin updateSessionArtifact on
+ * every published file ("polish index, then contact, then index…") until the
+ * old 16-step cap. Count tool names conservatively from serialized steps.
+ */
+function shouldStopContentGenerator({ steps }) {
+    if (steps.length >= 6)
+        return true;
+    const blob = JSON.stringify(steps !== null && steps !== void 0 ? steps : []);
+    const updateCalls = countToolMentions(blob, 'updateSessionArtifact');
+    const publishCalls = countToolMentions(blob, 'publishSessionArtifacts');
+    // After a landing is on disk, at most one follow-up edit pass — not one per file.
+    if (updateCalls >= 2)
+        return true;
+    // Two publish delegations is already past the intended "one ship + one repair" path.
+    if (publishCalls >= 2 && updateCalls >= 1)
+        return true;
+    return false;
+}
+function countToolMentions(blob, toolName) {
+    var _a, _b;
+    const re = new RegExp(`"(?:name|title)"\\s*:\\s*"${toolName}"`, 'g');
+    return (_b = (_a = blob.match(re)) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0;
+}
 function createContentGeneratorAgent(deps) {
     return {
         name: 'content-generator',
         description: 'Generates and updates session artifacts: HTML pages, optional split CSS/JS, JSON data, and Markdown docs',
         defaultModel: deps.defaultModel,
         systemPrompt: content_generator_system_prompt_1.CONTENT_GENERATOR_SYSTEM_PROMPT,
-        stopWhen: () => false,
+        stopWhen: shouldStopContentGenerator,
         prepareStep: async (options, context) => {
-            if (options.stepCount > 0) {
-                return undefined;
-            }
+            var _a;
             const sessionId = (0, agent_context_1.getRootChatId)(context);
             if (!sessionId) {
                 return undefined;
             }
-            const artifacts = await (0, session_pages_1.listSessionArtifacts)(sessionId);
+            const stepCount = (_a = options.stepCount) !== null && _a !== void 0 ? _a : 0;
+            const [artifacts, customSkills] = await Promise.all([
+                (0, session_pages_1.listSessionArtifacts)(sessionId),
+                stepCount === 0 ? (0, skills_1.loadAccountSkills)(context) : Promise.resolve([]),
+            ]);
+            const customSkillCatalog = customSkills.length
+                ? `\nAccount skills (add to the catalog; same-name entries replace built-ins):\n${customSkills
+                    .map((skill) => `- ${skill.name} — ${skill.description}. Use for: ${skill.whenToUse}`)
+                    .join('\n')}`
+                : '';
+            const artifactList = artifacts.length
+                ? artifacts.map((artifact) => artifact.path).join(', ')
+                : '(none yet)';
+            const stopPolish = artifacts.length > 0 && stepCount >= 1
+                ? `\nSTOP RULE: HTML already exists (${artifactList}). If the last publish/update returned previewUrl or an updated path, FINISH with a short summary NOW. Do NOT round-robin updateSessionArtifact across every file. Do NOT invent nindex.html / contact.html / data/*.json unless the user asked. At most ONE updateSessionArtifact for a named blocking error — then stop.`
+                : '';
             return {
                 messages: [
                     ...options.messages,
-                    { role: 'system', content: `List of available artifacts: ${artifacts.map((artifact) => artifact.path).join(', ')}` },
+                    {
+                        role: 'system',
+                        content: `Existing session artifacts RIGHT NOW: ${artifactList}. These paths MUST go through updateSessionArtifact — publishing them again always fails. Any path NOT in this list does not exist yet — create it with publishSessionArtifacts, never updateSessionArtifact. No build plan — ship with publish/update directly.${customSkillCatalog}${stopPolish}`,
+                    },
                 ],
             };
         },
@@ -35,6 +79,9 @@ function createContentGeneratorAgent(deps) {
             { type: ai_agent_types_1.AgentToolType.REQUEST_CLARIFICATION, userConfigurable: true },
             publish_session_artifacts_tool_1.publishSessionArtifactsSubagentTool,
             update_session_artifacts_tool_1.updateSessionArtifactsSubagentTool,
+            app_vm_tools_1.writeAppFilesTool,
+            app_vm_tools_1.runAppCommandTool,
+            session_quality_report_tool_1.getSessionQualityReportTool,
         ],
     };
 }

package/dist/agents/content-generator.agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"content-generator.agent.js","sourceRoot":"","sources":["../../src/agents/content-generator.agent.ts"],"names":[],"mappings":";;AASA,kEAgCC;AAxCD,oEAA+D;AAE/D,4FAA6F;AAC7F,8FAA0F;AAC1F,0FAA2F;AAC3F,wDAA2D;AAC3D,0DAAsD;AAEtD,SAAgB,2BAA2B,CAAC,IAAyB;IACnE,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,0GAA0G;QAC5G,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,YAAY,EAAE,iEAA+B;QAC7C,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK;QACrB,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;YACtC,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;gBAC1B,OAAO,SAAS,CAAA;YAClB,CAAC;YACD,MAAM,SAAS,GAAG,IAAA,6BAAa,EAAC,OAAO,CAAC,CAAA;YACxC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,SAAS,CAAA;YAClB,CAAC;YAED,MAAM,SAAS,GAAG,MAAM,IAAA,oCAAoB,EAAC,SAAS,CAAC,CAAA;YACvD,OAAO;gBACL,QAAQ,EAAE;oBACR,GAAG,OAAO,CAAC,QAAQ;oBACnB,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,gCAAgC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE;iBACrH;aACF,CAAA;QACH,CAAC;QACD,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,8BAAa,CAAC,UAAU,EAAE,gBAAgB,EAAE,IAAI,EAAE;YAC1D,EAAE,IAAI,EAAE,8BAAa,CAAC,qBAAqB,EAAE,gBAAgB,EAAE,IAAI,EAAE;YACrE,oEAAmC;YACnC,kEAAkC;SACnC;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"content-generator.agent.js","sourceRoot":"","sources":["../../src/agents/content-generator.agent.ts"],"names":[],"mappings":"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"}

package/dist/agents/notebook.agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notebook.agent.d.ts","sourceRoot":"","sources":["../../src/agents/notebook.agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAElE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAOhE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,GAAG,WAAW,CA2C1E"}
+{"version":3,"file":"notebook.agent.d.ts","sourceRoot":"","sources":["../../src/agents/notebook.agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAElE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAOhE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,GAAG,WAAW,CA4C1E"}

package/dist/agents/notebook.agent.js

@@ -13,7 +13,8 @@ function createNotebookAgent(deps) {
         description: 'Reads, searches, and edits the collaborative notebook the user has open, including runnable SQL, code, and chart blocks',
         defaultModel: deps.defaultModel,
         systemPrompt: notebook_agent_system_prompt_1.NOTEBOOK_AGENT_SYSTEM_PROMPT,
-        stopWhen: () => false,
+        // Safety net against runaway tool-retry loops.
+        stopWhen: ({ steps }) => steps.length >= 64,
         prepareStep: async (options, context) => {
             if (options.stepCount > 0) {
                 return undefined;

package/dist/agents/notebook.agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"notebook.agent.js","sourceRoot":"","sources":["../../src/agents/notebook.agent.ts"],"names":[],"mappings":";;AASA,kDA2CC;AAnDD,oEAA+D;AAE/D,sCAA+C;AAC/C,8EAAuF;AACvF,uFAAmF;AACnF,wFAAoF;AACpF,4DAA8E;AAE9E,SAAgB,mBAAmB,CAAC,IAAyB;IAC3D,OAAO;QACL,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,yHAAyH;QAC3H,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,YAAY,EAAE,2DAA4B;QAC1C,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK;QACrB,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;YACtC,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;gBAC1B,OAAO,SAAS,CAAA;YAClB,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAA,sCAAqB,EAAC,OAAO,CAAC,CAAA;gBACnD,MAAM,QAAQ,GAAG,MAAM,IAAA,uDAA0B,GAAE,CAAC,mBAAmB,CACrE,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,UAAU,CAClB,CAAA;gBACD,MAAM,OAAO,GAAG,IAAA,kCAAY,EAAC,IAAA,wCAAkB,EAAC,QAAQ,CAAC,CAAC,CAAA;gBAC1D,OAAO;oBACL,QAAQ,EAAE;wBACR,GAAG,OAAO,CAAC,QAAQ;wBACnB;4BACE,IAAI,EAAE,QAAiB;4BACvB,OAAO,EAAE,sDACP,OAAO,CAAC,MAAM,GAAG,CAAC;gCAChB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gCACvF,CAAC,CAAC,kBACN,EAAE;yBACH;qBACF;iBACF,CAAA;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAA,4BAAmB,GAAE,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,0CAA0C,CAAC,CAAA;gBAC/E,OAAO,SAAS,CAAA;YAClB,CAAC;QACH,CAAC;QACD,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,8BAAa,CAAC,qBAAqB,EAAE,gBAAgB,EAAE,IAAI,EAAE;YACrE,GAAG,8BAAa;SACjB;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"notebook.agent.js","sourceRoot":"","sources":["../../src/agents/notebook.agent.ts"],"names":[],"mappings":";;AASA,kDA4CC;AApDD,oEAA+D;AAE/D,sCAA+C;AAC/C,8EAAuF;AACvF,uFAAmF;AACnF,wFAAoF;AACpF,4DAA8E;AAE9E,SAAgB,mBAAmB,CAAC,IAAyB;IAC3D,OAAO;QACL,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,yHAAyH;QAC3H,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,YAAY,EAAE,2DAA4B;QAC1C,+CAA+C;QAC/C,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAwB,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE;QACjE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;YACtC,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;gBAC1B,OAAO,SAAS,CAAA;YAClB,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAA,sCAAqB,EAAC,OAAO,CAAC,CAAA;gBACnD,MAAM,QAAQ,GAAG,MAAM,IAAA,uDAA0B,GAAE,CAAC,mBAAmB,CACrE,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,UAAU,CAClB,CAAA;gBACD,MAAM,OAAO,GAAG,IAAA,kCAAY,EAAC,IAAA,wCAAkB,EAAC,QAAQ,CAAC,CAAC,CAAA;gBAC1D,OAAO;oBACL,QAAQ,EAAE;wBACR,GAAG,OAAO,CAAC,QAAQ;wBACnB;4BACE,IAAI,EAAE,QAAiB;4BACvB,OAAO,EAAE,sDACP,OAAO,CAAC,MAAM,GAAG,CAAC;gCAChB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gCACvF,CAAC,CAAC,kBACN,EAAE;yBACH;qBACF;iBACF,CAAA;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAA,4BAAmB,GAAE,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,0CAA0C,CAAC,CAAA;gBAC/E,OAAO,SAAS,CAAA;YAClB,CAAC;QACH,CAAC;QACD,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,8BAAa,CAAC,qBAAqB,EAAE,gBAAgB,EAAE,IAAI,EAAE;YACrE,GAAG,8BAAa;SACjB;KACF,CAAA;AACH,CAAC"}

package/dist/agents/shared/build-plan.tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-plan.tools.d.ts","sourceRoot":"","sources":["../../../src/agents/shared/build-plan.tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAmGnF,eAAO,MAAM,mBAAmB,EAAE,SA6BjC,CAAA;AASD,eAAO,MAAM,mBAAmB,EAAE,SA8DjC,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,SAkB9B,CAAA"}
+{"version":3,"file":"build-plan.tools.d.ts","sourceRoot":"","sources":["../../../src/agents/shared/build-plan.tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAoGnF,eAAO,MAAM,mBAAmB,EAAE,SA6BjC,CAAA;AASD,eAAO,MAAM,mBAAmB,EAAE,SA8DjC,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,SAkB9B,CAAA"}

package/dist/agents/shared/build-plan.tools.js

@@ -25,7 +25,7 @@ async function readPlan(sessionId) {
     }
 }
 async function writePlan(sessionId, plan) {
-    await (0, session_artifact_yjs_store_1.getSessionArtifactYjsStore)().initializeFromContent(sessionId, build_plan_1.BUILD_PLAN_PATH, (0, build_plan_1.serializeBuildPlan)(plan));
+    await (0, session_artifact_yjs_store_1.getSessionArtifactYjsStore)().upsertFromContent(sessionId, build_plan_1.BUILD_PLAN_PATH, (0, build_plan_1.serializeBuildPlan)(plan));
 }
 const openAdvisorySchema = zod_1.z.object({
     path: zod_1.z.string(),
@@ -54,9 +54,9 @@ const createPlanInputSchema = zod_1.z.object({
     title: zod_1.z.string().min(1).max(200).describe('Short name of what is being built'),
     designBrief: zod_1.z
         .string()
-        .min(80)
-        .max(900)
-        .describe('Session-wide design contract BEFORE building. MUST include: (1) accent hex + darker hover hex (topic-fit, never default indigo), (2) neutral scale slate/zinc/stone, (3) Google Font pairing by name (Manrope/Sora/Fraunces/Outfit — never Inter), (4) tone, (5) layout pack product|launch|editorial, (6) light/dark strategy, (7) atmosphere (e.g. soft accent wash + blur orb / glass nav), (8) anti-cliché note (what this must NOT look like).'),
+        .min(120)
+        .max(1400)
+        .describe(`Session-wide design contract BEFORE building. MUST include: (1) accent hex + darker hover hex (topic-fit, never default indigo), (2) neutral scale slate/zinc/stone/neutral, (3) Google Font pairing by name (never Inter), (4) tone, (5) layout pack ${build_plan_1.LAYOUT_PACKS.join('|')}, (6) signature layout+surface+motion (e.g. "signature: split + hard grid + scroll reveal"), (7) radius sharp|soft|pill and/or density airy|comfortable|dense, (8) light/dark strategy, (9) atmosphere matching the signature (not always blur-orb+glass), (10) anti-cliché note (explicitly ban the default centered blur-orb SaaS hero unless the pack requires it). Pick a pack that fits the product — vary across sessions.`),
     tasks: zod_1.z
         .array(zod_1.z.object({
         title: zod_1.z.string().min(1).max(120).describe('One concrete deliverable, e.g. "Landing page hero + nav"'),

package/dist/agents/shared/build-plan.tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"build-plan.tools.js","sourceRoot":"","sources":["../../../src/agents/shared/build-plan.tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"build-plan.tools.js","sourceRoot":"","sources":["../../../src/agents/shared/build-plan.tools.ts"],"names":[],"mappings":"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"}

package/dist/agents/shared/content-generator-system-prompt.d.ts

@@ -1,3 +1,4 @@
-/** Shared system prompt for content-generator / html-generator agents. */
-export declare const CONTENT_GENERATOR_SYSTEM_PROMPT = "You generate and update session artifacts for both UI and docs. Use publishSessionArtifacts for NEW files and updateSessionArtifact for EXISTING files.\n\nWorkflow:\n1. Decide output mode:\n   - UI/HTML (default): publish body/main fragments per .html page (page logic in <script>, small overrides in <style>). The server wraps fragments in a Pico CSS template \u2014 do not generate <!DOCTYPE>/<html>/<head> boilerplate unless the user explicitly wants a full custom document.\n   - Split assets (only when the user explicitly asks): separate styles.css, script.js, and/or extra .css/.js, linked from HTML via relative URLs (./styles.css, ./script.js).\n   - Docs: .md files such as README.md, docs/architecture.md\n   - Optional data: JSON under data/ (e.g. data/metrics.json), loaded from inline <script> when needed.\n2. Keep paths relative (no leading slash). Do not add styles.css or script.js unless the user requested split files or you are extending an existing split layout.\n3. Existing session artifacts are listed in a system message.\n4. New paths: publishSessionArtifacts with task, artifacts[], and parentContext. parentContext MUST include: (a) outputs from any knowledge tools you called this session (e.g. getWeather), (b) relevant prior conversation excerpts, (c) concrete data values the subagent cannot fetch itself. The subagent has NO access to your chat history or tool results \u2014 if data is not in parentContext, it will be missing from the page.\n5. Existing paths: updateSessionArtifact with parentContext and task (include the path). One path per call. Same parentContext rules as step 4.\n6. Mixed create + update: publish new paths only, then update each existing path separately.\n7. previewPath: primary .md for doc-only publishes; main entry .html (usually index.html) for UI.\n8. After publish, give previewUrl; after edit, the updated path; after read/Q&A, relay excerpts/summary only.\n\nHTML / UI (Pico CSS):\n- New .html files: send fragments only (semantic body content); server adds Pico template shell.\n- Prefer semantic Pico elements: header, nav, section, article, aside, footer, table, figure, button, input, select, textarea, details, dialog. Use Pico patterns for grids/cards (e.g. class=\"grid\") instead of large custom layout CSS.\n- Keep custom <style> minimal (only what Pico cannot express). \n- Put behavior in <script>.\n\nRules:\n- Prefer concise, production-grade output.\n- Do not overwrite existing paths via publishSessionArtifacts.\n- You do not have validateHtml or validateMarkdown; delegated subagents run validation.\n- When editing, keep the same layout model as the session (inline vs split files).";
+/** Shared system prompt for content-generator / html-generator agents.
+ * No build-plan tools — publish/update directly for speed. */
+export declare const CONTENT_GENERATOR_SYSTEM_PROMPT: string;
 //# sourceMappingURL=content-generator-system-prompt.d.ts.map

package/dist/agents/shared/content-generator-system-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content-generator-system-prompt.d.ts","sourceRoot":"","sources":["../../../src/agents/shared/content-generator-system-prompt.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,eAAO,MAAM,+BAA+B,mnFA0BuC,CAAA"}
+{"version":3,"file":"content-generator-system-prompt.d.ts","sourceRoot":"","sources":["../../../src/agents/shared/content-generator-system-prompt.ts"],"names":[],"mappings":"AAEA;8DAC8D;AAC9D,eAAO,MAAM,+BAA+B,QAyCiC,CAAA"}

package/dist/agents/shared/content-generator-system-prompt.js

@@ -1,32 +1,49 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CONTENT_GENERATOR_SYSTEM_PROMPT = void 0;
-/** Shared system prompt for content-generator / html-generator agents. */
+const skills_1 = require("../skills");
+/** Shared system prompt for content-generator / html-generator agents.
+ * No build-plan tools — publish/update directly for speed. */
 exports.CONTENT_GENERATOR_SYSTEM_PROMPT = `You generate and update session artifacts for both UI and docs. Use publishSessionArtifacts for NEW files and updateSessionArtifact for EXISTING files.
 
-Workflow:
-1. Decide output mode:
-   - UI/HTML (default): publish body/main fragments per .html page (page logic in <script>, small overrides in <style>). The server wraps fragments in a Pico CSS template — do not generate <!DOCTYPE>/<html>/<head> boilerplate unless the user explicitly wants a full custom document.
-   - Split assets (only when the user explicitly asks): separate styles.css, script.js, and/or extra .css/.js, linked from HTML via relative URLs (./styles.css, ./script.js).
-   - Docs: .md files such as README.md, docs/architecture.md
-   - Optional data: JSON under data/ (e.g. data/metrics.json), loaded from inline <script> when needed.
-2. Keep paths relative (no leading slash). Do not add styles.css or script.js unless the user requested split files or you are extending an existing split layout.
-3. Existing session artifacts are listed in a system message.
-4. New paths: publishSessionArtifacts with task, artifacts[], and parentContext. parentContext MUST include: (a) outputs from any knowledge tools you called this session (e.g. getWeather), (b) relevant prior conversation excerpts, (c) concrete data values the subagent cannot fetch itself. The subagent has NO access to your chat history or tool results — if data is not in parentContext, it will be missing from the page.
-5. Existing paths: updateSessionArtifact with parentContext and task (include the path). One path per call. Same parentContext rules as step 4.
-6. Mixed create + update: publish new paths only, then update each existing path separately.
-7. previewPath: primary .md for doc-only publishes; main entry .html (usually index.html) for UI.
-8. After publish, give previewUrl; after edit, the updated path; after read/Q&A, relay excerpts/summary only.
-
-HTML / UI (Pico CSS):
-- New .html files: send fragments only (semantic body content); server adds Pico template shell.
-- Prefer semantic Pico elements: header, nav, section, article, aside, footer, table, figure, button, input, select, textarea, details, dialog. Use Pico patterns for grids/cards (e.g. class="grid") instead of large custom layout CSS.
-- Keep custom <style> minimal (only what Pico cannot express). 
-- Put behavior in <script>.
+# Workflow — NO build plan (do not invent plan/task tooling)
+
+There is no createBuildPlan / updateBuildTask / getBuildPlan. Do not narrate fake plans or task ids. Ship artifacts directly.
+
+1. CLARIFY only when genuinely needed (audience, single vs multi-page, data source). Ask 1–3 questions in ONE round via request_clarification. Skip when the user says "don't ask" or the request is clear.
+
+2. DESIGN CONTRACT (keep in your head, put verbatim into every parentContext):
+   Exact accent hex + darker hover hex (topic-fit — EV→teal/lime, finance→emerald/navy, tax/filing→green/navy, health→coral; never default indigo), neutral scale (slate/zinc/stone/neutral), Google Font pairing by name (never Inter), tone, layout pack (product | launch | editorial | magazine | split-hero | dark-terminal | bento | brutalist | workspace | story), signature (layout + surface + motion), radius (sharp|soft|pill) and/or density (airy|comfortable|dense), light/dark strategy, atmosphere matching the signature, anti-cliché note that bans the default centered blur-orb SaaS hero unless the pack truly needs a marketing hero. Vary pack+signature across sessions. Include this full brief in parentContext on every publish/update.
+
+3. BUILD (SPEED FIRST) — anti-loop contract:
+   - Landing / magazine / single page: ONE publishSessionArtifacts with ONLY index.html (complete fragment). No contact.html, about.html, nindex.html, or data/*.json unless the user explicitly asked.
+   - Success = previewUrl returned. Then FINISH. Do not open a polish tour.
+   - Subagent may repair ONCE inside publish. If that still fails, you may call publishSessionArtifacts ONE more time with the named audit fixes — then stop or report the remaining rule names. Never empty files:[].
+   - updateSessionArtifact: at most ONE call per user message, and only for a path that already exists AND a blocking error rule name (or an explicit user edit). Never update every file in sequence. Never call update just to "add fonts" / "improve design" / "replace emoji" after a successful publish — the server repairs fonts and strips emoji.
+   - Do NOT call getSessionQualityReport unless the user asks to polish/audit, or zero HTML files exist after publish.
+
+4. FINISH: short summary with previewUrl. No plan status narration. No extra tool calls after success.
+
+Follow-ups in an existing session: one updateSessionArtifact (or one publish for a new path). Then stop.
+
+Artifact mechanics:
+1. UI/HTML (default): publish body/main fragments per .html page (page logic in <script>, styling via Tailwind utilities). Server wraps fragments in a Tailwind shell — no doctype/html/head unless the user wants a full custom document. Prefer the design-brief Google Fonts (<link> + font-family); the server injects a non-Inter fallback if missing.
+2. Split assets only when the user asks (./styles.css, ./script.js).
+3. Docs: .md; optional data under data/*.json.
+4. Paths relative (no leading slash). Existing artifacts are listed in a system message — never re-publish them.
+5. parentContext MUST include the design brief plus any knowledge-tool outputs / data the subagent cannot see. Put visual requirements in artifacts[].requirements too.
+6. HTML structural edits: WHOLESALE complete-page rewrite (no hashline ping-pong). Tiny label tweaks may use hashline.
+7. Never tell the user a file exists without a previewUrl / updated path from the tool.
+
+Skills — server selects guides automatically:
+${(0, skills_1.getSkillCatalog)()}
+
+Omit the skills field for HTML. Pass skills: [] only for doc/data-only work.
+
+App workspace (real apps): writeAppFiles + runAppCommand when the user wants a multi-file app with deps/build. Single pages stay on session artifacts.
 
 Rules:
-- Prefer concise, production-grade output.
-- Do not overwrite existing paths via publishSessionArtifacts.
-- You do not have validateHtml or validateMarkdown; delegated subagents run validation.
-- When editing, keep the same layout model as the session (inline vs split files).`;
+- Production-grade UI; no flat AI-indigo templates; never Inter; Lucide SVG icons not emoji; no lorem / template adjectives (revolutionary/seamless/…).
+- Prefer href="index.html" or #section-id over href="#".
+- Speed over ceremony: one successful publish beats multi-step polish loops.`;
 //# sourceMappingURL=content-generator-system-prompt.js.map

package/dist/agents/shared/content-generator-system-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"content-generator-system-prompt.js","sourceRoot":"","sources":["../../../src/agents/shared/content-generator-system-prompt.ts"],"names":[],"mappings":";;;AAAA,0EAA0E;AAC7D,QAAA,+BAA+B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;mFA0BoC,CAAA"}
+{"version":3,"file":"content-generator-system-prompt.js","sourceRoot":"","sources":["../../../src/agents/shared/content-generator-system-prompt.ts"],"names":[],"mappings":";;;AAAA,sCAA2C;AAE3C;8DAC8D;AACjD,QAAA,+BAA+B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgC7C,IAAA,wBAAe,GAAE;;;;;;;;;6EAS0D,CAAA"}

package/dist/agents/shared/design-skills.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Injectable design skills for UI-generating subagents.
+ *
+ * The orchestrator picks skill names per task; the subagent's prepareStep
+ * resolves them to content and injects a system message before the first step.
+ * `visual-foundation` is the baseline and is always injected for UI work.
+ */
+export declare const VISUAL_FOUNDATION_SKILL = "visual-foundation";
+export interface DesignSkill {
+    /** One-line summary shown in the orchestrator's skill catalog. */
+    description: string;
+    content: string;
+}
+export declare const DESIGN_SKILLS: Record<string, DesignSkill>;
+export declare const DESIGN_SKILL_NAMES: [string, ...string[]];
+/** One line per skill, for the orchestrator system prompt. */
+export declare function designSkillsCatalog(): string;
+/**
+ * Resolve skill names to injectable content. Unknown names are ignored.
+ * Pass alwaysIncludeFoundation for UI-producing agents.
+ */
+export declare function resolveDesignSkills(names: string[], options?: {
+    alwaysIncludeFoundation?: boolean;
+}): string;
+/**
+ * Extract a `skills: string[]` field from a subagent's first user message,
+ * which the framework serializes as JSON.stringify(tool input).
+ */
+export declare function parseSkillsFromMessages(messages: Array<{
+    role: string;
+    content: unknown;
+}>): string[];
+/**
+ * Infer page-specific design guides from the delegated task payload. This is a
+ * safety net for smaller orchestrator models: UI quality must not depend on the
+ * parent remembering an optional `skills` field.
+ */
+export declare function inferDesignSkillsFromMessages(messages: Array<{
+    role: string;
+    content: unknown;
+}>): string[];
+export declare function resolveRequestedAndInferredDesignSkills(messages: Array<{
+    role: string;
+    content: unknown;
+}>, options?: {
+    alwaysIncludeFoundation?: boolean;
+}): string;
+//# sourceMappingURL=design-skills.d.ts.map

package/dist/agents/shared/design-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-skills.d.ts","sourceRoot":"","sources":["../../../src/agents/shared/design-skills.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,uBAAuB,sBAAsB,CAAA;AAwG1D,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CA6BrD,CAAA;AAED,eAAO,MAAM,kBAAkB,EAAiC,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;AAErF,8DAA8D;AAC9D,wBAAgB,mBAAmB,IAAI,MAAM,CAI5C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,GAAE;IAAE,uBAAuB,CAAC,EAAE,OAAO,CAAA;CAAO,GAClD,MAAM,CAWR;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,GAClD,MAAM,EAAE,CAsBV;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,GAClD,MAAM,EAAE,CA8BV;AAED,wBAAgB,uCAAuC,CACrD,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,EACnD,OAAO,GAAE;IAAE,uBAAuB,CAAC,EAAE,OAAO,CAAA;CAAO,GAClD,MAAM,CAMR"}

package/dist/agents/shared/design-skills.js

@@ -0,0 +1,230 @@
+"use strict";
+/**
+ * Injectable design skills for UI-generating subagents.
+ *
+ * The orchestrator picks skill names per task; the subagent's prepareStep
+ * resolves them to content and injects a system message before the first step.
+ * `visual-foundation` is the baseline and is always injected for UI work.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DESIGN_SKILL_NAMES = exports.DESIGN_SKILLS = exports.VISUAL_FOUNDATION_SKILL = void 0;
+exports.designSkillsCatalog = designSkillsCatalog;
+exports.resolveDesignSkills = resolveDesignSkills;
+exports.parseSkillsFromMessages = parseSkillsFromMessages;
+exports.inferDesignSkillsFromMessages = inferDesignSkillsFromMessages;
+exports.resolveRequestedAndInferredDesignSkills = resolveRequestedAndInferredDesignSkills;
+exports.VISUAL_FOUNDATION_SKILL = 'visual-foundation';
+const visualFoundation = `## Design skill: visual foundation (always applies to UI pages)
+Pico CSS is only the base layer. Every page MUST open with a page-scoped <style> block that gives it an intentional design; a default-styled document is not acceptable output.
+
+Accent color — pick ONE that fits the content and set it via Pico variables at the top of <style>:
+:root {
+  --pico-primary: <accent>;
+  --pico-primary-background: <accent>;
+  --pico-primary-hover-background: <~10% darker>;
+  --pico-primary-underline: <accent>;
+}
+Use color-mix(in srgb, <accent> 10%, transparent) for tinted section/badge backgrounds so light and dark mode both work. For all other colors use Pico variables (var(--pico-muted-color), var(--pico-muted-border-color), var(--pico-card-background-color)) — never hard-coded grays.
+
+Hierarchy: one clear h1 (clamp(2rem, 4vw, 2.75rem), tight letter-spacing), a muted one-line subtitle under it, then sections separated by generous whitespace (3-4rem). Never a wall of same-sized text.
+
+Layout: CSS grid for cards, features, and stats — grid-template-columns: repeat(auto-fit, minmax(240px, 1fr)); gap: 1.25rem.
+
+Composition: do not place the entire experience in one narrow text column. Use contrasting section rhythms, asymmetric compositions where appropriate, layered surfaces, and deliberate negative space. For full-width bands inside the server container use a full-bleed utility; keep inner content aligned to a shared max-width.
+
+Cards: <article> with ~1.25-1.5rem padding; hover lift (translateY(-2px) + stronger shadow, 150ms transition) only when clickable.
+
+Icons: small inline SVGs (24px viewBox, stroke="currentColor", stroke-width 1.5-2, fill="none") — not emoji.
+
+Restraint: one accent + neutrals only, at most two extra font weights, one border-radius value, spacing from a 0.5/1/1.5/2/3rem scale. No gradients-on-everything, no more than one decorative flourish per page.
+
+Responsive: grids collapse via auto-fit; no fixed pixel widths on containers; verify mentally at 375px.`;
+const landingPage = `## Design skill: landing page
+Structure top to bottom: hero → social proof strip → 3 feature cards or alternating feature rows → deep-dive section → pricing (if relevant) → final CTA band → footer.
+
+Hero: full-width section, 5-6rem vertical padding. Headline clamp(2.5rem, 6vw, 4rem), font-weight 800, letter-spacing -0.03em, max-width 16ch when centered. One-sentence subhead in var(--pico-muted-color), max-width 55ch. Two CTAs side by side: primary button + secondary outline. Optionally a generated hero image below or beside (split hero: grid 1.1fr 1fr, text left, image right with border-radius and subtle shadow).
+
+Social proof: a muted "Trusted by" line with 4-6 grayscale text logos or stat pair, 0.85rem, uppercase, letter-spacing 0.05em.
+
+Feature sections: alternate text/image sides in split rows (grid, gap 3rem, align-items center). Each feature: small tinted icon chip (2.5rem square, border-radius, accent at 10% via color-mix), h3, 2-line description.
+
+Pricing: 2-3 cards in a grid; highlight the recommended tier with an accent border, a small "Popular" pill, and slightly larger scale. Price big (2.5rem bold), features as a checkmark list (inline SVG checks in accent color).
+
+Final CTA band: tinted background (accent 8% via color-mix), centered h2 + one primary button, 4rem padding.
+
+Images: generate ONE hero image (and at most one supporting illustration) with generateSessionImages; describe a consistent art style in the prompt (e.g. "clean minimal 3D render, soft studio lighting, single <accent-name> accent color on light neutral background"). Never generate images for icons or logos.`;
+const dashboard = `## Design skill: dashboard
+Shell: sticky top bar (product name left, actions/avatar right, border-bottom var(--pico-muted-border-color), backdrop-filter blur) over a content area with max-width 1200px. Add a slim sidebar only if there are 5+ nav destinations.
+
+Top of content: page title (1.5rem, 700) + date/filter controls right-aligned in one row (flex, space-between).
+
+Stat tiles first: 3-4 in a grid row. Tile = article with label (0.8rem, uppercase, letter-spacing 0.05em, var(--pico-muted-color)) above value (2rem, 700, tabular-nums) plus a small delta pill (green/red tinted background via color-mix, ▲/▼ arrow, 0.8rem).
+
+Charts: render with inline <svg> (line/area/bar drawn from the data — no chart library). Area fills use the accent at 15% opacity, 2px accent stroke, subtle horizontal gridlines (var(--pico-muted-border-color)), axis labels 0.75rem muted. Chart lives in a card with a title row (h3 + time-range select).
+
+Tables: compact (0.9rem), th uppercase 0.75rem muted, numeric columns right-aligned with font-variant-numeric: tabular-nums, status as small pill badges, row hover background color-mix(in srgb, var(--pico-primary) 4%, transparent).
+
+Density: dashboards are the one page type where whitespace shrinks — 1rem gaps, 1rem card padding. Everything aligns to the same grid; no orphan widgets. Do not generate images for dashboards.`;
+const dataTable = `## Design skill: data table
+Wrap in a card: article with zero padding, table inside, header row with title + search input + primary action button (padding 1rem 1.25rem, border-bottom).
+
+Table: font-size 0.9rem; th 0.75rem uppercase letter-spacing 0.05em var(--pico-muted-color); text columns left-aligned, numeric right-aligned with tabular-nums; dates muted. Sticky header (position: sticky, top: 0, background var(--pico-card-background-color)) when the table scrolls.
+
+Rows: 1px separators only (no zebra unless 20+ dense rows), hover tint color-mix(in srgb, var(--pico-primary) 4%, transparent). First column can pair an avatar-initial circle (2rem, accent 15% background, 600 weight initials) with a name + muted sub-line.
+
+Status: pill badges — 0.75rem, 600, padding 0.15rem 0.6rem, border-radius 999px, tinted background + matching darker text (green=active, amber=pending, red=failed, gray=archived), all via color-mix so dark mode works.
+
+Footer row: "Showing X–Y of Z" muted left, page buttons right (small outline buttons, current page solid accent).
+
+Empty state: centered in the card — muted inline SVG icon (48px), one bold line, one muted line, primary action button. Never render an empty <table>.`;
+const formApp = `## Design skill: forms
+Container: single column card, max-width 480px (560px for complex forms), centered; h2 + one muted context line above the fields.
+
+Fields: label every input (0.85rem, 500). Group related fields with a 0.75rem-uppercase muted group heading and 2rem top margin. Pair short fields (city/zip) in a 2-column grid; never 3+ columns.
+
+Primary action: full-width solid accent button at the bottom; secondary action as a text link beside/below it — never two solid buttons. Destructive actions are red outline.
+
+Validation: on error add aria-invalid="true" and a 0.8rem red helper line under the field; on success keep quiet (no green everywhere). Disable the submit button while submitting with a busy label.
+
+Multi-step: slim progress indicator on top (steps as dots/short labels, done in accent, current bold, future muted); Back as text button left, Next as solid accent right.
+
+Finish with a success state: replace the form with a centered check icon in a tinted circle (accent 12%), bold confirmation line, muted detail line, one follow-up action.`;
+const docsPage = `## Design skill: docs / long-form
+Reading column: max-width 70ch, line-height 1.7; page h1 then a muted lede paragraph. If 5+ sections, add a right-side "On this page" TOC (sticky, 0.85rem, muted links, accent on active) using a two-column grid 1fr 220px that collapses on mobile.
+
+Headings: h2 with 3rem top margin and optional subtle border-top separator; h3 at 2rem top margin. Every heading gets an id for anchor links.
+
+Code: inline code in tinted background chips; blocks in <pre> with 1rem padding, border-radius, overflow-x auto, and a small muted language label. Keep Pico's code styling, don't re-theme it.
+
+Callouts: blockquote variants with a 3px left accent border and tinted background — info (accent), warning (amber), danger (red) via color-mix; bold first word ("Note:", "Warning:").
+
+Tables for API/params: parameter names in code style, types muted, required as a small pill. Navigation footer: prev/next as two outline cards (muted "Previous"/"Next" label above the page title) in a 2-column grid.`;
+const portfolioGallery = `## Design skill: portfolio / gallery
+Intro: short hero — name/title (clamp(2rem, 5vw, 3rem), 800), one-line positioning statement, muted; social/contact as small outline icon buttons.
+
+Grid: cards in repeat(auto-fill, minmax(280px, 1fr)), gap 1.5rem. Card = image on top (aspect-ratio 16/10, object-fit cover, border-radius on top corners only), then 1.25rem padded body: title (1.1rem, 600), one-line muted description, tag pills row (0.75rem, tinted).
+
+Hover: image scales 1.03 inside overflow-hidden container + card lifts; 200ms ease transitions.
+
+Category filter: pill buttons row above the grid — active pill solid accent, inactive outline muted.
+
+Images: generate one image per showcased item with generateSessionImages, all sharing ONE art-style phrase in their prompts (e.g. "soft-gradient abstract 3D shapes, matte texture, muted <accent> palette") so the grid reads as a curated set; vary only the subject per item. Square or landscape, never portrait mixed with landscape in one grid.`;
+exports.DESIGN_SKILLS = {
+    [exports.VISUAL_FOUNDATION_SKILL]: {
+        description: 'Baseline visual system: accent via Pico variables, hierarchy, spacing, cards, restraint. Always applied to UI.',
+        content: visualFoundation,
+    },
+    'landing-page': {
+        description: 'Marketing/landing pages: hero, social proof, feature rows, pricing, CTA band, hero imagery.',
+        content: landingPage,
+    },
+    dashboard: {
+        description: 'App dashboards: shell, stat tiles, inline SVG charts, dense tables, filters.',
+        content: dashboard,
+    },
+    'data-table': {
+        description: 'Record lists and admin tables: alignment, status pills, pagination, empty states.',
+        content: dataTable,
+    },
+    'form-app': {
+        description: 'Forms and wizards: field layout, grouping, validation, multi-step, success states.',
+        content: formApp,
+    },
+    'docs-page': {
+        description: 'Docs and long-form reading: measure, TOC, code blocks, callouts, prev/next.',
+        content: docsPage,
+    },
+    'portfolio-gallery': {
+        description: 'Portfolios and image grids: card grid, hover, filters, cohesive generated imagery.',
+        content: portfolioGallery,
+    },
+};
+exports.DESIGN_SKILL_NAMES = Object.keys(exports.DESIGN_SKILLS);
+/** One line per skill, for the orchestrator system prompt. */
+function designSkillsCatalog() {
+    return Object.entries(exports.DESIGN_SKILLS)
+        .map(([name, skill]) => `- ${name}: ${skill.description}`)
+        .join('\n');
+}
+/**
+ * Resolve skill names to injectable content. Unknown names are ignored.
+ * Pass alwaysIncludeFoundation for UI-producing agents.
+ */
+function resolveDesignSkills(names, options = {}) {
+    const selected = new Set(options.alwaysIncludeFoundation ? [exports.VISUAL_FOUNDATION_SKILL] : []);
+    for (const name of names) {
+        if (exports.DESIGN_SKILLS[name]) {
+            selected.add(name);
+        }
+    }
+    if (selected.size === 0) {
+        return '';
+    }
+    return [...selected].map((name) => exports.DESIGN_SKILLS[name].content).join('\n\n');
+}
+/**
+ * Extract a `skills: string[]` field from a subagent's first user message,
+ * which the framework serializes as JSON.stringify(tool input).
+ */
+function parseSkillsFromMessages(messages) {
+    const firstUser = messages.find((message) => message.role === 'user');
+    if (!firstUser) {
+        return [];
+    }
+    const text = typeof firstUser.content === 'string'
+        ? firstUser.content
+        : Array.isArray(firstUser.content)
+            ? firstUser.content
+                .map((part) => (typeof part === 'object' && part && 'text' in part ? String(part.text) : ''))
+                .join('')
+            : '';
+    try {
+        const parsed = JSON.parse(text);
+        if (Array.isArray(parsed.skills)) {
+            return parsed.skills.filter((skill) => typeof skill === 'string');
+        }
+    }
+    catch (_a) {
+        // Task payload was not JSON — no skills requested.
+    }
+    return [];
+}
+/**
+ * Infer page-specific design guides from the delegated task payload. This is a
+ * safety net for smaller orchestrator models: UI quality must not depend on the
+ * parent remembering an optional `skills` field.
+ */
+function inferDesignSkillsFromMessages(messages) {
+    const text = messages
+        .filter((message) => message.role === 'user')
+        .map((message) => typeof message.content === 'string'
+        ? message.content
+        : JSON.stringify(message.content))
+        .join('\n')
+        .toLowerCase();
+    const inferred = new Set();
+    const addWhen = (pattern, skill) => {
+        if (pattern.test(text))
+            inferred.add(skill);
+    };
+    addWhen(/landing|marketing|saas|startup|product page|pricing|hero|conversion|waitlist/, 'landing-page');
+    addWhen(/dashboard|analytics|metrics|kpi|admin|overview|chart|reporting/, 'dashboard');
+    addWhen(/table|records|customers|orders|inventory|directory|list view|management/, 'data-table');
+    addWhen(/form|sign[ -]?up|login|checkout|onboarding|wizard|survey|settings/, 'form-app');
+    addWhen(/documentation|docs|guide|reference|article|knowledge base/, 'docs-page');
+    addWhen(/portfolio|gallery|showcase|photography|projects|case studies|real estate|travel|restaurant|fashion/, 'portfolio-gallery');
+    // A generic public-facing page benefits more from a landing composition than
+    // from receiving only the baseline visual tokens.
+    if (inferred.size === 0 && /\.html|website|web page|site|homepage/.test(text)) {
+        inferred.add('landing-page');
+    }
+    return [...inferred];
+}
+function resolveRequestedAndInferredDesignSkills(messages, options = {}) {
+    const names = [
+        ...parseSkillsFromMessages(messages),
+        ...inferDesignSkillsFromMessages(messages),
+    ];
+    return resolveDesignSkills(names, options);
+}
+//# sourceMappingURL=design-skills.js.map