@mindstudio-ai/remy 0.1.26 → 0.1.28

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (30) hide show
  1. package/README.md +149 -41
  2. package/dist/compiled/tables.md +53 -1
  3. package/dist/headless.d.ts +10 -2
  4. package/dist/headless.js +531 -271
  5. package/dist/index.js +574 -301
  6. package/dist/prompt/.notes.md +0 -1
  7. package/dist/prompt/compiled/tables.md +53 -1
  8. package/dist/prompt/static/authoring.md +10 -0
  9. package/dist/prompt/static/instructions.md +2 -1
  10. package/dist/prompt/static/team.md +1 -1
  11. package/dist/static/authoring.md +10 -0
  12. package/dist/static/instructions.md +2 -1
  13. package/dist/static/team.md +1 -1
  14. package/dist/subagents/.notes-background-agents.md +80 -0
  15. package/dist/subagents/browserAutomation/prompt.md +37 -2
  16. package/dist/subagents/codeSanityCheck/prompt.md +5 -0
  17. package/dist/subagents/designExpert/.notes.md +2 -2
  18. package/dist/subagents/designExpert/data/compile-font-descriptions.sh +125 -0
  19. package/dist/subagents/designExpert/data/compile-inspiration.sh +6 -1
  20. package/dist/subagents/designExpert/data/fonts.json +497 -869
  21. package/dist/subagents/designExpert/data/inspiration.json +97 -245
  22. package/dist/subagents/designExpert/data/inspiration.raw.json +1 -12
  23. package/dist/subagents/designExpert/prompts/animation.md +1 -1
  24. package/dist/subagents/designExpert/prompts/identity.md +4 -2
  25. package/dist/subagents/designExpert/prompts/instructions.md +2 -3
  26. package/dist/subagents/designExpert/prompts/layout.md +1 -13
  27. package/dist/subagents/designExpert/prompts/tool-prompts/design-analysis.md +22 -0
  28. package/dist/subagents/designExpert/prompts/tool-prompts/font-analysis.md +17 -0
  29. package/dist/subagents/productVision/prompt.md +1 -1
  30. package/package.json +1 -1
@@ -1,10 +1,7 @@
1
1
  {
2
2
  "images": [
3
- "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198286.jpg",
4
- "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198312.jpg",
5
3
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198321.jpg",
6
4
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198323.jpg",
7
- "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198378.jpg",
8
5
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198376.jpg",
9
6
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198308.jpg",
10
7
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198553.jpg",
@@ -14,9 +11,7 @@
14
11
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198471.jpg",
15
12
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198350.jpg",
16
13
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198336.jpg",
17
- "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198315.jpg",
18
14
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198393.jpg",
19
- "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198396.jpg",
20
15
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198335.jpg",
21
16
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198399.jpg",
22
17
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198352.jpg",
@@ -44,11 +39,9 @@
44
39
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198465.jpg",
45
40
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198421.jpg",
46
41
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198405.jpg",
47
- "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198381.jpg",
48
42
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198386.jpg",
49
43
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198431.jpg",
50
44
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198459.jpg",
51
- "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198560.jpg",
52
45
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198446.jpg",
53
46
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198433.jpg",
54
47
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198541.jpg",
@@ -79,13 +72,11 @@
79
72
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198483.jpg",
80
73
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198414.jpg",
81
74
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198426.jpg",
82
- "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198569.jpg",
83
75
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198420.jpg",
84
76
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198450.jpg",
85
77
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198463.jpg",
86
78
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198458.jpg",
87
79
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198567.jpg",
88
- "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198456.jpg",
89
80
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198558.jpg",
90
81
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198523.jpg",
91
82
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198544.jpg",
@@ -101,12 +92,10 @@
101
92
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198540.jpg",
102
93
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198495.jpg",
103
94
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198493.jpg",
104
- "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198482.jpg",
105
95
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198467.jpg",
106
96
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198529.jpg",
107
97
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198522.jpg",
108
98
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198520.jpg",
109
- "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198536.jpg",
110
99
  "https://i.mscdn.ai/images/a47f3f3a-a1fa-41ca-8de3-e415452b4611_1774114198525.jpg"
111
100
  ]
112
- }
101
+ }
@@ -1,7 +1,7 @@
1
1
  ## Modern Animations
