@drawcall/market 0.1.26 → 0.1.27

package/dist/skill.js

@@ -5,36 +5,40 @@ description: Find, preview, install, generate, and publish Drawcall Market asset
 
 # Drawcall Market
 
-Use the \`market\` CLI. Keep commands short and read the summary line plus asset bullets.
+Use the \`market\` CLI. Keep commands short and read the summary lines.
 
 ## Quick Start
 
 \`\`\`sh
 market search "wooden chair" --type model --limit 3
-market install wooden-chair --type model --cwd "$PWD"
+market install wooden-chair --cwd "$PWD"
 market preview wooden-chair --out /tmp/wooden-chair.png
 \`\`\`
 
 ## Workflow
 
-1. Search first unless the user gave an exact asset name.
-2. Search requires \`--type\`; use \`model\` unless the user names another supported type: \`humanoid-model\`, \`texture\`, \`humanoid-animation\`, \`template\`, \`sound-effect\`, \`background-music\`, or \`environment\`.
-3. Use \`--limit 1\` for lookup, \`--limit 3\` for choice. Search caps at 5.
-4. Use \`--verbose\` only when the one-line descriptions are not enough.
+1. 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\`, or \`environment\`.
+2. Use \`--limit 1\` for lookup, \`--limit 3\` for choice. Search caps at 5. Add \`--verbose\` only when the one-line descriptions are not enough.
+3. \`install\` takes one or more exact asset names (optionally \`name@range\`); it does not search or generate. Find names with \`search\` first. No \`--type\` is needed — asset names are unique.
+4. \`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.
 5. Use \`--unapproved\` only when the user asks for unapproved/private/admin assets. Do not install unapproved assets without explicit acceptance.
-6. Preview before installing when visual fit matters: \`market preview <name> --out <file>\`. Preview is not supported for \`humanoid-animation\`, \`template\`, \`sound-effect\`, or \`background-music\`.
-7. Generate only when the user wants a new asset, auth is available, and the requested asset type supports generation. No asset type currently supports generation.
-8. Upload only when publishing is requested.
-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.
+6. \`generate --type <type> "<prompt>"\` creates a new asset; it requires login and a type that supports generation. No asset type currently supports generation.
+7. Upload only when publishing is requested: \`market upload <name> <zip> "<description>" --type <type>\`.
+8. 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.
 
 ## Output
 
-Commands print concise summaries:
+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 1 asset: wooden-chair@1.0.0
+Installed:
+- wooden-chair@1.0.0 (asset)
+  files:
+    public/model
+    └─ wooden-chair.glb
+- three@^0.178.0 (npm)
 Saved preview for wooden-chair@1.0.0: /tmp/wooden-chair.png
 \`\`\`
 

package/dist/skill.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill.js","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyC1B,CAAA"}
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6C1B,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drawcall/market",
-  "version": "0.1.26",
+  "version": "0.1.27",
   "repository": {
     "type": "git",
     "url": "https://github.com/drawcall-ai/market",

package/src/cli.ts

@@ -56,7 +56,10 @@ program
     const client = createMarketClient({ baseUrl, authToken: token })
     const profile = await client.user.getProfile()
     if (!profile) throw new Error('The Market API did not accept the auth token.')
-    await saveConfig({ authToken: token, baseUrl })
+    // Only pin baseUrl in config when the user explicitly chose one. Persisting
+    // the default would freeze logged-in users to a host the CLI can no longer
+    // change in a future release.
+    await saveConfig(opts.api ? { authToken: token, baseUrl: opts.api } : { authToken: token })
     console.log(loginResult(profile.email, getConfigPath()))
   })
 
@@ -69,25 +72,18 @@ program
 
 program
   .command('install')
-  .description('Install by name or prompt')
-  .argument('<assets...>', 'Names or prompts')
-  .addOption(typeOption)
+  .description('Install assets by name')
+  .argument('<assets...>', 'Asset names, optionally with @range')
   .addOption(apiOption)
   .option('--unapproved', 'Include unapproved versions', false)
   .option('--cwd <dir>', 'Project directory')
-  .action(
-    async (
-      args: string[],
-      opts: { type?: AssetType; api?: string; unapproved: boolean; cwd?: string },
-    ) => {
-      await installCommand(args, {
-        type: opts.type,
-        baseUrl: opts.api,
-        unapproved: opts.unapproved,
-        cwd: opts.cwd,
-      })
-    },
-  )
+  .action(async (args: string[], opts: { api?: string; unapproved: boolean; cwd?: string }) => {
+    await installCommand(args, {
+      baseUrl: opts.api,
+      unapproved: opts.unapproved,
+      cwd: opts.cwd,
+    })
+  })
 
 program
   .command('search')
@@ -109,12 +105,7 @@ program
         verbose: boolean
       },
     ) => {
-      if (!opts.type) {
-        console.error(
-          errorResult(`Search requires --type. Available types: ${ASSET_TYPES.join(', ')}`),
-        )
-        process.exit(1)
-      }
+      requireType(opts.type, 'Search')
       await searchCommand(query, {
         type: opts.type,
         baseUrl: opts.api,
@@ -142,12 +133,7 @@ program
       description: string,
       opts: { type?: AssetType; api?: string; version?: string; cwd?: string },
     ) => {
-      if (!opts.type) {
-        console.error(
-          errorResult(`Upload requires --type. Available types: ${ASSET_TYPES.join(', ')}`),
-        )
-        process.exit(1)
-      }
+      requireType(opts.type, 'Upload')
       await uploadCommand(name, zipFilter, description, {
         type: opts.type,
         version: opts.version,
@@ -162,7 +148,6 @@ program
   .description('Save preview image')
   .argument('<name>', 'Asset name')
   .argument('[version]', 'Semver version')
-  .addOption(typeOption)
   .addOption(apiOption)
   .option('--unapproved', 'Include unapproved versions', false)
   .option('--out <file>', 'Output image path')
@@ -170,10 +155,9 @@ program
     async (
       name: string,
       version: string | undefined,
-      opts: { type?: AssetType; api?: string; unapproved: boolean; out?: string },
+      opts: { api?: string; unapproved: boolean; out?: string },
     ) => {
       await previewCommand(name, version, {
-        type: opts.type,
         baseUrl: opts.api,
         unapproved: opts.unapproved,
         out: opts.out,
@@ -189,6 +173,7 @@ program
   .addOption(apiOption)
   .option('--cwd <dir>', 'Project directory')
   .action(async (description: string, opts: { type?: AssetType; api?: string; cwd?: string }) => {
+    requireType(opts.type, 'Generate')
     await generateCommand(description, {
       type: opts.type,
       baseUrl: opts.api,
@@ -207,6 +192,15 @@ program.parseAsync().catch((err) => {
   process.exit(1)
 })
 
+function requireType(type: AssetType | undefined, command: string): asserts type is AssetType {
+  if (!type) {
+    console.error(
+      errorResult(`${command} requires --type. Available types: ${ASSET_TYPES.join(', ')}`),
+    )
+    process.exit(1)
+  }
+}
+
 function parseSearchLimit(value: string): number {
   const parsed = Number.parseInt(value, 10)
   if (!Number.isInteger(parsed) || parsed < 1) {

package/src/commands/install.ts

@@ -1,14 +1,12 @@
-import ora, { type Ora } from 'ora'
+import ora from 'ora'
 import { resolve } from '../resolve.js'
 import { install as runInstall } from '../install.js'
-import { generateAndWait } from '../generate.js'
-import { assetNameSchema, type AssetType } from '../schemas.js'
+import { assetNameSchema } from '../schemas.js'
 import { getCliClient } from '../cli-client.js'
-import { compact, generatedInstallResult, installResult } from '../output.js'
+import { installResult } from '../output.js'
 import type { MarketClient } from '../client.js'
 
 export interface InstallCommandOptions {
-  type?: AssetType
   unapproved?: boolean
   cwd?: string
   baseUrl?: string
@@ -20,8 +18,8 @@ interface AssetRequest {
 }
 
 export async function installCommand(args: string[], opts: InstallCommandOptions): Promise<void> {
-  const { client, authToken } = await getCliClient({ baseUrl: opts.baseUrl })
-  const canGenerate = Boolean(authToken)
+  const { client } = await getCliClient({ baseUrl: opts.baseUrl })
+  const includeUnapproved = opts.unapproved ?? false
 
   const spinner = ora({
     isEnabled: Boolean(process.stderr.isTTY),
@@ -31,15 +29,11 @@ export async function installCommand(args: string[], opts: InstallCommandOptions
     const requests: AssetRequest[] = []
     for (const arg of args) {
       spinner.text = `Resolving "${truncate(arg, 40)}"`
-      requests.push(
-        await resolveArg(client, arg, opts.type, spinner, canGenerate, opts.unapproved ?? false),
-      )
+      requests.push(await resolveArg(client, arg, includeUnapproved))
     }
 
     spinner.text = 'Resolving dependency tree'
-    const resolution = await resolve(client.asset, requests, {
-      includeUnapproved: opts.unapproved ?? false,
-    })
+    const resolution = await resolve(client.asset, requests, { includeUnapproved })
 
     const result = await runInstall(client, resolution, {
       cwd: opts.cwd,
@@ -56,82 +50,41 @@ export async function installCommand(args: string[], opts: InstallCommandOptions
   }
 }
 
+/**
+ * Resolve a single `name` or `name@range` argument to an exact asset request.
+ * Asset names are globally unique, so the name fully determines the asset — no
+ * `--type` is needed. install never fuzzy-searches or generates: it points the
+ * caller at `market search` / `market generate` instead, which keeps behavior
+ * predictable for agents.
+ */
 export async function resolveArg(
   client: MarketClient,
   arg: string,
-  type: AssetType | undefined,
-  spinner: Ora,
-  canGenerate: boolean,
   includeUnapproved: boolean,
 ): Promise<AssetRequest> {
   const parsed = parseNameAndRange(arg)
-  if (parsed) {
-    const existing = await client.asset.exact({
-      name: parsed.name,
-      type,
-      includeUnapproved,
-    })
-    if (existing) return parsed
-
-    if (!includeUnapproved) {
-      const hidden = await client.asset.exact({
-        name: parsed.name,
-        type,
-        includeUnapproved: true,
-      })
-      if (hidden) {
-        throw new Error(
-          `Asset "${parsed.name}" exists but has no approved versions. Re-run with \`--unapproved\` if you have access.`,
-        )
-      }
-    }
-
-    if (arg.includes('@')) {
-      return parsed
-    }
+  if (!parsed) {
+    throw new Error(
+      `Invalid asset name "${arg}". Use \`market search --type <type> <query>\` to find assets.`,
+    )
   }
 
