@bitmagic/cli 0.1.65-dev.16 → 0.1.65-dev.17

package/dist/mobile/asset-hosts.d.ts

@@ -12,18 +12,16 @@
  * that redirection: which hosts are ours to fetch on the browser's behalf, and the reversible path
  * that carries one.
  *
- * The host suffixes are the same environment classification `rehost-imported-assets.ts` uses in
- * game-play-agent: `bitmagic.ai` is prod (`mini.bitmagic.ai`, `forged-assets.bitmagic.ai`, ...) and
- * `bitmagic.cloud` is dev/sandbox (`beta.portal.bitmagic.cloud`,
- * `magic-mesh-gen.sandbox.dev.bitmagic.cloud`, ...). Everything else is deliberately left alone:
- * `esm.sh` serves the import map's modules and already answers `*`, and an unrecognised host is
- * more likely to be a creator's own endpoint than an asset we should be relaying.
+ * The host allowlist itself lives in `@bitmagic/asset-core` (`managed-hosts.ts`) and is
+ * re-exported here, because api-server needs the same answer when it decides whether a
+ * caller-supplied library `assetUrl` may be stored — and two copies of a security-relevant
+ * allowlist drift. `esm.sh` and everything else is deliberately left alone: it serves the import
+ * map's modules and already answers `*`.
  */
+import { isManagedAssetHost, MANAGED_HOST_SUFFIXES } from '@bitmagic/asset-core';
+export { isManagedAssetHost, MANAGED_HOST_SUFFIXES };
 /** The bridge route every proxied asset is fetched through. Trailing slash included. */
 export declare const CDN_PROXY_PREFIX = "/__bm/cdn/";
-/** Host suffixes that identify a bitmagic-controlled asset host. See the file header. */
-export declare const MANAGED_HOST_SUFFIXES: readonly ["bitmagic.ai", "bitmagic.cloud"];
-export declare function isManagedAssetHost(hostname: string): boolean;
 /**
  * The same-origin path that stands in for `url`, or null when the URL is not ours to proxy.
  *

package/dist/mobile/asset-hosts.js

@@ -12,25 +12,16 @@
  * that redirection: which hosts are ours to fetch on the browser's behalf, and the reversible path
  * that carries one.
  *
- * The host suffixes are the same environment classification `rehost-imported-assets.ts` uses in
- * game-play-agent: `bitmagic.ai` is prod (`mini.bitmagic.ai`, `forged-assets.bitmagic.ai`, ...) and
- * `bitmagic.cloud` is dev/sandbox (`beta.portal.bitmagic.cloud`,
- * `magic-mesh-gen.sandbox.dev.bitmagic.cloud`, ...). Everything else is deliberately left alone:
- * `esm.sh` serves the import map's modules and already answers `*`, and an unrecognised host is
- * more likely to be a creator's own endpoint than an asset we should be relaying.
+ * The host allowlist itself lives in `@bitmagic/asset-core` (`managed-hosts.ts`) and is
+ * re-exported here, because api-server needs the same answer when it decides whether a
+ * caller-supplied library `assetUrl` may be stored — and two copies of a security-relevant
+ * allowlist drift. `esm.sh` and everything else is deliberately left alone: it serves the import
+ * map's modules and already answers `*`.
  */
+import { isManagedAssetHost, MANAGED_HOST_SUFFIXES } from '@bitmagic/asset-core';
+export { isManagedAssetHost, MANAGED_HOST_SUFFIXES };
 /** The bridge route every proxied asset is fetched through. Trailing slash included. */
 export const CDN_PROXY_PREFIX = '/__bm/cdn/';