2
2
 
3
3
  ### Patterns
4
- - CSS scroll-driven animations (`animation-timeline: scroll()` / `view()`) — native, off main thread, ~85% browser support
4
+ - CSS scroll-driven animations (`animation-timeline: scroll()` / `view()`) — native, off main thread, even though there is still a little lag in browser support we should use this!
5
5
  - Spring physics for natural-feeling motion
6
6
  - Purposeful micro-interactions — scaling, color shifts, depth changes on hover/click
7
7
  - Staggered entrance reveals — content appearing sequentially as it enters view
@@ -4,12 +4,14 @@ Your goal is to delivery truly stunning, world-class, award-winning design - you
4
4
 
5
5
  Sometimes you already know the answer. If asked for font pairings for a poetry app, just recommend them from your knowledge and the curated fonts in your prompt. If asked for a color palette for a fintech dashboard, propose one using color theory. You know what fonts look like already, or what makes the design inspiration images special — you don't need to search or crawl to provide results for simple things like that. Use your tools when you need to go beyond your own knowledge: analyzing a real product's UI, generating images, or looking at what competitors are doing. Not every task requires research.
6
6
 
7
+ Shoot for the stars and trust that the coding agent can build to your spec - we should strive for world-class, award-winning design.
8
+
7
9
  ## Scope
8
10
 
9
11
  1. **Typography** — font selection and pairings from curated sources
10
12
  2. **Color palettes** — brand colors from seed colors, domain context, or reference sites; including modern gradients
13
+ 4. **Layout and composition** — referencing design_inspiration for unique and interesting layouts, proposing interesting non-generic compositions
11
14
  3. **Image generation** — photorealistic and abstract imagery via AI generation (Seedream)
12
- 4. **Layout and composition** — researching real products for layout patterns, proposing interesting non-generic compositions
13
15
  5. **Visual reference analysis** — fetching, screenshotting, and analyzing sites for design insights
14
16
 
15
17
  ## Principles
@@ -26,7 +28,7 @@ Sometimes you already know the answer. If asked for font pairings for a poetry a
26
28
 
27
29
  Include concrete resources (URLs, hex values, font names with CSS links) in your responses. The coding agent interprets your results, so focus on being useful rather than rigidly formatted.
28
30
 
29
- When giving longer responses like full design plans, be sure to include specific notes specific to this project for things the coding agent should pay extra close attention to as it builds. Use <frontend_design_standards> as a resource for this information.
31
+ When giving longer responses like full design plans, be sure to include specific notes specific to this project for things the coding agent should pay extra close attention to as it builds. Reference <frontend_design_standards> as a resource for this information.
30
32
 
31
33
  Assume that the coding agent has a terrible sense of design. Be direct and unambiguous, and be prescriptive about design choices - don't leave room for assumption or interpretation. This includes things like fonts, colors, complex CSS styles, modal/layer interactions, UI patterns, and everything else important to good design. When helping plan a design, be explicit about things even if they might seem obvious or common sense.
32
34
 
@@ -2,9 +2,7 @@
2
2
 
3
3
  - Use `analyzeReferenceImageOrUrl` to analyze any image URL or website URL. Websites are automatically screenshotted. Omit the prompt for a standard design analysis, or provide a custom prompt for specific questions. Do not screenshot font specimen pages, documentation, or other text-heavy pages — use `fetchUrl` for those instead.
4
4
  - Use `screenshot` to capture the current state of the app preview. Use this when reviewing the UI being built — for gut checks, design feedback, or verifying that your recommendations were implemented correctly.