-  spinner.text = `Searching "${truncate(arg, 40)}"`
-  const results = await client.asset.search({
-    query: arg,
-    type,
-    includeUnapproved,
-    limit: 1,
-    page: 1,
-    sort: 'relevance',
-  })
-  if (results.items.length > 0) {
-    const hit = results.items[0]
-    if (process.stderr.isTTY) {
-      spinner.info(`Matched "${compact(arg, 48)}" to ${hit.name} (${hit.type})`)
-      spinner.start()
-    }
-    return { name: hit.name, range: '*' }
-  }
+  const existing = await client.asset.exact({ name: parsed.name, includeUnapproved })
+  if (existing) return parsed
 
-  if (!canGenerate) {
-    throw new Error(
-      `No matches for "${arg}". Run \`market login\` to enable auto-generation of missing assets.`,
-    )
+  if (!includeUnapproved) {
+    const hidden = await client.asset.exact({ name: parsed.name, includeUnapproved: true })
+    if (hidden) {
+      throw new Error(
+        `Asset "${parsed.name}" exists but has no approved versions. Re-run with \`--unapproved\` if you have access.`,
+      )
+    }
   }
 
-  spinner.text = `No matches; generating "${truncate(arg, 40)}"`
-  const generated = await generateAndWait(
-    client,
-    { description: arg, type },
-    {
-      onProgress: (msg) => {
-        spinner.text = msg
-      },
-    },
+  throw new Error(
+    `Asset "${parsed.name}" not found. Use \`market search\` to find assets or ` +
+      `\`market generate --type <type>\` to create one.`,
   )
-  if (process.stderr.isTTY) {
-    spinner.info(
-      `${generatedInstallResult(generated.assetName, generated.version)} for "${compact(arg, 48)}"`,
-    )
-    spinner.start()
-  }
-  return { name: generated.assetName, range: generated.version }
 }
 
 function parseNameAndRange(arg: string): AssetRequest | null {

package/src/commands/preview.ts

@@ -3,10 +3,9 @@ import * as path from 'path'
 import ora from 'ora'
 import { getCliClient } from '../cli-client.js'
 import { previewResult } from '../output.js'
-import { assetNameSchema, semverSchema, type AssetType } from '../schemas.js'
+import { assetNameSchema, semverSchema } from '../schemas.js'
 
 export interface PreviewCommandOptions {
-  type?: AssetType
   unapproved?: boolean
   out?: string
   baseUrl?: string
@@ -19,13 +18,10 @@ export async function previewCommand(
 ): Promise<void> {
   const parsedName = assetNameSchema.parse(name)
   const parsedVersion = version ? semverSchema.parse(version) : undefined
-  if (
-    opts.type === 'humanoid-animation' ||
-    opts.type === 'template' ||
-    opts.type === 'sound-effect'
-  ) {
-    throw new Error(`Preview images are not supported for ${opts.type}`)
-  }
+  // The asset name is globally unique, so the server resolves the type. Whether
+  // that type supports preview images is also a server concern: the API checks
+  // for a provider `downloadPreviewImage` capability and returns a clear,
+  // type-specific error rather than us mirroring a list that can drift.
 
   const spinner = ora({
     text: `Resolving preview for ${parsedName}`,
@@ -40,7 +36,6 @@ export async function previewCommand(
       (
         await client.asset.exact({
           name: parsedName,
-          type: opts.type,
           includeUnapproved: opts.unapproved ?? false,
         })
       )?.latestVersion

package/src/config.ts

@@ -41,8 +41,14 @@ export async function loadConfig(): Promise<Config | null> {
 export async function saveConfig(config: Config): Promise<void> {
   const dir = configDir()
   await fs.mkdir(dir, { recursive: true })
+  // `mode` on writeFile/mkdir only applies when the path is created, so chmod
+  // explicitly to protect a pre-existing (possibly world-readable) token file
+  // and its directory. A chmod failure means we could not secure the token, so
+  // let it surface rather than silently leaving it exposed.
+  await fs.chmod(dir, 0o700)
   const file = configPath()
   await fs.writeFile(file, JSON.stringify(config, null, 2) + '\n', { mode: 0o600 })
+  await fs.chmod(file, 0o600)
 }
 
 export async function clearConfig(): Promise<boolean> {

package/src/install.ts

@@ -147,19 +147,18 @@ async function installNpmDeps(
   if (Object.keys(deps).length === 0) return
 
   const pkgPath = path.join(projectRoot, 'package.json')
-  let pkg: PackageJson
-  try {
-    pkg = JSON.parse(await fs.readFile(pkgPath, 'utf-8')) as PackageJson
-  } catch {
-    pkg = { name: 'my-project', private: true, dependencies: {} }
-  }
+  // Only synthesize a package.json when none exists. A malformed existing file
+  // is a real error that must surface — never silently overwrite it.
+  const pkg: PackageJson = (await isFile(pkgPath))
+    ? (JSON.parse(await fs.readFile(pkgPath, 'utf-8')) as PackageJson)
+    : { name: 'my-project', private: true, dependencies: {} }
 
   pkg.dependencies = { ...pkg.dependencies, ...deps }
   await fs.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + '\n')
 
   log(`Installing npm dependencies: ${Object.keys(deps).join(', ')}`)
 
-  const pm = await detectPackageManager(projectRoot).catch(() => null)
+  const pm = await detectPackageManager(projectRoot)
   const pmName = pm?.name ?? 'npm'
 
   log(`Using ${pmName}...`)

package/src/resolve.ts

@@ -2,9 +2,10 @@
  * Dependency resolver for market assets.
  *
  * 1. Collects the target assets and all transitive asset dependencies.
- * 2. For each asset, finds a version that satisfies ALL constraints from
- *    every dependent.
- * 3. Merges npm dependency ranges across all resolved assets and checks
+ * 2. For each asset, takes the latest published version and verifies it
+ *    satisfies ALL constraints from every dependent. (Only the latest
+ *    version is resolved; older versions are not considered.)
+ * 3. Intersects npm dependency ranges across all resolved assets and checks
  *    that they are compatible.
  */
 
@@ -58,24 +59,26 @@ export async function resolve(
       }
 
       if (!opts.includeUnapproved && !meta.approved) {
-        throw new ResolutionError(
-          `Asset "${assetName}" has no ${opts.includeUnapproved ? '' : 'approved '}versions.`,
-        )
+        throw new ResolutionError(`Asset "${assetName}" has no approved versions.`)
       }
 
+      // The market publishes immutable versions and resolution targets the
+      // latest published version of each asset. A range that excludes the
+      // latest version is therefore unsatisfiable (older versions are not
+      // resolved), which this message makes explicit.
       const assetConstraints = constraints.get(assetName) ?? []
       if (!assetConstraints.every((c) => semver.satisfies(meta.latestVersion, c.range))) {
         const constraintDesc = assetConstraints
           .map((c) => `  ${c.range} (from ${c.from})`)
           .join('\n')
         throw new ResolutionError(
-          `No version of "${assetName}" satisfies all constraints:\n${constraintDesc}\n` +
-            `Available${opts.includeUnapproved ? '' : ' approved'}: ${meta.latestVersion}`,
+          `The latest${opts.includeUnapproved ? '' : ' approved'} version of "${assetName}" ` +
+            `(${meta.latestVersion}) does not satisfy all constraints:\n${constraintDesc}`,
         )
       }
 
-      const npmDeps: Record<string, string> = JSON.parse(meta.npmDependencies)
-      const assetDeps: Record<string, string> = JSON.parse(meta.assetDependencies)
+      const npmDeps = parseDependencies(meta.npmDependencies, assetName, 'npm')
+      const assetDeps = parseDependencies(meta.assetDependencies, assetName, 'asset')
 
       resolved.set(assetName, {
         name: assetName,
@@ -115,6 +118,22 @@ export async function resolve(
   }
 }
 
+function parseDependencies(
+  value: string,
+  assetName: string,
+  kind: 'npm' | 'asset',
+): Record<string, string> {
+  try {
+    const parsed = JSON.parse(value || '{}') as unknown
+    if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+      return parsed as Record<string, string>
+    }
+  } catch {
+    // fall through to a clear error below
+  }
+  throw new ResolutionError(`Asset "${assetName}" has malformed ${kind} dependency metadata.`)
+}
+
 function addConstraint(
   constraints: Map<string, { range: string; from: string }[]>,
   name: string,
@@ -151,7 +170,8 @@ async function fetchMeta(
 /**
  * Merge npm dependency ranges from all resolved assets.
  * For each package, check that all declared ranges are compatible
- * (using semver.intersects). Return the narrowest range.
+ * (using semver.intersects), then return the single declared range that is a
+ * subset of every other — the true intersection.
  */
 function mergeNpmDependencies(assets: ResolvedAsset[]): Record<string, string> {
   // Collect all ranges per package
@@ -181,18 +201,23 @@ function mergeNpmDependencies(assets: ResolvedAsset[]): Record<string, string> {
       }
     }
 
-    // Use the narrowest (most constrained) range.
-    // Simple heuristic: pick the range with the highest minimum version.
-    let narrowest = ranges[0].range
-    for (const r of ranges.slice(1)) {
-      const minCurrent = semver.minVersion(narrowest)
-      const minNew = semver.minVersion(r.range)
-      if (minCurrent && minNew && semver.gt(minNew, minCurrent)) {
-        narrowest = r.range
-      }
+    // Use the single declared range that is contained in every other declared
+    // range — the true intersection of all constraints. Picking by "highest
+    // minimum version" is unsound: a range with a higher minimum can also have
+    // a higher (or open) upper bound, silently dropping another dependent's
+    // upper bound. If no single range represents the intersection, it cannot be
+    // expressed as one package.json range, so fail loudly.
+    const narrowest = ranges.find((candidate) =>
+      ranges.every((other) => semver.subset(candidate.range, other.range)),
+    )
+    if (!narrowest) {
+      throw new ResolutionError(
+        `npm dependency ranges for "${pkg}" overlap but cannot be combined into a single range:\n` +
+          ranges.map((r) => `  ${r.range} (from ${r.from})`).join('\n'),
+      )
     }
 
-    merged[pkg] = narrowest
+    merged[pkg] = narrowest.range
   }
 
   return merged

package/src/skill.ts

@@ -5,36 +5,40 @@ description: Find, preview, install, generate, and publish Drawcall Market asset
 
 # Drawcall Market
 
-Use the \`market\` CLI. Keep commands short and read the summary line plus asset bullets.
+Use the \`market\` CLI. Keep commands short and read the summary lines.
 
 ## Quick Start
 
 \`\`\`sh
 market search "wooden chair" --type model --limit 3
-market install wooden-chair --type model --cwd "$PWD"
+market install wooden-chair --cwd "$PWD"
 market preview wooden-chair --out /tmp/wooden-chair.png
 \`\`\`
 
 ## Workflow
 
-1. Search first unless the user gave an exact asset name.
-2. Search requires \`--type\`; use \`model\` unless the user names another supported type: \`humanoid-model\`, \`texture\`, \`humanoid-animation\`, \`template\`, \`sound-effect\`, \`background-music\`, or \`environment\`.
-3. Use \`--limit 1\` for lookup, \`--limit 3\` for choice. Search caps at 5.
-4. Use \`--verbose\` only when the one-line descriptions are not enough.
+1. 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\`, or \`environment\`.
+2. Use \`--limit 1\` for lookup, \`--limit 3\` for choice. Search caps at 5. Add \`--verbose\` only when the one-line descriptions are not enough.
+3. \`install\` takes one or more exact asset names (optionally \`name@range\`); it does not search or generate. Find names with \`search\` first. No \`--type\` is needed — asset names are unique.
+4. \`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.
 5. Use \`--unapproved\` only when the user asks for unapproved/private/admin assets. Do not install unapproved assets without explicit acceptance.
-6. Preview before installing when visual fit matters: \`market preview <name> --out <file>\`. Preview is not supported for \`humanoid-animation\`, \`template\`, \`sound-effect\`, or \`background-music\`.
-7. Generate only when the user wants a new asset, auth is available, and the requested asset type supports generation. No asset type currently supports generation.
-8. Upload only when publishing is requested.
-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.
+6. \`generate --type <type> "<prompt>"\` creates a new asset; it requires login and a type that supports generation. No asset type currently supports generation.
+7. Upload only when publishing is requested: \`market upload <name> <zip> "<description>" --type <type>\`.
+8. 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.
 
 ## Output
 
-Commands print concise summaries:
+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 1 asset: wooden-chair@1.0.0
+Installed:
+- wooden-chair@1.0.0 (asset)
+  files:
+    public/model
+    └─ wooden-chair.glb
+- three@^0.178.0 (npm)
 Saved preview for wooden-chair@1.0.0: /tmp/wooden-chair.png
 \`\`\`