@drawcall/market 0.1.37 → 0.1.38

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drawcall/market",
-  "version": "0.1.37",
+  "version": "0.1.38",
   "repository": {
     "type": "git",
     "url": "https://github.com/drawcall-ai/market",
@@ -12,6 +12,11 @@
     ".": "./src/index.ts",
     "./install": "./src/install-entry.ts"
   },
+  "files": [
+    "dist",
+    "src",
+    "skills"
+  ],
   "publishConfig": {
     "exports": {
       ".": {

package/skills/market/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: market
+description: Find, preview, install, generate, and publish Drawcall Market assets from a coding agent.
+---
+
+# Drawcall Market
+
+Use the `npx @drawcall/market` CLI. Keep commands short and read the summary lines.
+
+## Quick Start
+
+```sh
+npx @drawcall/market search "wooden chair" --type model --limit 3
+npx @drawcall/market install wooden-chair --cwd "$PWD"
+npx @drawcall/market list --cwd "$PWD"
+npx @drawcall/market preview wooden-chair --out /tmp/wooden-chair.png
+```
+
+## Workflow
+
+1. In an existing repo, run `list --cwd "$PWD"` first to see installed local assets from `.drawcall/market-lock.json`. Use the listed names with `preview <name>` when you want preview images.
+2. Search first unless the user already gave an exact asset name. `search` requires `--type`; use `model` unless the user names another supported type: `humanoid-model`, `texture`, `humanoid-animation`, `template`, `sound-effect`, `background-music`, `environment`, or `flipbook`.
+3. Use `--limit 1` for lookup, `--limit 3` for choice. Search caps at 5 and prints full descriptions.
+4. `install` takes zero or more exact asset names (optionally `name@range`). With names, it installs those assets; with no names, it installs `assetDependencies` from the nearest `package.json`. It does not search or generate. Find names with `search` first. No `--type` is needed — asset names are unique. Use `--force` only when the user agrees to overwrite changed local files.
+5. `preview <name>` saves the preview image; no `--type` is needed. Not every type has previews (e.g. `humanoid-animation`, `template`, `sound-effect`, `background-music`); the CLI reports when one is unavailable.
+6. Use `--unapproved` only when the user asks for unapproved/private/admin assets. Do not install unapproved assets without explicit acceptance.
+7. `generate --type <type> "<prompt>"` creates a new asset; it requires login and a type that supports generation. No asset type currently supports generation.
+8. Upload only when publishing is requested: `market upload <name> <zip> "<description>" --type <type>`. Declare dependencies with repeatable flags: `--npm name@range`, `--asset name@range`, `--skill label=source`. Template uploads also read root `package.json.assetDependencies`; `--asset` flags are additive and must not conflict. Template upload omits installed dependency files whose hashes still match `.drawcall/market-lock.json`, so edited local files stay in the template. A skill source is a `skills add` argument: a whole repo (`owner/repo` or a git URL), a single skill via the full URL form `https://github.com/owner/repo/tree/<branch>/<subpath>` (the `tree/<branch>/<subpath>` shorthand needs the full URL, not `owner/repo`), or a local path to a skill directory inside the zip. Example: `market upload my-scene scene.zip "A scene" --type model --npm three@^0.178.0 --skill web-design=https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines`.
+9. Installed `environment` assets contain `public/environment/<name>.hdr` for Three.js IBL lighting and `public/environment/<name>-background.webp` for the visible equirectangular background. Use `market preview` to fetch the preview image separately.
+10. Installed `flipbook` assets contain `public/flipbook/<name>.ktx2`. Render them with `@drawcall/flipbook`'s `Flipbook` class and Three.js `KTX2Loader` for Basis-compressed files; `market preview` fetches the middle frame from the flipbook.
+
+## Humanoid animations
+
+`humanoid-animation` assets are single-clip GLBs — one motion per asset (one idle, one walk-forward, one jump, one attack) on a normalized skeleton that retargets onto any humanoid, whatever its role. A behaving character is therefore a *set* of clips, not one asset: from what the character actually does, budget the clips it needs — an idle, its locomotion (walk/run, often split by direction: fwd/bwd/left/right), and one clip per distinct action and reaction it performs — then search for each separately.
+
+`humanoid-model` assets share that same normalized skeleton and are authored to a **consistent real-world scale** — they come in at roughly the same height as each other. So you do **not** need to rescale one humanoid to match another (player vs. enemy vs. NPC); dropped in as-is they already stand at a consistent size. Avoid the trap of measuring one character's height and scaling others to it — besides being unnecessary, measuring a rigged/animated character's bounding box is unreliable and produces giants (see the `math` skill on `Box3` and skinned meshes). If you ever do need a deliberate size difference (a boss, a child NPC), apply an explicit chosen multiplier, not a measured one.
+
+Search one motion per query, named by the motion, because results rank by keyword overlap: a query naming several motions at once is dominated by whichever word matches the most assets and buries the others, so real clips look like a gap when they exist. Names describe the motion, not the character — so search the motion (`"walk forward"`, `"reload"`, `"jump"`), not the role (`"player run"`, `"boss attack"`). If a motion finds nothing, retry with synonyms (run/jog/sprint, attack/swing/strike).
+
+## Output
+
+Commands print concise, line-oriented summaries:
+
+```text
+Results: 2/8 query="wooden chair" type=model approval=approved
+- wooden-chair@1.0.0 | model | approved | Low-poly wooden chair
+Installed:
+- wooden-chair@1.0.0 (asset)
+  description: Low-poly wooden chair
+  files:
+    public/model
+    └─ wooden-chair.glb
+- three@^0.178.0 (npm)
+- web-design ← https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines (skill)
+Installed assets: 1
+- wooden-chair@1.0.0 (model)
+  files:
+    public/model
+    └─ wooden-chair.glb
+Saved preview for wooden-chair@1.0.0: /tmp/wooden-chair.png
+```
+
+Assets may also declare `skill` dependencies, installed for you via the `skills` CLI (`skills add`) during `install`. Sources are either a GitHub/git ref or a local path to a skill directory shipped inside the asset. This requires `npx` to be available.
+
+Installed non-template assets are saved to `package.json.assetDependencies`; templates are scaffolds and are not saved as project asset dependencies. Exact installed versions and file hashes are recorded in `.drawcall/market-lock.json`.
+
+`list` is offline: it reads `.drawcall/market-lock.json` from the nearest package root and prints exact installed names, versions, types, and installed file paths.
+
+If search returns no results, try one broader noun phrase. If a command returns `Error: Not logged in...`, ask before running `market login`.

package/tests/install-command.test.ts

@@ -1,67 +0,0 @@
-import assert from 'node:assert/strict'
-import test from 'node:test'
-import { resolveArg } from '../src/commands/install.js'
-
-test('resolveArg reports unapproved explicit assets clearly', async () => {
-  const client = {
-    asset: {
-      exact: async ({ includeUnapproved }: { name: string; includeUnapproved: boolean }) =>
-        includeUnapproved
-          ? {
-              name: 'qwantani-moon-noon-puresky',
-              latestVersion: '1.0.2',
-              approved: false,
-            }
-          : null,
-    },
-  } as never
-
-  await assert.rejects(
-    resolveArg(client, 'qwantani-moon-noon-puresky@1.0.2', false),
-    /has no approved versions/u,
-  )
-})
-
-test('resolveArg keeps explicit versioned refs exact when the asset exists', async () => {
-  const client = {
-    asset: {
-      exact: async () => ({ name: 'fresh-sky', latestVersion: '1.2.3', approved: true }),
-    },
-  } as never
-
-  const request = await resolveArg(client, 'fresh-sky@1.2.3', false)
-
-  assert.deepEqual(request, {
-    name: 'fresh-sky',
-    range: '1.2.3',
-    saveRange: '1.2.3',
-    save: true,
-  })
-})
-
-test('resolveArg saves an implicit range from the selected latest version', async () => {
-  const client = {
-    asset: {
-      exact: async () => ({ name: 'fresh-sky', latestVersion: '1.2.3', approved: true }),
-    },
-  } as never
-
-  const request = await resolveArg(client, 'fresh-sky', false)
-
-  assert.deepEqual(request, {
-    name: 'fresh-sky',
-    range: '*',
-    saveRange: '^1.2.3',
-    save: true,
-  })
-})
-
-test('resolveArg errors when the asset does not exist instead of deferring', async () => {
-  const client = {
-    asset: {
-      exact: async () => null,
-    },
-  } as never
-
-  await assert.rejects(resolveArg(client, 'does-not-exist@1.2.3', false), /not found/u)
-})

package/tests/install-layout.test.ts

@@ -1,307 +0,0 @@
-import assert from 'node:assert/strict'
-import * as fs from 'node:fs/promises'
-import * as os from 'node:os'
-import * as path from 'node:path'
-import test from 'node:test'
-import { zipSync } from 'fflate'
-import { findInstallRoot, install } from '../src/install.js'
-import { MARKET_LOCK_PATH } from '../src/market-lock.js'
-
-const textEncoder = new TextEncoder()
-
-test('install writes zip files into the package root', async () => {
-  const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'market-install-'))
-  const appRoot = path.join(tempDir, 'app')
-  const cwd = path.join(appRoot, 'src', 'feature')
-  await fs.mkdir(path.join(appRoot, 'public'), { recursive: true })
-  await fs.mkdir(cwd, { recursive: true })
-  await fs.writeFile(path.join(appRoot, 'package.json'), '{}\n')
-  await fs.writeFile(path.join(appRoot, 'README.md'), 'project readme\n')
-
-  const result = await install(
-    clientWithZip({
-      'public/humanoid-animation/idle-loop.glb': textEncoder.encode('glb'),
-      'src/generated/idle-loop.ts': textEncoder.encode('export const idleLoop = true\n'),
-      'README.md': textEncoder.encode('asset readme'),
-    }),
-    {
-      assets: [
-        {
-          name: 'idle-loop',
-          type: 'humanoid-animation',
-          version: '1.0.0',
-          description: 'Idle loop animation',
-          npmDependencies: {},
-          assetDependencies: {},
-          skillDependencies: {},
-        },
-      ],
-      npmDependencies: {},
-      skillDependencies: {},
-    },
-    { cwd },
-  )
-
-  assert.deepEqual(result, {
-    assets: [
-      {
-        name: 'idle-loop',
-        type: 'humanoid-animation',
-        version: '1.0.0',
-        description: 'Idle loop animation',
-        files: ['public/humanoid-animation/idle-loop.glb', 'src/generated/idle-loop.ts'],
-      },
-    ],
-    npmDependencies: {},
-    skillDependencies: {},
-    warnings: [],
-  })
-  assert.equal(
-    await fs.readFile(path.join(appRoot, 'public', 'humanoid-animation', 'idle-loop.glb'), 'utf-8'),
-    'glb',
-  )
-  assert.equal(
-    await fs.readFile(path.join(appRoot, 'src', 'generated', 'idle-loop.ts'), 'utf-8'),
-    'export const idleLoop = true\n',
-  )
-  assert.equal(await fs.readFile(path.join(appRoot, 'README.md'), 'utf-8'), 'project readme\n')
-  assert.equal(await exists(path.join(cwd, 'src', 'idle-loop', 'public')), false)
-
-  const lock = JSON.parse(await fs.readFile(path.join(appRoot, MARKET_LOCK_PATH), 'utf-8')) as {
-    assets: Record<string, { version: string; files: Record<string, { sha256: string }> }>
-  }
-  assert.equal(lock.assets['idle-loop'].version, '1.0.0')
-  assert.equal(
-    typeof lock.assets['idle-loop'].files['public/humanoid-animation/idle-loop.glb'].sha256,
-    'string',
-  )
-})
-
-test('install rejects zip paths that escape through parent segments', async () => {
-  const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'market-install-'))
-  await fs.writeFile(path.join(tempDir, 'package.json'), '{}\n')
-
-  await assert.rejects(
-    install(
-      clientWithZip({
-        'public/../package.json': textEncoder.encode('nope\n'),
-      }),
-      {
-        assets: [
-          {
-            name: 'bad-path',
-            type: 'template',
-            version: '1.0.0',
-            description: null,
-            npmDependencies: {},
-            assetDependencies: {},
-            skillDependencies: {},
-          },
-        ],
-        npmDependencies: {},
-        skillDependencies: {},
-      },
-      { cwd: tempDir },
-    ),
-    /unsafe path/u,
-  )
-})
-
-test('install runs the skills runner per dependency, resolving local paths against the root', async () => {
-  const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'market-skills-'))
-  const appRoot = path.join(tempDir, 'app')
-  const cwd = path.join(appRoot, 'src')
-  await fs.mkdir(cwd, { recursive: true })
-  await fs.writeFile(path.join(appRoot, 'package.json'), '{}\n')
-
-  const calls: Array<{ source: string; cwd: string }> = []
-
-  const result = await install(
-    clientWithZip({
-      'public/skills/local-skill/SKILL.md': textEncoder.encode('---\nname: local-skill\n---\n'),
-    }),
-    {
-      assets: [
-        {
-          name: 'with-skills',
-          type: 'template',
-          version: '1.0.0',
-          description: null,
-          npmDependencies: {},
-          assetDependencies: {},
-          skillDependencies: {},
-        },
-      ],
-      npmDependencies: {},
-      skillDependencies: {
-        'web-design-guidelines': 'vercel-labs/agent-skills/tree/main/skills/web-design-guidelines',
-        'local-skill': './public/skills/local-skill',
-      },
-    },
-    {
-      cwd,
-      runSkillAdd: async (source, runnerCwd) => {
-        calls.push({ source, cwd: runnerCwd })
-      },
-    },
-  )
-
-  // Every runner call uses the install root (the dir holding package.json).
-  assert.deepEqual(new Set(calls.map((c) => c.cwd)), new Set([appRoot]))
-
-  const bySource = new Map(calls.map((c) => [c.source, c]))
-  // Remote refs are passed through untouched.
-  assert.ok(bySource.has('vercel-labs/agent-skills/tree/main/skills/web-design-guidelines'))
-  // Local paths are resolved against the install root, not the cwd.
-  assert.ok(bySource.has(path.join(appRoot, 'public', 'skills', 'local-skill')))
-  assert.equal(calls.length, 2)
-
-  assert.deepEqual(result.skillDependencies, {
-    'web-design-guidelines': 'vercel-labs/agent-skills/tree/main/skills/web-design-guidelines',
-    'local-skill': './public/skills/local-skill',
-  })
-  assert.deepEqual(result.warnings, [])
-})
-
-test('install saves top-level assets according to provider policy', async () => {
-  const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'market-save-policy-'))
-  await fs.writeFile(path.join(tempDir, 'package.json'), '{}\n')
-
-  await install(
-    clientWithZip({
-      'public/model/chair.glb': textEncoder.encode('chair'),
-      'src/template.ts': textEncoder.encode('export {}\n'),
-    }),
-    {
-      assets: [
-        {
-          name: 'chair',
-          type: 'model',
-          version: '1.2.0',
-          description: null,
-          npmDependencies: {},
-          assetDependencies: {},
-          skillDependencies: {},
-        },
-        {
-          name: 'starter-template',
-          type: 'template',
-          version: '2.0.0',
-          description: null,
-          npmDependencies: {},
-          assetDependencies: {},
-          skillDependencies: {},
-        },
-      ],
-      npmDependencies: {},
-      skillDependencies: {},
-    },
-    {
-      cwd: tempDir,
-      rootRequests: [
-        { name: 'chair', range: '*', saveRange: '^1.2.0', save: true },
-        { name: 'starter-template', range: '*', saveRange: '^2.0.0', save: true },
-      ],
-      installMetadata: {
-        template: {
-          saveOnInstall: false,
-          readAssetDependenciesFromPackageJson: true,
-          omitUnchangedInstalledFilesOnUpload: true,
-        },
-      },
-    },
-  )
-
-  const pkg = JSON.parse(await fs.readFile(path.join(tempDir, 'package.json'), 'utf-8')) as {
-    assetDependencies: Record<string, string>
-  }
-  assert.deepEqual(pkg.assetDependencies, { chair: '^1.2.0' })
-})
-
-test('install skips existing changed files unless force is set', async () => {
-  const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'market-conflict-'))
-  await fs.mkdir(path.join(tempDir, 'public', 'model'), { recursive: true })
-  await fs.writeFile(path.join(tempDir, 'package.json'), '{}\n')
-  await fs.writeFile(path.join(tempDir, 'public', 'model', 'chair.glb'), 'local edit')
-
-  const resolution = {
-    assets: [
-      {
-        name: 'chair',
-        type: 'model',
-        version: '1.0.0',
-        description: null,
-        npmDependencies: {},
-        assetDependencies: {},
-        skillDependencies: {},
-      },
-    ],
-    npmDependencies: {},
-    skillDependencies: {},
-  }
-
-  const skipped = await install(
-    clientWithZip({
-      'public/model/chair.glb': textEncoder.encode('market bytes'),
-    }),
-    resolution,
-    { cwd: tempDir },
-  )
-
-  assert.equal(await fs.readFile(path.join(tempDir, 'public', 'model', 'chair.glb'), 'utf-8'), 'local edit')
-  assert.match(skipped.warnings[0], /Skipped public\/model\/chair\.glb/u)
-  assert.deepEqual(skipped.assets[0].files, [])
-
-  const forced = await install(
-    clientWithZip({
-      'public/model/chair.glb': textEncoder.encode('market bytes'),
-    }),
-    resolution,
-    { cwd: tempDir, force: true },
-  )
-
-  assert.equal(
-    await fs.readFile(path.join(tempDir, 'public', 'model', 'chair.glb'), 'utf-8'),
-    'market bytes',
-  )
-  assert.deepEqual(forced.warnings, [])
-  assert.deepEqual(forced.assets[0].files, ['public/model/chair.glb'])
-})
-
-test('findInstallRoot uses the nearest package.json, not the monorepo root', async () => {
-  const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'market-root-'))
-  const repoRoot = path.join(tempDir, 'repo')
-  const appRoot = path.join(repoRoot, 'packages', 'app')
-  const cwd = path.join(appRoot, 'src', 'routes')
-  await fs.mkdir(path.join(appRoot, 'public'), { recursive: true })
-  await fs.mkdir(cwd, { recursive: true })
-  await fs.writeFile(path.join(repoRoot, 'package.json'), '{}\n')
-  await fs.writeFile(path.join(appRoot, 'package.json'), '{}\n')
-
-  assert.equal(await findInstallRoot(cwd), appRoot)
-})
-
-test('findInstallRoot falls back to cwd when no package.json exists', async () => {
-  const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'market-root-'))
-  const cwd = path.join(tempDir, 'repo', 'src')
-  await fs.mkdir(cwd, { recursive: true })
-
-  assert.equal(await findInstallRoot(cwd), cwd)
-})
-
-function clientWithZip(files: Record<string, Uint8Array>) {
-  return {
-    asset: {
-      downloadZip: async () => new Blob([zipSync(files)]),
-    },
-  } as never
-}
-
-async function exists(file: string): Promise<boolean> {
-  try {
-    await fs.stat(file)
-    return true
-  } catch {
-    return false
-  }
-}