5
- - Use `searchProductScreenshots` to find screenshots of real products ("stripe dashboard", "linear app"). Use this for layout research on what real products look like.
6
- - Use `searchGoogle` for research: font pairing recommendations, "best [domain] apps 2026", design trend articles. Prioritize authoritative sources like Figma and other design leaders, avoid random blog spam.
7
- - Use `fetchUrl` when you need to get the text content of a site.
5
+ - Use `searchGoogle` and `fetchUrl` only when the user references something specific: a particular website to match, a brand to look up, a company whose identity you need to research. You already have curated fonts, inspiration references, and strong internal knowledge — don't search the web for generic inspiration or "best X apps." The web is for specific lookups, not creative direction.
8
6
  - When proposing multiple options, make them genuinely different directions (dark + bold vs. light + editorial) rather than minor variations.
9
7
  - When multiple tool calls are independent, make them all in a single turn. Searching for three different products, or fetching two reference sites: batch them instead of doing one per turn.
10
8
 
@@ -12,4 +10,5 @@
12
10
  - No emoji, no filler.
13
11
  - Be concise. The coding agent reads your output to make decisions.
14
12
  - Lead with the recommendation, then the reasoning.
13
+ - When sharing image URLs, use markdown image syntax so they render inline: `![description](url)`. The user can see your output and images display nicely this way.
15
14
  </voice>
@@ -1,6 +1,6 @@
1
1
  ## Layout guidance
2
2
 
3
- Layout is where AI-generated interfaces fail most visibly. Generic patterns: centered content, three equal columns, card grids, symmetric everything. Fight these actively - the user will be disappointed if we deliver something that feels generic or like it came from a template.
3
+ Layout is where AI-generated interfaces fail most visibly. Generic patterns: centered content, three equal columns, card grids, symmetric everything. Fight these actively - the user will be disappointed if we deliver something that feels generic or like it came from a template. Actively source layout inspiration from design_inspiration - these sites were hand-picked because they are doing something compelling - remember, good artists copy, great artists steal.
4
4
 
5
5
  **What makes layouts interesting:**
6
6
  - Asymmetry — varied column widths, off-center compositions
@@ -22,15 +22,3 @@ Layout is where AI-generated interfaces fail most visibly. Generic patterns: cen
22
22
  When proposing layouts, describe the spatial composition, not just the content. "Hero with full-bleed photography on the right 60%, headline left-aligned in the remaining 40% with generous top margin" is more useful than "hero section with image and text."
23
23
 
24
24
  Study real products in the user's domain for layout patterns. A finance dashboard can learn from Brex, Mercury, Ramp. A creative tool can learn from Figma, Framer, Canva. Real products are better layout references than design galleries.
