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

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

@@ -0,0 +1,176 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBuildPlanTool = exports.updateBuildTaskTool = exports.createBuildPlanTool = void 0;
+const ai_agent_types_1 = require("@multiplayer-app/ai-agent-types");
+const zod_1 = require("zod");
+const agent_context_1 = require("./agent-context");
+const logger_1 = require("../../logger");
+const session_artifact_yjs_store_1 = require("../../realtime/session-artifact-yjs-store");
+const build_plan_1 = require("../../lib/session-plans/build-plan");
+const session_pages_1 = require("../../lib/session-pages");
+function requireSessionId(context) {
+    const sessionId = (0, agent_context_1.getRootChatId)(context);
+    if (!sessionId) {
+        throw new Error('Session ID is required');
+    }
+    return sessionId;
+}
+async function readPlan(sessionId) {
+    try {
+        const content = await (0, session_artifact_yjs_store_1.getSessionArtifactYjsStore)().getLatestText(sessionId, build_plan_1.BUILD_PLAN_PATH);
+        return (0, build_plan_1.parseBuildPlan)(content);
+    }
+    catch (_a) {
+        return null;
+    }
+}
+async function writePlan(sessionId, 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(),
+    findings: zod_1.z.array(zod_1.z.string()),
+    recordedAt: zod_1.z.string(),
+});
+function planSummary(plan) {
+    var _a;
+    const next = (0, build_plan_1.nextPendingTask)(plan);
+    return {
+        title: plan.title,
+        progress: (0, build_plan_1.planProgress)(plan),
+        nextTask: next ? { id: next.id, title: next.title, description: next.description, status: next.status } : null,
+        tasks: plan.tasks.map((task) => ({ id: task.id, title: task.title, status: task.status })),
+        openAdvisories: (_a = plan.openAdvisories) !== null && _a !== void 0 ? _a : [],
+    };
+}
+const planSummarySchema = zod_1.z.object({
+    title: zod_1.z.string(),
+    progress: zod_1.z.object({ done: zod_1.z.number(), total: zod_1.z.number(), remaining: zod_1.z.number() }),
+    nextTask: zod_1.z.object({ id: zod_1.z.string(), title: zod_1.z.string(), description: zod_1.z.string(), status: zod_1.z.string() }).nullable(),
+    tasks: zod_1.z.array(zod_1.z.object({ id: zod_1.z.string(), title: zod_1.z.string(), status: zod_1.z.string() })),
+    openAdvisories: zod_1.z.array(openAdvisorySchema),
+});
+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(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"'),
+        description: zod_1.z.string().min(1).max(1000).describe('What this task produces: artifact paths, sections, behaviors'),
+    }))
+        .min(2)
+        .max(6)
+        .describe('Ordered tasks. Prefer 2–3 for a landing page (complete index.html publish + consistency). Max 6. Last must be consistency/polish.'),
+});
+exports.createBuildPlanTool = {
+    type: ai_agent_types_1.AgentToolType.LOCAL_FUNCTION,
+    userConfigurable: true,
+    data: {
+        needsApproval: false,
+        title: 'createBuildPlan',
+        description: 'Create the build plan for this session: an ordered task list that will be executed one task at a time. Replaces any previous plan. The plan is stored as plan.json and visible to the user. Last task must be a consistency/polish pass.',
+        inputSchema: createPlanInputSchema,
+        outputSchema: planSummarySchema,
+        execute: async (input, context) => {
+            try {
+                const sessionId = requireSessionId(context);
+                (0, build_plan_1.assertDesignBriefQuality)(input.designBrief);
+                const last = input.tasks[input.tasks.length - 1];
+                if (!last || !(0, build_plan_1.isConsistencyPassTask)(last)) {
+                    throw new Error('The last task MUST be a consistency/polish pass (title or description must mention consistency, polish, qa, or quality). Prefer a light error check — do not end the plan on a new page.');
+                }
+                const plan = (0, build_plan_1.createBuildPlan)(input.title, input.tasks, new Date().toISOString(), input.designBrief);
+                await writePlan(sessionId, plan);
+                return planSummary(plan);
+            }
+            catch (err) {
+                (0, logger_1.getBuilderApiLogger)().error({ err });
+                throw err;
+            }
+        },
+    },
+};
+const updateTaskInputSchema = zod_1.z.object({
+    taskId: zod_1.z.string().min(1).describe('Task id from the plan, e.g. t1'),
+    status: zod_1.z.enum(['in_progress', 'done', 'skipped']),
+    paths: zod_1.z.array(zod_1.z.string()).optional().describe('Artifact paths this task produced or edited'),
+    note: zod_1.z.string().max(500).optional().describe('Short outcome note, e.g. the previewUrl or why skipped'),
+});
+exports.updateBuildTaskTool = {
+    type: ai_agent_types_1.AgentToolType.LOCAL_FUNCTION,
+    userConfigurable: true,
+    data: {
+        needsApproval: false,
+        title: 'updateBuildTask',
+        description: 'Update a build-plan task status. Returns remaining progress, openAdvisories, and the next pending task — when nextTask is not null, continue building it immediately.',
+        inputSchema: updateTaskInputSchema,
+        outputSchema: planSummarySchema,
+        execute: async (input, context) => {
+            var _a;
+            try {
+                const sessionId = requireSessionId(context);
+                const plan = await readPlan(sessionId);
+                if (!plan) {
+                    throw new Error('No build plan exists — call createBuildPlan first');
+                }
+                const task = plan.tasks.find((candidate) => candidate.id === input.taskId);
+                const now = new Date().toISOString();
+                // Never mark a task done for HTML paths that were never published.
+                // (Parent previously claimed index.html after a failed publish.)
+                if (input.status === 'done' && ((_a = input.paths) === null || _a === void 0 ? void 0 : _a.length)) {
+                    const existing = new Set((await (0, session_pages_1.listSessionArtifacts)(sessionId)).map((file) => file.path));
+                    const missing = input.paths.filter((path) => path.toLowerCase().endsWith('.html') && path !== 'plan.json' && !existing.has(path));
+                    if (missing.length > 0) {
+                        throw new Error(`Cannot mark task done — claimed path(s) do not exist: ${missing.join(', ')}. Successful publishSessionArtifacts must return a previewUrl first. If publish failed, re-call publishSessionArtifacts (not updateSessionArtifact).`);
+                    }
+                }
+                // Consistency pass cannot close while HTML still has blocking audit errors
+                // (including missing-html-pages when nothing was published).
+                if (input.status === 'done' && task && (0, build_plan_1.isConsistencyPassTask)(task)) {
+                    const report = await (0, session_pages_1.auditSessionHtmlArtifacts)(sessionId);
+                    if (report.errorCount > 0) {
+                        (0, build_plan_1.clearOpenAdvisories)(plan, undefined, now);
+                        (0, build_plan_1.recordOpenAdvisories)(plan, (0, session_pages_1.sessionQualityToAdvisoryLines)(report), now);
+                        await writePlan(sessionId, plan);
+                        const blocking = report.advisoryLines.filter((line) => line.startsWith('[error]')).slice(0, 8);
+                        throw new Error(`Consistency pass incomplete — ${report.errorCount} blocking quality error(s) remain across ${report.issues.length} page(s). If missing-html-pages: call publishSessionArtifacts. Otherwise updateSessionArtifact per path. Remaining:\n${blocking.join('\n')}${report.errorCount > 8 ? '\n…' : ''}`);
+                    }
+                    (0, build_plan_1.clearOpenAdvisories)(plan, undefined, now);
+                }
+                const updated = (0, build_plan_1.applyTaskUpdate)(plan, input, now);
+                if (!updated) {
+                    throw new Error(`Unknown task id: ${input.taskId}`);
+                }
+                await writePlan(sessionId, updated);
+                return planSummary(updated);
+            }
+            catch (err) {
+                (0, logger_1.getBuilderApiLogger)().error({ err });
+                throw err;
+            }
+        },
+    },
+};
+exports.getBuildPlanTool = {
+    type: ai_agent_types_1.AgentToolType.LOCAL_FUNCTION,
+    userConfigurable: true,
+    data: {
+        needsApproval: false,
+        title: 'getBuildPlan',
+        description: 'Read the current build plan, progress, and openAdvisories for this session (null when no plan exists yet).',
+        inputSchema: zod_1.z.object({}),
+        outputSchema: zod_1.z.object({
+            plan: planSummarySchema.nullable(),
+        }),
+        execute: async (_input, context) => {
+            const sessionId = requireSessionId(context);
+            const plan = await readPlan(sessionId);
+            return { plan: plan ? planSummary(plan) : null };
+        },
+    },
+};
+//# sourceMappingURL=build-plan.tools.js.map

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

@@ -0,0 +1 @@
+{"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

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

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

package/dist/agents/shared/generate-session-images.tool.d.ts

@@ -0,0 +1,15 @@
+import type { AgentTool } from '@multiplayer-app/ai-agent-types';
+import { z } from 'zod';
+export declare const generateSessionImagesInputSchema: z.ZodObject<{
+    images: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        prompt: z.ZodString;
+        size: z.ZodDefault<z.ZodEnum<{
+            square: "square";
+            landscape: "landscape";
+            portrait: "portrait";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const generateSessionImagesTool: AgentTool;
+//# sourceMappingURL=generate-session-images.tool.d.ts.map

package/dist/agents/shared/generate-session-images.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-session-images.tool.d.ts","sourceRoot":"","sources":["../../../src/agents/shared/generate-session-images.tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAInF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAuCvB,eAAO,MAAM,gCAAgC;;;;;;;;;;iBAE3C,CAAA;AA8DF,eAAO,MAAM,yBAAyB,EAAE,SAcvC,CAAA"}