@12ui/design 0.2.19 → 0.2.21

package/dist/server.js

@@ -1,15 +1,12 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
-import { readFile, writeFile } from 'node:fs/promises';
-import path from 'node:path';
-import { materializeConversionArtifacts } from './artifact-materializer.js';
-import { CONVERSION_MODELS, isConversionModel } from './conversion-models.js';
+import { readFile } from 'node:fs/promises';
+import { CONVERSION_MODELS } from './conversion-models.js';
 import { TwelveUiConversionClient } from './conversion-client.js';
-import { CONVERSION_OUTPUTS, LAYERDOC_INPUT_OUTPUTS, isConversionOutput, } from './conversion-outputs.js';
-import { createInputForLocalFile, defaultConversionOutputPath, } from './local-conversion-input.js';
-import { normalizeOptionalIdempotencyKey } from './idempotency-key.js';
-import { APP_PROJECT_FRAMEWORKS, APP_PROJECT_LANGUAGES, APP_PROJECT_PACKAGINGS, APP_PROJECT_STYLINGS, WEB_PROJECT_FRAMEWORKS, WEB_PROJECT_LANGUAGES, WEB_PROJECT_PACKAGINGS, WEB_PROJECT_STYLINGS, isProjectConversionOutput, parseConversionOutputProfile, } from './project-profiles.js';
+import { CONVERSION_OUTPUTS, LAYERDOC_INPUT_OUTPUTS, } from './conversion-outputs.js';
+import { runMcpConvert } from './mcp-convert.js';
+import { APP_PROJECT_FRAMEWORKS, APP_PROJECT_LANGUAGES, APP_PROJECT_PACKAGINGS, APP_PROJECT_STYLINGS, WEB_PROJECT_FRAMEWORKS, WEB_PROJECT_LANGUAGES, WEB_PROJECT_PACKAGINGS, WEB_PROJECT_STYLINGS, } from './project-profiles.js';
 export async function startMcpServer(options) {
     const client = new TwelveUiConversionClient({
         origin: options.config.origin,
@@ -84,74 +81,8 @@ export async function startMcpServer(options) {
         try {
             if (request.params.name !== 'design.convert')
                 throw new Error(`Unknown tool: ${request.params.name}`);
-            const input = (request.params.arguments ?? {});
-            const imagePath = typeof input.imagePath === 'string' && input.imagePath.trim()
-                ? input.imagePath
-                : null;
-            const layerdocPath = typeof input.layerdocPath === 'string' && input.layerdocPath.trim()
-                ? input.layerdocPath
-                : null;
-            if ((imagePath === null) === (layerdocPath === null)) {
-                throw new Error('Provide exactly one imagePath or layerdocPath');
-            }
-            const inputPath = path.resolve(imagePath ?? layerdocPath);
-            if (!isConversionOutput(input.output)) {
-                throw new Error(`output must be one of ${CONVERSION_OUTPUTS.join(', ')}`);
-            }
-            const output = input.output;
-            if (input.model !== undefined && !isConversionModel(input.model)) {
-                throw new Error(`model must be one of ${CONVERSION_MODELS.join(', ')}`);
-            }
-            if (layerdocPath && input.model !== undefined) {
-                throw new Error('model is only valid with imagePath');
-            }
-            const profile = isProjectConversionOutput(output)
-                ? parseConversionOutputProfile(output, input.profile)
-                : undefined;
-            if (!isProjectConversionOutput(output) && input.profile !== undefined) {
-                throw new Error('profile is only valid for web_project or app_project outputs');
-            }
-            const conversionInput = createInputForLocalFile({
-                bytes: new Uint8Array(await readFile(inputPath)),
-                filePath: inputPath,
-                output,
-                ...(profile ? { profile } : {}),
-            });
-            if (layerdocPath && conversionInput.layerdoc === undefined) {
-                throw new Error('layerdocPath must refer to a JSON file');
-            }
-            if (imagePath && conversionInput.layerdoc !== undefined) {
-                throw new Error('Use layerdocPath for LayerDoc JSON input');
-            }
-            const idempotencyKey = normalizeOptionalIdempotencyKey(input.idempotencyKey);
-            const requestInput = conversionInput.layerdoc !== undefined
-                ? conversionInput
-                : {
-                    ...conversionInput,
-                    ...(isConversionModel(input.model) ? { model: input.model } : {}),
-                };
-            const operation = await client.createConversion({
-                ...requestInput,
-                ...(idempotencyKey ? { idempotencyKey } : {}),
-            });
-            const completed = operation.status === 'succeeded'
-                ? operation
-                : await client.waitForConversion(operation.id, {
-                    timeoutMs: typeof input.timeoutMs === 'number' ? input.timeoutMs : undefined,
-                    expiresAt: operation.expires_at,
-                });
-            const downloaded = await client.downloadResult(completed.id, output);
-            const outFile = path.resolve(typeof input.outFile === 'string' && input.outFile.trim()
-                ? input.outFile
-                : defaultConversionOutputPath(inputPath, output));
-            await writeFile(outFile, downloaded.bytes);
-            const artifactManifest = await materializeConversionArtifacts(client, completed, outFile);
-            return {
-                content: [{
-                        type: 'text',
-                        text: JSON.stringify({ id: completed.id, output, outFile, artifactManifest }, null, 2),
-                    }],
-            };
+            const result = await runMcpConvert(client, (request.params.arguments ?? {}));
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
         }
         catch (error) {
             return {

package/dist/server.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@12ui/design",
-  "version": "0.2.19",
+  "version": "0.2.21",
   "type": "module",
   "description": "The canonical 12UI CLI, SDK, MCP server, and visual interface design skills",
   "main": "dist/index.js",
@@ -47,6 +47,14 @@
   ],
   "author": "Just Every",
   "license": "MIT",
+  "homepage": "https://12ui.com/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/just-every/12ui-plugin.git"
+  },
+  "bugs": {
+    "url": "https://github.com/just-every/12ui-plugin/issues"
+  },
   "engines": {
     "node": "^22.13.0 || >=24.0.0"
   }

package/skills/design/SKILL.md

@@ -7,6 +7,10 @@ description: "Required for non-trivial UI creation and redesign (web, app,
 
 # Design
 
+## Setup
+
+For a public-directory install, run `npx -y @12ui/design skill install --skill design` once. It pins the CLI and verifies this skill's account scopes.
+
 Code-generating models converge on a narrow band of visual defaults — the
 same fonts, palettes, and layouts across unrelated products — and a model
 cannot see its own convergence from inside it. This skill escapes that:
@@ -20,13 +24,15 @@ quicker.
 
 ## 1. Explore — four directions
 
+Already holding the finished design? Build it, do not redraw it: see
+`design-convert`. Only to redraw an existing interface:
+`12ui draft --redesign-source <png> --mode exploratory|reskin`.
+
     12ui draft --query "<product, audience, surface, goal, personality>"
 
 Creates the run directory and prints its path — pass it to every later
 command. Searches the corpus for four diverse references and generates one
 one-viewport candidate steered by each, returning immediately.
-`12ui draft status <run-dir>` reports progress (typically ~90s).
-Redesigns: `--redesign-source <png> --mode exploratory|reskin`.
 
 ## 2. Select
 
@@ -41,8 +47,6 @@ For a single fold, view, or state:
 
     12ui convert <run-dir>/candidates/B.png --export html
 
-Runs ~5 minutes with streamed progress.
-
 For a full page or a multi-page site or app — the winner is viewport 1 of
 the first page; it needs no separate conversion:
 
@@ -51,12 +55,9 @@ the first page; it needs no separate conversion:
       --scope page|site --convert html
 
 The server plans the screens; the command dispatches, downloads, and
-converts one package per page. Returns immediately;
-`12ui branch status <run-dir>` reports progress (typically 5–15 min;
-large runs can take up to ~30 min).
+converts one package per page, into `<run-dir>/branch/pages/`.
 Wait for it rather than building the same pages by hand in the meantime —
 they are already being produced and paid for.
-Per-page HTML lands in `<run-dir>/branch/pages/`.
 
 ## 4. Integrate
 

package/skills/design-branch/SKILL.md

@@ -8,11 +8,16 @@ description: "Required whenever the deliverable is more than one viewport — a
 
 # Design branch
 
+## Setup
+
+For a public-directory install, run `npx -y @12ui/design skill install --skill design-branch` once. It pins the CLI and verifies this skill's account scopes.
+
 One approved screen fixes the visual system; branching extends it across the
 rest of the surface with consistent, professional quality instead of
 re-deriving the design once per screen. The server plans the screens and
 their dependencies; one command executes the whole plan and keeps every paid
-screen addressable, so a retry never repeats paid work.
+screen addressable, so a retry never repeats paid work. Use it whenever the
+deliverable is more than one viewport; a single fold is a plain convert.
 
 ## 1. Execute
 
@@ -23,25 +28,20 @@ screen addressable, so a retry never repeats paid work.
 The run directory is the one `12ui draft` printed; the starting design is
 the candidate `12ui select` recorded there. `--scope page` grows that screen
 into viewports 2..n of its own page; `--scope site` adds sibling routes and
-app states as well. The server plans 2-8 screens (`--max-screens` trims the
-plan). `--convert html` converts each finished page as one ordered package;
-omitting it stops at downloaded PNGs.
-
-To start from something else, pass a fresh directory plus exactly one of
-`--winner-run crt-<id> --winner-slot <slot>` — an earlier hosted candidate,
-whose bytes never leave the server — or `--winner-image <file>` with a PNG,
-JPEG, or WebP. The starting design is viewport 1 of the first page; it needs
-no separate conversion.
+app states as well. `--convert html` converts each finished page as one
+ordered package; omitting it stops at downloaded PNGs. A run with no draft
+behind it takes a fresh directory and names its own starting design — the
+command refuses with both spellings if none is given. Either way the starting
+design is viewport 1 of the first page; it needs no separate conversion.
 
 ## 2. Follow
 
-    12ui branch status <run-dir>
+    12ui next <run-dir>
 
-Execute returns immediately and the run continues on its own (typically
-5–15 min, up to ~30 for large runs; add `--wait` to block instead).
-Status reports per-screen progress
-and the next action. `12ui branch resume <run-dir>` continues an interrupted
-run, replaying already-settled screens for free.
+Execute returns immediately; `12ui next` reports progress and the one command
+to run next, and `--wait` blocks instead of polling.
+`12ui branch resume <run-dir>` continues an interrupted run, replaying
+already-settled screens for free.
 
 ## 3. Collect
 

package/skills/design-convert/SKILL.md

@@ -8,6 +8,10 @@ description: "Required to turn a finished PNG, JPEG, or WebP design into
 
 # Design convert
 
+## Setup
+
+For a public-directory install, run `npx -y @12ui/design skill install --skill design-convert` once. It pins the CLI and verifies this skill's account scopes.
+
 Convert one finished image once, keep its base LayerDoc conversion, and
 derive every required format from that structured source — near-pixel
 fidelity, faster and truer than recreating the design by hand.
@@ -17,13 +21,8 @@ fidelity, faster and truer than recreating the design by hand.
     12ui convert <source-image> --export html
 
 Converts the image to a LayerDoc and exports responsive HTML alongside it in
-one blocking command (~5 minutes, progress streamed to stderr; ~4 minutes
-without `--export html`). `--model fast|standard|pro` and
-`--width <intended-css-px>` steer the conversion; `--out` and `--export-out`
-place the artifacts. The result JSON carries the conversion under `id` and
-the export under `export.id`. If the export half fails, the LayerDoc is
-still written — retry only the export with
-`12ui export <id> --output html`.
+one blocking command, which is faster than converting and then exporting.
+The result carries the conversion under `id` and the export under `export.id`.
 
 ## 2. Export more formats
 
@@ -31,11 +30,11 @@ still written — retry only the export with
       --out-dir <dir> --idempotency-key <stable-key>
 
 Derives further formats from the finished conversion without repeating
-extraction; independent exports run in parallel, and every format except
-`html` takes seconds to about a minute. Outputs: `html`, `html_fixed`,
-`svg`, `png`, `jpg`, `webp`, `pdf`, `psd`, `pptx`, `sketch`, `web_project`,
-`app_project`. Reusing the same key replays a finished export instead of
-buying it again. Project outputs take a profile matching the target project:
+extraction, and independent exports run in parallel. Outputs: `html`,
+`html_fixed`, `svg`, `png`, `jpg`, `webp`, `pdf`, `psd`, `pptx`, `sketch`,
+`web_project`, `app_project`. Reusing the same key replays a finished export
+instead of buying it again. Project outputs take a profile matching the
+target project:
 
     --web-profile '{"version":1,"framework":"react","styling":"tailwind","language":"typescript","packaging":"page"}'
     --app-profile '{"version":1,"framework":"expo","styling":"native","language":"typescript","packaging":"screen"}'
@@ -55,9 +54,9 @@ relative to the manifest; independent routes are separate page entries:
         { "id": "a", "image": "screens/a.png" },
         { "id": "b", "image": "screens/b.png" } ] } ] }
 
