ima2-gen 3.12.2 → 3.12.3

package/routes/assetDerived.js

@@ -1,17 +1,18 @@
 import express from "express";
 import { existsSync } from "fs";
-import { writeFile } from "fs/promises";
+import { readFile, writeFile } from "fs/promises";
 import { basename } from "path";
 import { config } from "../config.js";
 import { errInfo } from "../lib/errInfo.js";
 import { logEvent } from "../lib/logger.js";
 import { requireRuntimeContext } from "../lib/runtimeContext.js";
 import { assertRegularGeneratedPath, resolveInGenerated } from "../lib/assetLifecycle.js";
+import { isRasterPath, isVectorPreset, vectorizeImageBuffer } from "../lib/vectorizeImage.js";
 import { createAsset } from "../lib/assetsStore.js";
 import { safeWriteSidecar } from "../lib/atomicWrite.js";
 import { invalidateHistoryIndex } from "../lib/historyIndex.js";
 const PNG_SIGNATURE = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
-const DERIVED_KINDS = ["keyed-png"];
+const DERIVED_KINDS = ["keyed-png", "vector-svg"];
 const MAX_META_BYTES = 2048;
 function httpError(status, code, message) {
     const err = new Error(message);
@@ -34,6 +35,78 @@ function parseMeta(raw) {
         throw httpError(400, "DERIVED_META_INVALID", "meta query must be a JSON object");
     }
 }