package/tests/list-command.test.ts

@@ -1,76 +0,0 @@
-import assert from 'node:assert/strict'
-import * as fs from 'node:fs/promises'
-import * as os from 'node:os'
-import * as path from 'node:path'
-import test from 'node:test'
-import { listInstalledAssets } from '../src/commands/list.js'
-import { MARKET_LOCK_PATH } from '../src/market-lock.js'
-
-test('listInstalledAssets reads the nearest project lockfile', async () => {
-  const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'market-list-'))
-  const appRoot = path.join(tempDir, 'app')
-  const cwd = path.join(appRoot, 'src', 'feature')
-  await fs.mkdir(path.join(appRoot, '.drawcall'), { recursive: true })
-  await fs.mkdir(cwd, { recursive: true })
-  await fs.writeFile(path.join(appRoot, 'package.json'), '{}\n')
-  await fs.writeFile(
-    path.join(appRoot, MARKET_LOCK_PATH),
-    JSON.stringify(
-      {
-        version: 1,
-        assets: {
-          'wooden-chair': {
-            version: '1.2.0',
-            type: 'model',
-            files: {
-              'public/models/wooden-chair.glb': { sha256: 'abc' },
-            },
-          },
-          'forest-sky': {
-            version: '1.0.0',
-            type: 'environment',
-            files: {
-              'public/environment/forest-sky.hdr': { sha256: 'def' },
-              'public/environment/forest-sky-background.webp': { sha256: 'ghi' },
-            },
-          },
-        },
-      },
-      null,
-      2,
-    ) + '\n',
-  )
-
-  assert.deepEqual(await listInstalledAssets(cwd), {
-    projectRoot: appRoot,
-    lockPath: path.join(appRoot, MARKET_LOCK_PATH),
-    assets: [
-      {
-        name: 'forest-sky',
-        version: '1.0.0',
-        type: 'environment',
-        files: [
-          'public/environment/forest-sky-background.webp',
-          'public/environment/forest-sky.hdr',
-        ],
-      },
-      {
-        name: 'wooden-chair',
-        version: '1.2.0',
-        type: 'model',
-        files: ['public/models/wooden-chair.glb'],
-      },
-    ],
-  })
-})
-
-test('listInstalledAssets returns an empty inventory when no lockfile exists', async () => {
-  const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'market-list-empty-'))
-  await fs.writeFile(path.join(tempDir, 'package.json'), '{}\n')
-
-  assert.deepEqual(await listInstalledAssets(tempDir), {
-    projectRoot: tempDir,
-    lockPath: path.join(tempDir, MARKET_LOCK_PATH),
-    assets: [],
-  })
-})