-Runs ~5-8 minutes, writing `<out-dir>/<page-id>.html` per page plus
-`package.result.json`. A viewport may carry `"sourceConversionId": "<id>"`
-to reuse an already succeeded conversion of the same bytes for free.
+Writes `<out-dir>/<page-id>.html` per page plus `package.result.json`. A
+viewport may carry `"sourceConversionId": "<id>"` to reuse an already
+succeeded conversion of the same bytes for free.
 
 ## 4. Integrate
 

package/skills/design-draft/SKILL.md

@@ -8,68 +8,34 @@ description: "Required to draft candidate interface designs through the
 
 # Design draft
 
-Buy one small set of candidate designs and keep every one addressable. This
-is the hosted drafting API driven over HTTP — not the local `12ui draft`
-command, which runs a four-candidate version of the same flow in one step —
-so use it when the run needs more slots, per-slot references, or tighter
-direction control.
-
-Authenticate every request with `Authorization: Bearer <key>`, a personal
-key from `TWELVE_UI_API_KEY` or `~/.config/12ui/credentials.json` with the
-`design.corpus.retrieve` scope, against `TWELVE_UI_ORIGIN` or
-`https://12ui.com`.
-
-## 1. Claim the run
-
-    curl -sS -X POST "$ORIGIN/api/v1/create" \
-      -H "Authorization: Bearer $TWELVE_UI_API_KEY" \
-      -H 'content-type: application/json' \
-      -H "Idempotency-Key: <stable-run-key>" \
-      -d '{
-        "concept": "<product, audience, surface, goal, personality>",
-        "aspect": "landscape",
-        "candidates": [
-          { "slot": "a", "direction": "<short direction>" },
-          { "slot": "b", "direction": "<short direction>",
-            "referenceId": "gen-<corpus-id>" }
-        ]
-      }'
-
-You choose the concept (at most 600 characters), one aspect for the whole
-run — `landscape` (1536x1024), `portrait` (1024x1536), or `square`
-(1024x1024) — a short direction per slot, meaningfully different across
-slots, and at most one reference per candidate: `referenceId` names a corpus
-reference, or `"useReferenceImage": true` conditions on the one run-level
-`referenceImage` (base64 `data`, `mediaType`, `sha256`). `mode` defaults to
-`inspiration`; `preserve-structure` keeps the reference image's layout. A
-run holds 1-96 candidates in slots `a`-`cr`.
-
-`Idempotency-Key` identifies the run: the same key resolves the same run and
-its stored images, so a retry replays instead of buying the work twice. The
-reply is the run envelope with `id` and one entry per slot.
-
-## 2. Dispatch the candidates
-
-    curl -sS -X POST "$ORIGIN/api/v1/create/<run-id>/candidates/a" \
-      -H "Authorization: Bearer $TWELVE_UI_API_KEY" \
-      -H 'content-length: 0'
-
-One call per slot, all slots concurrently; each blocks until its own image
-settles (up to ~2.5 minutes). Send no `Idempotency-Key` here — an unkeyed
-repeat replays a settled slot for free, and a new key buys a fresh image for
-that slot.
-
-## 3. Read and download
-
-    curl -sS "$ORIGIN/api/v1/create/<run-id>" \
-      -H "Authorization: Bearer $TWELVE_UI_API_KEY"
-
-    curl -sS "$ORIGIN/api/v1/create/<run-id>/candidates/a/image" \
-      -H "Authorization: Bearer $TWELVE_UI_API_KEY" -o a.png
-
-Candidate `status` is `pending`, `dispatched`, `succeeded`, or `failed`; a
-`failed` candidate is a settled, paid outcome, not a transient error. Images
-are owner-authenticated, so download them with the same header. Runs expire
-seven days after the claim. A winning candidate can seed a branch run as
-`12ui branch execute --winner-run <run-id> --winner-slot <slot>` without
-re-uploading its bytes.
+## Setup
+
+For a public-directory install, run `npx -y @12ui/design skill install --skill design-draft` once. It pins the CLI and verifies this skill's account scopes.
+
+Buy one small set of candidate designs and keep every one addressable. Use
+this when the run needs more than the four candidates `12ui draft` produces
+in one step, a corpus reference or direction per slot, or tighter control
+over what each slot explores.
+
+    12ui create claim --concept "<product, audience, surface, goal, personality>" \
+      --candidates '[{"slot":"a","direction":"<short direction>"},
+                     {"slot":"b","direction":"<short direction>",
+                      "referenceId":"gen-<corpus-id>"}]'
+    12ui create dispatch <run-id>
+    12ui create download <run-id> --out-dir <directory>
+
+Each command prints the next; `12ui next <run-id>` reports what is still
+generating, and `--wait` blocks until every slot settles.
+
+The judgement is the brief and the slots. One aspect covers the whole run —
+`landscape` (1536x1024), `portrait` (1024x1536), `square` (1024x1024) — and
+directions must be meaningfully different from each other, since four
+paraphrases of one idea buy four of the same design. A slot takes at most one
+reference: `referenceId` names a corpus reference, or `"useReferenceImage":
+true` conditions it on the run-level `--reference-image`, whose
+`preserve-structure` mode keeps that image's layout. A run holds 1-96
+candidates in slots `a`-`cr` and expires seven days after the claim.
+
+A candidate that comes back `failed` is a settled, paid outcome rather than a
+transient error. A winning candidate seeds a branch run as
+`--winner-run <run-id> --winner-slot <slot>` without re-uploading its bytes.