-/** Host suffixes that identify a bitmagic-controlled asset host. See the file header. */
-export const MANAGED_HOST_SUFFIXES = ['bitmagic.ai', 'bitmagic.cloud'];
-/** A hostname with no port and no credentials — what a proxy path's first segment may hold. */
-const HOSTNAME = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$/;
-export function isManagedAssetHost(hostname) {
-    const host = hostname.toLowerCase();
-    if (!HOSTNAME.test(host))
-        return false;
-    return MANAGED_HOST_SUFFIXES.some((suffix) => host === suffix || host.endsWith(`.${suffix}`));
-}
 /**
  * The same-origin path that stands in for `url`, or null when the URL is not ours to proxy.
  *

package/dist/mobile/asset-hosts.js.map

@@ -1 +1 @@
-{"version":3,"file":"asset-hosts.js","sourceRoot":"","sources":["../../src/mobile/asset-hosts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,wFAAwF;AACxF,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAE7C,yFAAyF;AACzF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,aAAa,EAAE,gBAAgB,CAAU,CAAC;AAEhF,+FAA+F;AAC/F,MAAM,QAAQ,GAAG,mEAAmE,CAAC;AAErF,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACpC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC;AAChG,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IAC7E,IAAI,MAAM,CAAC,IAAI,KAAK,EAAE,IAAI,MAAM,CAAC,QAAQ,KAAK,EAAE,IAAI,MAAM,CAAC,QAAQ,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACxF,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,OAAO,GAAG,gBAAgB,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;AACnF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,gBAAgB,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3D,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAChD,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,OAAO,WAAW,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"asset-hosts.js","sourceRoot":"","sources":["../../src/mobile/asset-hosts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAEjF,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,CAAC;AAErD,wFAAwF;AACxF,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAE7C;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IAC7E,IAAI,MAAM,CAAC,IAAI,KAAK,EAAE,IAAI,MAAM,CAAC,QAAQ,KAAK,EAAE,IAAI,MAAM,CAAC,QAAQ,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACxF,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,OAAO,GAAG,gBAAgB,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;AACnF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,gBAAgB,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3D,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAChD,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,OAAO,WAAW,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;AAC/C,CAAC"}

package/dist/project/character-search.d.ts

@@ -0,0 +1,30 @@
+export declare function characterSearchPath(root: string): string;
+/** One row as the search displayed it. The shape `libraryPick` needs, plus the caption. */
+export interface CharacterCandidate {
+    sid: string;
+    assetUrl: string;
+    description: string;
+    subject: string | null;
+    similarity: number;
+}
+export interface CharacterSearchRecord {
+    /** The prompt that produced this list — `add --id` reuses it as the asset's brief. */
+    prompt: string;
+    /** Which shelf was searched. `add` sends the matching `voxelize` so the media cannot cross. */
+    representation: 'voxel' | 'lowpoly';
+    /** The floor automatic substitution would have applied, for the "auto" column. */
+    threshold: number;
+    searchedAt: string;
+    candidates: CharacterCandidate[];
+}
+/** The last search, or null when there is none to trust. */
+export declare function readCharacterSearch(root: string): CharacterSearchRecord | null;
+export declare function writeCharacterSearch(root: string, record: CharacterSearchRecord): void;
+/**
+ * The cached row with this id, or null.
+ *
+ * Case-insensitive on the id because a creator reads it off a table and retypes
+ * it, and the corpus uses one case throughout — so a capital letter is a typo
+ * with an obvious intent, not a different character.
+ */
+export declare function findCachedCandidate(record: CharacterSearchRecord, sid: string): CharacterCandidate | null;

package/dist/project/character-search.js

@@ -0,0 +1,82 @@
+/**
+ * The candidates the last `bitmagic character search` returned, so
+ * `bitmagic character add --id <sid>` can name one of them.
+ *
+ * The search already fetched every row it displayed — sid, URL, caption and
+ * score. Keeping them means `add --id` needs nothing but the id: no second
+ * query, no re-ranking, and no asking the creator to retype the prompt that
+ * produced the list they are looking at. It also means `add` cannot drift from
+ * what was on screen, which a re-search could (the catalogue grows).
+ *
+ * Lives under `.bitmagic/` like `reference.json` and `cover.json`: generated,
+ * machine-written state. NOT in `bitmagic.json`, deliberately — that file is
+ * inside the publish fingerprint (shared/asset-core's publish-source.ts), so
+ * recording a search there would invalidate a passing `bitmagic verify` every
+ * time somebody browsed the shelf.
+ *
+ * Readers are lenient, like `readCoverRecord` and the reference records: a
+ * corrupt or absent file reads as "no search yet", because the worst case is one
+ * re-run of a free command, and a hard error would wedge the very command that
+ * would have replaced the bad file.
+ *
+ * There is deliberately no expiry. The catalogue only changes when someone
+ * promotes to it, and a stale row fails loudly and harmlessly (the URL 404s) —
+ * where a timeout would expire a list the creator is still reading. `add` prints
+ * the search's own timestamp instead, so age is visible rather than enforced.
+ */
+import * as path from 'path';
+import { readJsonFile, writeJsonAtomic } from '../atomic-json.js';
+const SEARCH_FILE = path.join('.bitmagic', 'character-search.json');
+export function characterSearchPath(root) {
+    return path.join(root, SEARCH_FILE);
+}
+function isCandidate(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const row = value;
+    return typeof row.sid === 'string' && row.sid !== ''
+        && typeof row.assetUrl === 'string' && row.assetUrl !== ''
+        && typeof row.similarity === 'number';
+}
+/** The last search, or null when there is none to trust. */
+export function readCharacterSearch(root) {
+    const raw = readJsonFile(characterSearchPath(root));
+    if (typeof raw !== 'object' || raw === null)
+        return null;
+    const record = raw;
+    if (typeof record.prompt !== 'string')
+        return null;
+    if (record.representation !== 'voxel' && record.representation !== 'lowpoly')
+        return null;
+    if (!Array.isArray(record.candidates))
+        return null;
+    const candidates = record.candidates.filter(isCandidate).map((row) => ({
+        sid: row.sid,
+        assetUrl: row.assetUrl,
+        description: typeof row.description === 'string' ? row.description : '',
+        subject: typeof row.subject === 'string' ? row.subject : null,
+        similarity: row.similarity,
+    }));
+    return {
+        prompt: record.prompt,
+        representation: record.representation,
+        threshold: typeof record.threshold === 'number' ? record.threshold : 0,
+        searchedAt: typeof record.searchedAt === 'string' ? record.searchedAt : '',
+        candidates,
+    };
+}
+export function writeCharacterSearch(root, record) {
+    writeJsonAtomic(characterSearchPath(root), record);
+}
+/**
+ * The cached row with this id, or null.
+ *
+ * Case-insensitive on the id because a creator reads it off a table and retypes
+ * it, and the corpus uses one case throughout — so a capital letter is a typo
+ * with an obvious intent, not a different character.
+ */
+export function findCachedCandidate(record, sid) {
+    const wanted = sid.trim().toLowerCase();
+    return record.candidates.find((row) => row.sid.toLowerCase() === wanted) ?? null;
+}
+//# sourceMappingURL=character-search.js.map