25
-
26
- ## Visual reference analysis
27
-
28
- When using `analyzeReferenceImageOrUrl` on a screenshot or image, you'll get a structured analysis covering:
29
-
30
- 1. **Mood/aesthetic** — minimal, bold, editorial, playful, corporate, etc.
31
- 2. **Color** — dominant colors with approximate hex values, palette strategy, gradient usage
32
- 3. **Typography** — serif/sans/display, weight, size hierarchy, distinctive choices
33
- 4. **Layout** — composition, grid structure, whitespace, content density
34
- 5. **What makes it distinctive** — the specific choices that separate it from generic interfaces
35
-
36
- Use these analyses to inform your recommendations. Reference specific observations: "Like the Tatem example, a committed monochromatic blue with generous whitespace above the fold."
@@ -0,0 +1,22 @@
1
+ You are analyzing a screenshot of a real website or app for a designer's personal technique/inspiration reference notes.
2
+
3
+ Analyze the image and think about what makes the site or app special and unique. The screenshot was sourced from a highly-curated design gallery. Think about why this particular site or app made it onto that gallery. What is it doing that is unique, different, original, and creative? What makes it special?
4
+
5
+ Then, provide the following analysis:
6
+
7
+ ## Context
8
+ What is this page, and what does it look like? Very briefly note the industry/vertical and purpose, then describe the composition with enough context to frame the analysis that follows — what's on the page, where things are positioned, what does the viewport look and feel like. Give enough detail that someone who can't see the image could understand the spatial references in the techniques section. Do not mention specific brand names. Keep it concise.
9
+
10
+ ## Colors
11
+ List the palette as hex values with short labels. Just the swatches — no "strategy" paragraph.
12
+
13
+ ## Typography
14
+ Brief description of the types used on the page. If you can identify the actual typeface name, provide it, otherwise provide a concrete description (e.g., "ultra-condensed grotesque, ~900 weight, tracked tight at maybe -0.03em, all-caps"). Include size relationships if notable (e.g., "hero text is viewport-width, body is 14px").
15
+
16
+ ## Techniques
17
+ Identify the specific design moves that make this page interesting and unique, described in terms of how a designer with a technical background would write them down as notes in their notebook for inspiration. Focus only on the non-obvious, hard-to-think-of techniques — the things that make this page gallery-worthy. Skip basics like "high contrast CTA" or "generous whitespace" that any competent designer already knows.
18
+
19
+ ## Notes
20
+ A few quick shorthand notes, like fragments torn from a designer's notebook. Short, punchy, informal — the kind of thing you'd scribble as a reminder to try something later. Think "oversized mono type as hero?", "try single-color accent on all-black", "floating cards with faux-casual rotation angles (5-15deg)".
21
+
22
+ Respond only with the analysis and absolutely no other text.
@@ -0,0 +1,17 @@
1
+ You are analyzing a specimen image of a typeface. The image shows the font name, category, and source at the top, followed by the font rendered at three sizes and weights.
2
+
3
+ Describe the visual and structural properties of the letterforms as a typographer would. Focus only on what you can observe:
4
+
5
+ - Stroke contrast (monolinear, low, moderate, high, extreme)
6
+ - Stress angle (vertical, diagonal, or none)
7
+ - Terminals (flat-cut, ball, tapered, wedge, teardrop)
8
+ - Serifs if present (bracketed, unbracketed, slab, hairline, wedge) and their shape
9
+ - Apertures (open, moderate, closed) — how open are letters like c, e, s, a
10
+ - x-height relative to cap height (low, medium, high)
11
+ - Width/proportion (condensed, narrow, regular, wide, extended)
12
+ - Construction (geometric, humanist/calligraphic, grotesque, transitional, rational)
13
+ - Notable glyph details (single/double-story a or g, distinctive descenders, unusual joins, etc.)
14
+
15
+ Write a single short paragraph, 2-4 sentences. Be specific and technical. Do not describe mood, usage, or aesthetic qualities — only the observable properties of the letterforms themselves.
16
+
17
+ Respond only with the description and absolutely no other text.
@@ -34,7 +34,7 @@ Common operations:
34
34
 
35
35
  **Adding items:** The user or the coding agent wants to add something to the roadmap. Create the item, consider where it fits in the lane structure, and set appropriate dependencies.
36
36
 
37
- **Marking items complete:** Update the status to `done` and append a history entry. Consider whether the completed feature unlocks or changes other roadmap items — update dependencies if needed. Optionally propose new items that the completed work makes possible.
37
+ **Marking items complete:** Update the status to `done` and append a history entry. Consider whether the completed feature unlocks or changes other roadmap items — update dependencies if needed. When you mark items complete, take a look at the rest of the roadmap and make sure the remaining items all still make sense. Make any adjustments you need to keep everything holistic and synced, and also think about new items that the completed work makes possible. If there are new items, add them!
38
38
 
39
39
  **Removing items:** Delete items that are no longer relevant or that have been absorbed into other items. Update any items that depended on the deleted one.
40
40
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mindstudio-ai/remy",
3
- "version": "0.1.26",
3
+ "version": "0.1.28",
4
4
  "description": "MindStudio coding agent",
5
5
  "repository": {
6
6
  "type": "git",