package/tests/output.test.ts

@@ -1,235 +0,0 @@
-import assert from 'node:assert/strict'
-import test from 'node:test'
-import { assetSearchResultLine, installResult, listResult } from '../src/output.js'
-
-test('assetSearchResultLine prints the full description', () => {
-  const description =
-    'A detailed model description that is intentionally longer than the old one-line search cap, with material notes, scale guidance, and usage context.'
-
-  assert.equal(
-    assetSearchResultLine({
-      id: 'asset-1',
-      name: 'wooden-chair',
-      type: 'model',
-      description,
-      ownerId: 'user-1',
-      createdAt: new Date('2026-01-01T00:00:00.000Z'),
-      updatedAt: new Date('2026-01-01T00:00:00.000Z'),
-      latestVersion: '1.2.0',
-      approved: true,
-      npmDependencies: '{}',
-      assetDependencies: '{}',
-      skillDependencies: '{}',
-      previewUrl: null,
-    }),
-    `- wooden-chair@1.2.0 | model | approved | ${description}`,
-  )
-})
-
-test('installResult prints asset type, file tree, and npm list', () => {
-  assert.equal(
-    installResult({
-      assets: [
-        {
-          name: 'wooden-chair',
-          type: 'model',
-          version: '1.2.0',
-          description: null,
-          files: ['public/models/wooden-chair.glb'],
-        },
-        {
-          name: 'oak-material',
-          type: 'texture',
-          version: '1.0.0',
-          description: null,
-          files: ['public/textures/oak/basecolor.png', 'public/textures/oak/normal.png'],
-        },
-      ],
-      npmDependencies: { '@react-three/drei': 'latest' },
-      skillDependencies: {},
-      warnings: [],
-    }),
-    `Installed:
-- wooden-chair@1.2.0 (model)
-  files:
-    public
-    └─ models
-       └─ wooden-chair.glb
-- oak-material@1.0.0 (texture)
-  files:
-    public
-    └─ textures
-       └─ oak
-          ├─ basecolor.png
-          └─ normal.png
-- @react-three/drei@latest (npm)`,
-  )
-})
-
-test('installResult attaches each post-install note under its asset', () => {
-  assert.equal(
-    installResult(
-      {
-        assets: [
-          {
-            name: 'wooden-chair',
-            type: 'model',
-            version: '1.2.0',
-            description: null,
-            files: [],
-          },
-          {
-            name: 'beep',
-            type: 'sound-effect',
-            version: '1.0.0',
-            description: null,
-            files: [],
-          },
-        ],
-        npmDependencies: {},
-        skillDependencies: {},
-        warnings: [],
-      },
-      {
-        model: {
-          installMessage: 'Load the model.',
-          saveOnInstall: true,
-          readAssetDependenciesFromPackageJson: false,
-          omitUnchangedInstalledFilesOnUpload: false,
-        },
-        // sound-effect intentionally omitted -> no note for `beep`.
-      },
-    ),
-    `Installed:
-- wooden-chair@1.2.0 (model)
-  note: Load the model.
-- beep@1.0.0 (sound-effect)`,
-  )
-})
-
-test('installResult word-wraps a long note with a hanging indent', () => {
-  const message = Array(20).fill('word').join(' ')
-  const output = installResult(
-    {
-      assets: [{ name: 'thing', type: 'model', version: '1.0.0', description: null, files: [] }],
-      npmDependencies: {},
-      skillDependencies: {},
-      warnings: [],
-    },
-    {
-      model: {
-        installMessage: message,
-        saveOnInstall: true,
-        readAssetDependenciesFromPackageJson: false,
-        omitUnchangedInstalledFilesOnUpload: false,
-      },
-    },
-  )
-
-  assert.equal(
-    output,
-    `Installed:
-- thing@1.0.0 (model)
-  note: ${Array(13).fill('word').join(' ')}
-        ${Array(7).fill('word').join(' ')}`,
-  )
-})
-
-test('installResult lists installed skills with their source', () => {
-  assert.equal(
-    installResult({
-      assets: [
-        {
-          name: 'wooden-chair',
-          type: 'model',
-          version: '1.2.0',
-          description: null,
-          files: [],
-        },
-      ],
-      npmDependencies: {},
-      skillDependencies: {
-        'web-design-guidelines': 'vercel-labs/agent-skills/tree/main/skills/web-design-guidelines',
-        'local-skill': '/abs/public/skills/local-skill',
-      },
-      warnings: [],
-    }),
-    `Installed:
-- wooden-chair@1.2.0 (model)
-- local-skill ← /abs/public/skills/local-skill (skill)
-- web-design-guidelines ← vercel-labs/agent-skills/tree/main/skills/web-design-guidelines (skill)`,
-  )
-})
-
-test('installResult shows each installed asset description', () => {
-  assert.equal(
-    installResult({
-      assets: [
-        {
-          name: 'wooden-chair',
-          type: 'model',
-          version: '1.2.0',
-          description:
-            'A game-ready chair with baked texture detail and clean origin placement for room scenes.',
-          files: [],
-        },
-      ],
-      npmDependencies: {},
-      skillDependencies: {},
-      warnings: [],
-    }),
-    `Installed:
-- wooden-chair@1.2.0 (model)
-  description: A game-ready chair with baked texture detail and clean origin
-               placement for room scenes.`,
-  )
-})
-
-test('listResult prints installed assets with file trees', () => {
-  assert.equal(
-    listResult({
-      projectRoot: '/project',
-      lockPath: '/project/.drawcall/market-lock.json',
-      assets: [
-        {
-          name: 'wooden-chair',
-          type: 'model',
-          version: '1.2.0',
-          files: ['public/models/wooden-chair.glb'],
-        },
-        {
-          name: 'forest-sky',
-          type: 'environment',
-          version: '1.0.0',
-          files: [
-            'public/environment/forest-sky-background.webp',
-            'public/environment/forest-sky.hdr',
-          ],
-        },
-      ],
-    }),
-    `Installed assets: 2
-- wooden-chair@1.2.0 (model)
-  files:
-    public
-    └─ models
-       └─ wooden-chair.glb
-- forest-sky@1.0.0 (environment)
-  files:
-    public
-    └─ environment
-       ├─ forest-sky-background.webp
-       └─ forest-sky.hdr`,
-  )
-})
-
-test('listResult handles an empty inventory', () => {
-  assert.equal(
-    listResult({
-      projectRoot: '/project',
-      lockPath: '/project/.drawcall/market-lock.json',
-      assets: [],
-    }),
-    'No installed assets found.',
-  )
-})