+function numericQuery(raw) {
+    if (typeof raw !== "string" || raw.trim() === "")
+        return undefined;
+    const parsed = Number(raw);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+/**
+ * Trace an existing generated raster into SVG.
+ *
+ * The client sends NO body: the source is already validated inside generated
+ * storage, so the server reads it directly. That avoids re-uploading megabytes the
+ * server already has, and keeps arbitrary XML off the request surface.
+ */
+async function handleVectorSvg(req, res, source) {
+    const { sourceRel, sourceAbs } = source;
+    if (!isRasterPath(sourceRel)) {
+        // Guards against tracing an existing .svg (no recursion) and against video
+        // files, which already live in the same directory.
+        throw httpError(400, "DERIVED_SOURCE_NOT_RASTER", "source must be a png, jpeg, or webp image");
+    }
+    const presetRaw = typeof req.query.preset === "string" ? req.query.preset : "auto";
+    if (!isVectorPreset(presetRaw)) {
+        throw httpError(400, "DERIVED_PRESET_INVALID", "preset must be one of: auto, flat, detailed, mono");
+    }
+    const preset = presetRaw;
+    const traced = await vectorizeImageBuffer(await readFile(sourceAbs), {
+        preset,
+        colorPrecision: numericQuery(req.query.colorPrecision),
+        filterSpeckle: numericQuery(req.query.filterSpeckle),
+        cornerThreshold: numericQuery(req.query.cornerThreshold),
+    });
+    const projectId = typeof req.query.projectId === "string" && req.query.projectId ? req.query.projectId : undefined;
+    const meta = parseMeta(req.query.meta);
+    const stem = basename(sourceRel).replace(/\.[a-z0-9]+$/i, "");
+    const outName = `${stem}-vector-${Date.now()}.svg`;
+    const outAbs = resolveInGenerated(config.storage.generatedDir, outName);
+    await writeFile(outAbs, traced.svg, "utf8");
+    await safeWriteSidecar(`${outAbs}.json`, {
+        kind: "vector-svg",
+        derivedFrom: sourceRel,
+        createdAt: Date.now(),
+        preset: traced.preset,
+        pathCount: traced.pathCount,
+        ...meta,
+    });
+    const asset = createAsset({
+        kind: "image",
+        name: typeof req.query.name === "string" && req.query.name ? req.query.name.slice(0, 80) : outName,
+        filePath: outName,
+        folderId: projectId,
+        notes: undefined,
+        metadata: {
+            derivedFrom: sourceRel,
+            derivedKind: "vector-svg",
+            vector: true,
+            preset: traced.preset,
+            pathCount: traced.pathCount,
+            ...meta,
+        },
+        tags: [],
+    });
+    invalidateHistoryIndex();
+    logEvent("assets", "derived-create", { assetId: asset.id, kind: "vector-svg", source: sourceRel });
+    res.status(201).json({
+        filePath: outName,
+        asset,
+        pathCount: traced.pathCount,
+        bytes: traced.bytes,
+        elapsedMs: traced.elapsedMs,
+        preset: traced.preset,
+    });
+}
 export function registerAssetDerivedRoutes(app, ctxRaw) {
     requireRuntimeContext(ctxRaw);
     const rawPng = express.raw({ type: "image/png", limit: "30mb" });
@@ -50,6 +123,10 @@ export function registerAssetDerivedRoutes(app, ctxRaw) {
             if (!existsSync(sourceAbs))
                 throw httpError(400, "DERIVED_SOURCE_MISSING", "source does not exist in generated storage");
             await assertRegularGeneratedPath(sourceAbs);
+            if (kind === "vector-svg") {
+                await handleVectorSvg(req, res, { sourceRel, sourceAbs });
+                return;
+            }
             const body = req.body;
             if (!Buffer.isBuffer(body) || body.length < PNG_SIGNATURE.length || !body.subarray(0, 8).equals(PNG_SIGNATURE)) {
                 throw httpError(400, "DERIVED_BODY_NOT_PNG", "body must be a PNG (image/png raw body)");

package/server.js

@@ -270,6 +270,14 @@ export function buildApp(ctx) {
     app.use("/generated", (req, res, next) => {
         if (req.path.endsWith(".json"))
             return res.status(404).type("text/plain").send("Generated metadata is not public");
+        if (req.path.toLowerCase().endsWith(".svg")) {
+            // SVG is an active document under top-level navigation, and /generated sits
+            // outside the LAN token guard (which only covers /api). Traced output is
+            // machine-generated, but the guarantee should not rest on writer discipline:
+            // this neuters script execution for any .svg served from here, now or later.
+            res.setHeader("Content-Security-Policy", "default-src 'none'; style-src 'unsafe-inline'");
+            res.setHeader("X-Content-Type-Options", "nosniff");
+        }
         return next();
     }, express.static(ctx.config.storage.generatedDir, {
         maxAge: ctx.config.storage.staticMaxAge,

package/skills/ima2/SKILL.md

@@ -387,6 +387,43 @@ pattern painted into an opaque image; the flag sends the real API parameter and
 the tuned suffix together. Always verify alpha rather than trusting the look of
 a preview: `sharp(file).metadata()` should report `channels: 4, hasAlpha: true`.
 
+### Raster-to-Vector (SVG)
+
+`ima2 gen` always produces raster. When you need a REAL vector — a logo that
+scales, an icon for a design system, a brand-safe SVG asset — trace the raster
+afterwards. `flat vector style` in a prompt only produces a bitmap that LOOKS
+vector; it has no paths.
+
+```bash
+# 1. generate a cutout, 2. trace it
+ima2 gen "a minimal geometric fox head logo mark, flat vector style" \
+  --bg transparent --quality high --mode direct -o logo.png
+ima2 vectorize logo.png -o logo.svg --json
+```
+
+Runs fully local — no server, no provider, no network. `--json` reports
+`pathCount`, `bytes`, and `elapsedMs` so an agent can check the result
+programmatically.
+
+Presets: `auto` (default, best colour fidelity), `flat` (fewer colour layers),
+`detailed`, and `mono` (binary silhouette). Tune with `--color-precision 1-8`,
+`--filter-speckle 0-128`, `--corner-threshold 0-180`; pass a knob only when you
+actually want to override the preset, since any value replaces the tuned config.
+
+**Where it works and where it does not.** Measured on a 1254x1254 keyed
+character asset: `auto` produced 722 paths at 585KB and is visually
+indistinguishable from the source. Cutouts, icons, logos, flat art, and sprite
+frames trace cleanly. Photographs and small text do NOT — text becomes
+illegible smudges and gradients fragment into hundreds of bands. Key or
+generate a clean cutout FIRST; tracing quality follows input flatness.
+
+`mono` has no alpha channel, so a transparent cutout becomes a silhouette on a
+black field. Use it for stencils and line art, not for cutouts.
+
+In the app, the same operation is the "Convert to SVG" action on any image
+asset (generation grid tile or Assets library preview), which saves the SVG
+into the current project.
+
 ### Korean Text in Images
 
 When generating images with Korean text:

package/ui/dist/.vite/manifest.json

@@ -3,13 +3,13 @@
     "file": "assets/AssetGenWorkspace-B7tTK0Sx.css",
     "src": "_AssetGenWorkspace-B7tTK0Sx.css"
   },
-  "_AssetGenWorkspace-BQkdilsH.js": {
-    "file": "assets/AssetGenWorkspace-BQkdilsH.js",
+  "_AssetGenWorkspace-Cguej69V.js": {
+    "file": "assets/AssetGenWorkspace-Cguej69V.js",
     "name": "AssetGenWorkspace",
     "isDynamicEntry": true,
     "imports": [
       "index.html",
-      "_KeyingPanel-CtGvO6-u.js"
+      "_VectorizePanel-DdlVvwV1.js"
     ],
     "dynamicImports": [
       "src/components/assetgen/SpriteRecipeWorkspace.tsx"
@@ -18,12 +18,12 @@
       "assets/AssetGenWorkspace-B7tTK0Sx.css"
     ]
   },
-  "_KeyingPanel-CtGvO6-u.js": {
-    "file": "assets/KeyingPanel-CtGvO6-u.js",
-    "name": "KeyingPanel",
+  "_VectorizePanel-DdlVvwV1.js": {
+    "file": "assets/VectorizePanel-DdlVvwV1.js",
+    "name": "VectorizePanel",
     "imports": [
       "index.html",
-      "_useAgentDialogFocus-Dyj_bA5Q.js"
+      "_useAgentDialogFocus-DcWwFfYd.js"
     ]
   },
   "__vite-browser-external": {
@@ -32,15 +32,15 @@
     "src": "__vite-browser-external",
     "isDynamicEntry": true
   },
-  "_useAgentDialogFocus-Dyj_bA5Q.js": {
-    "file": "assets/useAgentDialogFocus-Dyj_bA5Q.js",
+  "_useAgentDialogFocus-DcWwFfYd.js": {
+    "file": "assets/useAgentDialogFocus-DcWwFfYd.js",
     "name": "useAgentDialogFocus",
     "imports": [
       "index.html"
     ]
   },
   "index.html": {
-    "file": "assets/index-DTEhasVd.js",
+    "file": "assets/index-Sch70vBs.js",
     "name": "index",
     "src": "index.html",
     "isEntry": true,
@@ -55,16 +55,16 @@
       "src/components/card-news/CardNewsWorkspace.tsx",
       "src/components/agent/AgentWorkspace.tsx",
       "src/components/assets/AssetsWorkspace.tsx",
-      "_AssetGenWorkspace-BQkdilsH.js",
+      "_AssetGenWorkspace-Cguej69V.js",
       "src/components/home/HomeWorkspace.tsx",
       "src/components/PromptLibraryPanel.tsx"
     ],
     "css": [
-      "assets/index-DB9EfKr6.css"
+      "assets/index-DGRIdnsL.css"
     ]
   },
   "node_modules/pptxgenjs/dist/pptxgen.es.js": {
-    "file": "assets/pptxgen.es-BEVsR2-i.js",
+    "file": "assets/pptxgen.es-CSd_gCsx.js",
     "name": "pptxgen.es",
     "src": "node_modules/pptxgenjs/dist/pptxgen.es.js",
     "isDynamicEntry": true,
@@ -78,7 +78,7 @@
     ]
   },
   "src/components/GenerationRequestLogPanel.tsx": {
-    "file": "assets/GenerationRequestLogPanel-CWqbfNis.js",
+    "file": "assets/GenerationRequestLogPanel-giH1e4hp.js",
     "name": "GenerationRequestLogPanel",
     "src": "src/components/GenerationRequestLogPanel.tsx",
     "isDynamicEntry": true,
@@ -87,7 +87,7 @@
     ]
   },
   "src/components/NodeCanvas.tsx": {
-    "file": "assets/NodeCanvas-m41ECrFJ.js",
+    "file": "assets/NodeCanvas-CF_NHudI.js",
     "name": "NodeCanvas",
     "src": "src/components/NodeCanvas.tsx",
     "isDynamicEntry": true,
@@ -99,7 +99,7 @@
     ]
   },
   "src/components/PromptImportDialog.tsx": {
-    "file": "assets/PromptImportDialog-8hDG8MeK.js",
+    "file": "assets/PromptImportDialog-B40X9UAa.js",
     "name": "PromptImportDialog",
     "src": "src/components/PromptImportDialog.tsx",
     "isDynamicEntry": true,
@@ -112,7 +112,7 @@
     ]
   },
   "src/components/PromptImportDiscoverySection.tsx": {
-    "file": "assets/PromptImportDiscoverySection-D2_TAuLm.js",
+    "file": "assets/PromptImportDiscoverySection-BWoUDHj1.js",
     "name": "PromptImportDiscoverySection",
     "src": "src/components/PromptImportDiscoverySection.tsx",
     "isDynamicEntry": true,
@@ -121,7 +121,7 @@
     ]
   },
   "src/components/PromptImportFolderSection.tsx": {
-    "file": "assets/PromptImportFolderSection-qv0qhTwq.js",
+    "file": "assets/PromptImportFolderSection-DBSEyJb-.js",
     "name": "PromptImportFolderSection",
     "src": "src/components/PromptImportFolderSection.tsx",
     "isDynamicEntry": true,
@@ -130,7 +130,7 @@
     ]
   },
   "src/components/PromptLibraryPanel.tsx": {
-    "file": "assets/PromptLibraryPanel-BPOD61FZ.js",
+    "file": "assets/PromptLibraryPanel-DLywJBpt.js",
     "name": "PromptLibraryPanel",
     "src": "src/components/PromptLibraryPanel.tsx",
     "isDynamicEntry": true,
@@ -142,7 +142,7 @@
     ]
   },
   "src/components/SettingsWorkspace.tsx": {
-    "file": "assets/SettingsWorkspace-BKgXN2l9.js",
+    "file": "assets/SettingsWorkspace-BawWId1t.js",
     "name": "SettingsWorkspace",
     "src": "src/components/SettingsWorkspace.tsx",
     "isDynamicEntry": true,
@@ -151,43 +151,43 @@
     ]
   },
   "src/components/agent/AgentWorkspace.tsx": {
-    "file": "assets/AgentWorkspace-CW1x4uOl.js",
+    "file": "assets/AgentWorkspace-AJkVTaU5.js",
     "name": "AgentWorkspace",
     "src": "src/components/agent/AgentWorkspace.tsx",
     "isDynamicEntry": true,
     "imports": [
       "index.html",
-      "_useAgentDialogFocus-Dyj_bA5Q.js"
+      "_useAgentDialogFocus-DcWwFfYd.js"
     ]
   },
   "src/components/assetgen/SpriteRecipeWorkspace.tsx": {
-    "file": "assets/SpriteRecipeWorkspace-D8gHgnt8.js",
+    "file": "assets/SpriteRecipeWorkspace-Biy2yRAk.js",
     "name": "SpriteRecipeWorkspace",
     "src": "src/components/assetgen/SpriteRecipeWorkspace.tsx",
     "isDynamicEntry": true,
     "imports": [
       "index.html",
-      "_AssetGenWorkspace-BQkdilsH.js",
-      "_KeyingPanel-CtGvO6-u.js",
-      "_useAgentDialogFocus-Dyj_bA5Q.js"
+      "_AssetGenWorkspace-Cguej69V.js",
+      "_VectorizePanel-DdlVvwV1.js",
+      "_useAgentDialogFocus-DcWwFfYd.js"
     ]
   },
   "src/components/assets/AssetsWorkspace.tsx": {
-    "file": "assets/AssetsWorkspace-CYSkmYU-.js",
+    "file": "assets/AssetsWorkspace-DIQ9wBuD.js",
     "name": "AssetsWorkspace",
     "src": "src/components/assets/AssetsWorkspace.tsx",
     "isDynamicEntry": true,
     "imports": [
       "index.html",
-      "_KeyingPanel-CtGvO6-u.js",
-      "_useAgentDialogFocus-Dyj_bA5Q.js"
+      "_VectorizePanel-DdlVvwV1.js",
+      "_useAgentDialogFocus-DcWwFfYd.js"
     ],
     "css": [
       "assets/AssetsWorkspace-BdptASFf.css"
     ]
   },
   "src/components/canvas-mode/index.ts": {
-    "file": "assets/index-Bzt4YWub.js",
+    "file": "assets/index-D05Ong5g.js",
     "name": "index",
     "src": "src/components/canvas-mode/index.ts",
     "isDynamicEntry": true,
@@ -199,7 +199,7 @@
     ]
   },
   "src/components/card-news/CardNewsWorkspace.tsx": {
-    "file": "assets/CardNewsWorkspace-nBKX5TXr.js",
+    "file": "assets/CardNewsWorkspace-C_Eb2g7d.js",
     "name": "CardNewsWorkspace",
     "src": "src/components/card-news/CardNewsWorkspace.tsx",
     "isDynamicEntry": true,
@@ -208,7 +208,7 @@
     ]
   },
   "src/components/home/HomeWorkspace.tsx": {
-    "file": "assets/HomeWorkspace-CxqIGhb9.js",
+    "file": "assets/HomeWorkspace-DHmXGtqC.js",
     "name": "HomeWorkspace",
     "src": "src/components/home/HomeWorkspace.tsx",
     "isDynamicEntry": true,
@@ -217,7 +217,7 @@
     ]
   },
   "src/components/prompt-builder/PromptBuilderPanel.tsx": {
-    "file": "assets/PromptBuilderPanel-ChOoMAVA.js",
+    "file": "assets/PromptBuilderPanel-D7NJto-1.js",
     "name": "PromptBuilderPanel",
     "src": "src/components/prompt-builder/PromptBuilderPanel.tsx",
     "isDynamicEntry": true,