package/skills/design-search/SKILL.md

@@ -8,12 +8,15 @@ description: "Required when reference imagery is the deliverable: searches
 
 # Design search
 
+## Setup
+
+For a public-directory install, run `npx -y @12ui/design skill install --skill design-search` once. It pins the CLI and verifies this skill's account scopes.
+
 The corpus has already explored, ranked, and diversified the design space,
 so retrieval returns real reference images in a considered order rather than
 another model's guess. Use it when the references themselves are the
 deliverable — surveying a space, gathering comparators, or conditioning work
-you drive yourself. (`12ui draft` already runs this retrieval when drafting
-designs.)
+you drive yourself. `12ui draft` already runs this retrieval when drafting.
 
 ## 1. Search
 
@@ -21,11 +24,9 @@ designs.)
       --query "<product, audience, surface, goal, personality>" \
       --out-dir .12ui/<slug>/references
 
-Retrieves four diverse references (`--count <n>`, up to 48), downloads the
-full images into the output directory, and writes `manifest.json` — the
-completion record with the ranked order, reference IDs, and hashes. Blocks
-~20-40 seconds with progress on stderr. Preserve the returned order; the
-ranking is the product.
+Downloads the full images into the output directory and writes
+`manifest.json` — the completion record with the ranked order, reference IDs,
+and hashes. Preserve the returned order; the ranking is the product.
 
 `--mode direct|balanced|adventurer` trades literal query adherence against
 exploration; `balanced` is the default. For a redesign,