package/tests/resolve-skills.test.ts

@@ -1,87 +0,0 @@
-import assert from 'node:assert/strict'
-import test from 'node:test'
-import { resolve, ResolutionError } from '../src/resolve.js'
-
-interface FakeAsset {
-  latestVersion: string
-  approved?: boolean
-  npmDependencies?: Record<string, string>
-  assetDependencies?: Record<string, string>
-  skillDependencies?: Record<string, string>
-}
-
-function clientWith(assets: Record<string, FakeAsset>) {
-  return {
-    exact: async ({ name }: { name: string }) => {
-      const asset = assets[name]
-      if (!asset) return null
-      return {
-        name,
-        latestVersion: asset.latestVersion,
-        approved: asset.approved ?? true,
-        npmDependencies: JSON.stringify(asset.npmDependencies ?? {}),
-        assetDependencies: JSON.stringify(asset.assetDependencies ?? {}),
-        skillDependencies: JSON.stringify(asset.skillDependencies ?? {}),
-      }
-    },
-  } as never
-}
-
-test('resolve collects skill dependencies across transitive assets', async () => {
-  const client = clientWith({
-    root: {
-      latestVersion: '1.0.0',
-      assetDependencies: { dep: '*' },
-      skillDependencies: { 'web-design-guidelines': 'vercel-labs/agent-skills' },
-    },
-    dep: {
-      latestVersion: '2.0.0',
-      skillDependencies: { 'local-skill': './public/skills/local-skill' },
-    },
-  })
-
-  const result = await resolve(client, [{ name: 'root', range: '*' }])
-
-  assert.deepEqual(result.skillDependencies, {
-    'web-design-guidelines': 'vercel-labs/agent-skills',
-    'local-skill': './public/skills/local-skill',
-  })
-})
-
-test('resolve unions identical skill sources without complaint', async () => {
-  const client = clientWith({
-    root: {
-      latestVersion: '1.0.0',
-      assetDependencies: { dep: '*' },
-      skillDependencies: { shared: 'vercel-labs/agent-skills' },
-    },
-    dep: {
-      latestVersion: '1.0.0',
-      skillDependencies: { shared: 'vercel-labs/agent-skills' },
-    },
-  })
-
-  const result = await resolve(client, [{ name: 'root', range: '*' }])
-
-  assert.deepEqual(result.skillDependencies, { shared: 'vercel-labs/agent-skills' })
-})
-
-test('resolve rejects the same skill label with conflicting sources', async () => {
-  const client = clientWith({
-    root: {
-      latestVersion: '1.0.0',
-      assetDependencies: { dep: '*' },
-      skillDependencies: { shared: 'vercel-labs/agent-skills' },
-    },
-    dep: {
-      latestVersion: '1.0.0',
-      skillDependencies: { shared: 'other-org/other-skills' },
-    },
-  })
-
-  await assert.rejects(
-    resolve(client, [{ name: 'root', range: '*' }]),
-    (err: unknown) =>
-      err instanceof ResolutionError && /skill dependency conflict for "shared"/u.test(err.message),
-  )
-})