package/dist/project/character-search.js.map

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

package/dist/scaffold/blender-level-skill-files.js

@@ -60,7 +60,7 @@ any kind; this path is for places that are designed, not grown.
 assumes voxels until told otherwise: put \`"artStyle": "low-poly"\` at the top level of
 \`src/work/game.json\` (or scaffold with \`bitmagic init --art-style low-poly\`). That one field
 switches the cover and reference prompts to low-poly, makes \`assets add\` and \`generate model|prop\`
-keep meshes instead of voxelizing, makes \`generate character\` keep the textured rig, drops the
+keep meshes instead of voxelizing, makes \`bitmagic character generate\` keep the textured rig, drops the
 engine's voxel lighting/bloom presets, and gives \`bitmagic judge\` the medium when
 \`## Art direction\` is missing. Set it before the first cover, or the cover is a picture of cubes.
 
@@ -600,7 +600,8 @@ bitmagic assets add build/level/<name>.glb --name <name> --keep-glb --asset-id l
 | \`bitmagic cover\`, \`bitmagic reference make\` | MagicaVoxel-style prompt lead and tail | flat-shaded low-poly lead and tail; same image model |
 | \`bitmagic assets add x.glb\` | voxelized in a headless browser | kept as a \`glb\` asset (\`--voxelize\` to bake) |
 | \`bitmagic generate model\` / \`prop\` | voxel master baked in the browser | mesh generated, re-uploaded, registered as \`glb\` (\`--voxelize\` to bake) |
-| \`bitmagic generate character\` | voxelized rig, library search | textured low-poly rig, its own library shelf where enabled (\`--voxelize\` to override) |
+| \`bitmagic character generate\` | voxelized rig, library search | textured low-poly rig, its own library shelf where enabled (\`--voxelize\` to override) |
+| \`bitmagic character search\` / \`add\` | searches the voxel shelf | searches the low-poly shelf; free, never forges |
 | \`bitmagic generate vehicle\` | voxel car | voxel car anyway — the builder is voxel-native; it says so |
 | engine on load | sunset hemisphere light + faint bloom | neither; \`MeshLevel\`'s own lighting stands |
 | \`bitmagic judge\` with no \`## Art direction\` | grades style as it finds it | judges within low-poly |

package/dist/scaffold/blender-level-skill-files.js.map

@@ -1 +1 @@
-{"version":3,"file":"blender-level-skill-files.js","sourceRoot":"","sources":["../../src/scaffold/blender-level-skill-files.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,MAAM,UAAU,wBAAwB;IACtC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8QR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,iCAAiC;IAC/C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyFR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2FR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyER,CAAC;AACF,CAAC;AAED,MAAM,UAAU,mCAAmC;IACjD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+GR,CAAC;AACF,CAAC"}
+{"version":3,"file":"blender-level-skill-files.js","sourceRoot":"","sources":["../../src/scaffold/blender-level-skill-files.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,MAAM,UAAU,wBAAwB;IACtC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8QR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,iCAAiC;IAC/C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyFR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2FR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyER,CAAC;AACF,CAAC;AAED,MAAM,UAAU,mCAAmC;IACjD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgHR,CAAC;AACF,CAAC"}

package/dist/scaffold/project-files.js

@@ -1079,7 +1079,7 @@ bitmagic generate block-type --name mossy_brick --description "damp green moss o
 bitmagic generate sound      --prompt "heavy wooden door slamming" [--duration 3] [--loop]
 bitmagic generate music      --prompt "driving synthwave, no vocals" [--duration 30] [--instrumental] [--out bed.mp3 --no-world]
 bitmagic generate image      --name hero-portrait --prompt "..." [--width 512] [--height 512]
-bitmagic generate character  --name guard --prompt "..." [--apply-to-player] [--no-library]
+bitmagic character generate  --name guard --prompt "..." [--apply-to-player] [--fresh]   # or FREE off the shelf: character search --prompt "..." then character add --name guard --id <sid>
 bitmagic generate animation  --family gait --name LimpStride --based-on walk [--dial limpSide=right]
 bitmagic generate animation  --spec clip.json          # melee and oneShot clips: a spec file
 bitmagic generate video      --prompt "the castle gates swing open" [--duration 5] [--image cover.png]
@@ -1087,7 +1087,7 @@ bitmagic generate model      --prompt "a mossy stone arch" [--height 3]
 bitmagic generate vehicle    --prompt "a rusty orange pickup" | --preset VAN
 \`\`\`
 
-Run \`bitmagic generate <type> --help\` for the full flags of any one.
+Run \`bitmagic generate <type> --help\` for the full flags of any one, or \`bitmagic character <verb> --help\` — characters are their own group, where \`generate\` costs sparks and \`search\`/\`add\` are free because they use the ready-made library instead of forging.
 
 **Always add \`--original-prompt "<creator's request, verbatim>"\`** — to EVERY \`bitmagic\` command, \`build\`/\`verify\`/\`dev\`/\`reload\`/\`publish\` included. Never affects output; it is what counts the prompts shown on the game's public page.
 
@@ -1535,7 +1535,7 @@ The \`bitmagic\` CLI generates content directly into this project. Eleven types
 | \`bitmagic generate sound --prompt "..."\` | a sound effect | \`assets[]\` |
 | \`bitmagic generate music --prompt "..." [--duration 30]\` | a music track (loops by default; billed per second) | \`assets[]\` (or a file with \`--out <mp3> --no-world\`) |
 | \`bitmagic generate image --name <id> --prompt "..."\` | a 2D image | \`assets[]\` |
-| \`bitmagic generate character --name <id> --prompt "..."\` | a rigged character (a close-enough ready-made one when the library has it, in seconds; \`--no-library\` always makes a new one) | \`assets[]\` |
+| \`bitmagic character generate --name <id> --prompt "..."\` | a rigged character; substitutes a close-enough ready-made one when the library has it (\`--fresh\` always forges). \`character search --prompt "..."\` then \`character add --name <id> --id <sid>\` instead is **free** and never forges — prefer it when any plausible body will do | \`assets[]\` |
 | \`bitmagic generate animation --family gait ...\` or \`--spec <file>\` | an animation clip | \`assets[]\` |
 | \`bitmagic generate video --prompt "..." [--duration 5] [--image <png>]\` | a short 720p clip for a cutscene (billed per second) | \`assets[]\`, played with \`engine.playVideo("<id>")\` |
 | \`bitmagic generate model --prompt "..."\` | a new 3D model | \`assets[]\` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitmagic/cli",
-  "version": "0.1.65-dev.16",
+  "version": "0.1.65-dev.17",
   "description": "Build Bitmagic games from your own agent tool",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Bitmagic Oy",
@@ -25,9 +25,9 @@
     "playwright-core": "^1.59.1",
     "tar": "^7.4.3",
     "ws": "^8.21.3",
-    "@bitmagic/animation-forger": "0.1.20-dev.16",
-    "@bitmagic/world-forger": "0.1.25-dev.16",
-    "@bitmagic/asset-core": "0.2.20-dev.16"
+    "@bitmagic/animation-forger": "0.1.20-dev.17",
+    "@bitmagic/asset-core": "0.2.20-dev.17",
+    "@bitmagic/world-forger": "0.1.25-dev.17"
   },
   "devDependencies": {
     "@eslint/js": "^9.38.0",