package/tests/upload-deps.test.ts

@@ -1,63 +0,0 @@
-import assert from 'node:assert/strict'
-import test from 'node:test'
-import {
-  parseSkillDeps,
-  parseUploadDescription,
-  parseVersionedDeps,
-} from '../src/commands/upload.js'
-import { MAX_ASSET_DESCRIPTION_LENGTH } from '../src/schemas.js'
-
-test('parseVersionedDeps parses name@range and defaults a missing range to *', () => {
-  assert.deepEqual(parseVersionedDeps(['three@^0.178.0', 'gsap'], 'npm'), {
-    three: '^0.178.0',
-    gsap: '*',
-  })
-})
-
-test('parseVersionedDeps keeps the scope marker on scoped npm packages', () => {
-  assert.deepEqual(parseVersionedDeps(['@react-three/drei@^9.0.0', '@types/node'], 'npm'), {
-    '@react-three/drei': '^9.0.0',
-    '@types/node': '*',
-  })
-})
-
-test('parseVersionedDeps rejects duplicates', () => {
-  assert.throws(
-    () => parseVersionedDeps(['three@^1', 'three@^2'], 'npm'),
-    /Duplicate npm dependency/u,
-  )
-})
-
-test('parseSkillDeps splits label=source on the first = only', () => {
-  assert.deepEqual(
-    parseSkillDeps([
-      'web-design=vercel-labs/agent-skills/tree/main/skills/web-design-guidelines',
-      'local=./public/skills/local',
-    ]),
-    {
-      'web-design': 'vercel-labs/agent-skills/tree/main/skills/web-design-guidelines',
-      local: './public/skills/local',
-    },
-  )
-})
-
-test('parseSkillDeps rejects specs without a usable label=source', () => {
-  assert.throws(() => parseSkillDeps(['no-separator']), /Use label=source/u)
-  assert.throws(() => parseSkillDeps(['=missing-label']), /Use label=source/u)
-  assert.throws(() => parseSkillDeps(['missing-source=']), /Use label=source/u)
-})
-
-test('parseSkillDeps rejects duplicate labels', () => {
-  assert.throws(() => parseSkillDeps(['a=one', 'a=two']), /Duplicate skill dependency "a"/u)
-})
-
-test('parseUploadDescription rejects descriptions beyond the shared max length', () => {
-  assert.equal(
-    parseUploadDescription('A compact asset description.'),
-    'A compact asset description.',
-  )
-  assert.throws(
-    () => parseUploadDescription('x'.repeat(MAX_ASSET_DESCRIPTION_LENGTH + 1)),
-    /1000 characters or fewer/u,
-  )
-})

package/tsconfig.json

@@ -1,9 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "outDir": "dist",
-    "rootDir": "src",
-    "types": ["node"]
-  },
-  "include": ["src"]
-}