@drawcall/market 0.8.31 → 0.9.0

package/dist/refs.js

@@ -1,4 +1,4 @@
-import { MAX_ASSET_REFS_QUERY_LENGTH } from './schemas.js';
+import { assetNameSchema, MAX_ASSET_REFS_QUERY_LENGTH, semverSchema } from './schemas.js';
 /** The server accepts up to 100 refs and 4,000 characters per read. */
 const MAX_REFS_PER_CALL = 100;
 /**
@@ -20,6 +20,22 @@ export async function lookupAssets(asset, refs, opts = {}) {
     }));
     return results.flat();
 }
+/** Resolve a bare asset name or exact name@version without accepting semver ranges. */
+export async function resolveAsset(client, ref, opts = {}) {
+    const separator = ref.indexOf('@');
+    const name = assetNameSchema.parse(separator === -1 ? ref : ref.slice(0, separator));
+    const requestedVersion = separator === -1 ? undefined : semverSchema.parse(ref.slice(separator + 1));
+    const [asset] = await lookupAssets(client, [{ name, ...(requestedVersion ? { version: requestedVersion } : {}) }], {
+        includeUnapproved: opts.includeUnapproved ?? false,
+        ...(opts.key ? { key: opts.key } : {}),
+    });
+    if (!asset)
+        throw new Error(`Asset "${ref}" not found`);
+    if (requestedVersion && asset.version !== requestedVersion) {
+        throw new Error(`Market API did not return requested version "${ref}"`);
+    }
+    return asset;
+}
 function chunkRefs(refs) {
     const chunks = [];
     let chunk = [];

package/dist/refs.js.map

@@ -1 +1 @@
-{"version":3,"file":"refs.js","sourceRoot":"","sources":["../src/refs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAA;AAa1D,uEAAuE;AACvE,MAAM,iBAAiB,GAAG,GAAG,CAAA;AAE7B;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAiB,EACjB,IAAgB,EAChB,OAAsD,EAAE;IAExD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAE9B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC;YAChC,IAAI,EAAE,SAAS;YACf,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,IAAI,KAAK;YAClD,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvC,CAAC,CAAA;QACF,IAAI,CAAC,CAAC,QAAQ,IAAI,MAAM,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;QAC7F,OAAO,MAAM,CAAC,MAAM,CAAA;IACtB,CAAC,CAAC,CACH,CAAA;IACD,OAAO,OAAO,CAAC,IAAI,EAAE,CAAA;AACvB,CAAC;AAED,SAAS,SAAS,CAAC,IAAgB;IACjC,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,IAAI,KAAK,GAAa,EAAE,CAAA;IACxB,IAAI,MAAM,GAAG,CAAC,CAAA;IAEd,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAA;QACnE,IAAI,KAAK,CAAC,MAAM,GAAG,2BAA2B,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,qBAAqB,2BAA2B,gBAAgB,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;QAC7F,CAAC;QAED,MAAM,eAAe,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAChD,MAAM,UAAU,GAAG,MAAM,GAAG,eAAe,GAAG,KAAK,CAAC,MAAM,CAAA;QAC1D,IAAI,KAAK,CAAC,MAAM,KAAK,iBAAiB,IAAI,UAAU,GAAG,2BAA2B,EAAE,CAAC;YACnF,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;YAC5B,KAAK,GAAG,EAAE,CAAA;YACV,MAAM,GAAG,CAAC,CAAA;QACZ,CAAC;QAED,MAAM,mBAAmB,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACpD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACjB,MAAM,IAAI,mBAAmB,GAAG,KAAK,CAAC,MAAM,CAAA;IAC9C,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IAClD,OAAO,MAAM,CAAA;AACf,CAAC"}
+{"version":3,"file":"refs.js","sourceRoot":"","sources":["../src/refs.ts"],"names":[],"mappings":"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"}

package/dist/skill.generated.d.ts

@@ -0,0 +1,3 @@
+export declare const cliMarketSkill = "---\nname: market\ndescription: Find, inspect, generate, and use Drawcall Market assets from a coding agent.\n---\n\n# Drawcall Market\n\n## CLI transport\n\nRun commands as `npx @drawcall/market <command>`; do not assume a global `market` binary or switch to MCP after a CLI failure. Use `npx @drawcall/market skill` when these instructions are not already available.\n\nDiscover the current vocabulary and choose an asset:\n\n```sh\nnpx @drawcall/market types\nnpx @drawcall/market search \"<query>\" --type <type> --limit 3\nnpx @drawcall/market preview <name@version> --out /tmp/<name>.png\nnpx @drawcall/market urls <name@version>\n```\n\n`urls` prints one base URL, file subpaths, and a preview URL without changing the project. Install exact refs together when the project needs local files:\n\n```sh\nnpx @drawcall/market install <name@range...> --cwd \"$PWD\"\n```\n\nInstall records `assetDependencies` in the nearest `package.json`. `list --cwd \"$PWD\"` reads that inventory without network access. Run `sync --cwd \"$PWD\"` after moving installed files so aliases continue to resolve. Use `--force` only with permission to overwrite changed files.\n\nGenerate and install one asset with:\n\n```sh\nnpx @drawcall/market generate --type <type> \"<description>\"\n```\n\nIf it returns a continuation, run the printed `generate install <jobId>` command. The Market agent can source a coherent set of assets from a broader goal:\n\n```sh\nnpx @drawcall/market agent \"<goal>\"\n```\n\nPublish only when asked. `pack <source> --out <zip>` creates a Market archive and `upload <name> <source> \"<description>\" --type <type>` publishes it. Use command help for dependency and visibility options. If authentication is required, ask before running `npx @drawcall/market login`.\n\n## Choose assets\n\nSearch one concrete need at a time. Use one result for an exact lookup and up to three when the user should choose. If nothing fits, try one broader noun phrase before generating a replacement.\n\nThe exact `name@version` returned by Market is authoritative. Copy it verbatim. Generated identifiers can legitimately end mid-word at the catalog limit; never expand, normalize, or reconstruct one from its description.\n\nPreview a finalist when appearance determines whether it fits. File, preview, and zip URLs returned by Market are opaque. Capability-bearing private URLs are secrets; never derive a URL from an asset name or preview metadata.\n\n## Generate\n\nGeneration creates one Market asset from a description. The description is provider input, not the eventual asset name. A fast provider may return the asset immediately; a slow provider returns a continuation ID for the matching status operation. Resume that job instead of starting the same generation again.\n\nReference images must be direct fetchable image URLs or image data, never webpage URLs. The current asset-type metadata says which types support references and how many they accept.\n\nA generated humanoid model is one expressive, animation-ready biped: one head, two arms, two legs, open empty hands, and no companions or scene. Describe identity, theme, silhouette, clothing, colors, and materials. Express topology outside the shared skeleton as costume or body-surface design so the result remains riggable.\n\nRequest public or private access only when visibility matters. Private generation requires the account's `market:private` entitlement.\n\n## Failures\n\nAn error means the operation did not happen. Correct invalid inputs, refresh an exact reference after a not-found response, and retry one upstream failure once. Never repeat an unchanged failed generation. Use unapproved assets only when the user explicitly requests and accepts them.\n";
+export declare const mcpMarketSkill = "---\nname: market\ndescription: Find, inspect, generate, and use Drawcall Market assets from a coding agent.\n---\n\n# Drawcall Market\n\n## MCP transport\n\nMCP tools are the only Market transport in this environment. Do not invoke the CLI, make direct API requests, or switch transports after a failed call.\n\nUse the same conceptual workflow as the Market CLI:\n\n```text\nlist_market_asset_types\nsearch_market\nget_market_asset\nget_market_asset_preview\n```\n\n`search_market` requires an asset type and returns exact `name@version` references. Inspect the exact manifest with `get_market_asset`; request its preview only when visual evidence matters. Remote MCP tools return immutable references and fetch-ready URLs. They do not install files into the caller's local project.\n\nWhen generation is available, call `generate_market_asset`. If it returns a `jobId`, continue with `get_market_asset_generation`. Do not start the same generation again.\n\nWhen the Market agent is available, call `start_market_agent_run` with the full goal and continue its returned `runId` with `get_market_agent_run`.\n\nUse an exact Market reference with `create_design_frame` when the selected asset belongs in Drawcall Design.\n\n## Choose assets\n\nSearch one concrete need at a time. Use one result for an exact lookup and up to three when the user should choose. If nothing fits, try one broader noun phrase before generating a replacement.\n\nThe exact `name@version` returned by Market is authoritative. Copy it verbatim. Generated identifiers can legitimately end mid-word at the catalog limit; never expand, normalize, or reconstruct one from its description.\n\nPreview a finalist when appearance determines whether it fits. File, preview, and zip URLs returned by Market are opaque. Capability-bearing private URLs are secrets; never derive a URL from an asset name or preview metadata.\n\n## Generate\n\nGeneration creates one Market asset from a description. The description is provider input, not the eventual asset name. A fast provider may return the asset immediately; a slow provider returns a continuation ID for the matching status operation. Resume that job instead of starting the same generation again.\n\nReference images must be direct fetchable image URLs or image data, never webpage URLs. The current asset-type metadata says which types support references and how many they accept.\n\nA generated humanoid model is one expressive, animation-ready biped: one head, two arms, two legs, open empty hands, and no companions or scene. Describe identity, theme, silhouette, clothing, colors, and materials. Express topology outside the shared skeleton as costume or body-surface design so the result remains riggable.\n\nRequest public or private access only when visibility matters. Private generation requires the account's `market:private` entitlement.\n\n## Failures\n\nAn error means the operation did not happen. Correct invalid inputs, refresh an exact reference after a not-found response, and retry one upstream failure once. Never repeat an unchanged failed generation. Use unapproved assets only when the user explicitly requests and accepts them.\n";
+//# sourceMappingURL=skill.generated.d.ts.map

package/dist/skill.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.generated.d.ts","sourceRoot":"","sources":["../src/skill.generated.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,cAAc,6pHAConH,CAAA;AAC/oH,eAAO,MAAM,cAAc,4mGACglG,CAAA"}

package/dist/skill.generated.js

@@ -0,0 +1,4 @@
+// Generated from skill/SKILL.template.md.
+export const cliMarketSkill = '---\nname: market\ndescription: Find, inspect, generate, and use Drawcall Market assets from a coding agent.\n---\n\n# Drawcall Market\n\n## CLI transport\n\nRun commands as `npx @drawcall/market <command>`; do not assume a global `market` binary or switch to MCP after a CLI failure. Use `npx @drawcall/market skill` when these instructions are not already available.\n\nDiscover the current vocabulary and choose an asset:\n\n```sh\nnpx @drawcall/market types\nnpx @drawcall/market search "<query>" --type <type> --limit 3\nnpx @drawcall/market preview <name@version> --out /tmp/<name>.png\nnpx @drawcall/market urls <name@version>\n```\n\n`urls` prints one base URL, file subpaths, and a preview URL without changing the project. Install exact refs together when the project needs local files:\n\n```sh\nnpx @drawcall/market install <name@range...> --cwd "$PWD"\n```\n\nInstall records `assetDependencies` in the nearest `package.json`. `list --cwd "$PWD"` reads that inventory without network access. Run `sync --cwd "$PWD"` after moving installed files so aliases continue to resolve. Use `--force` only with permission to overwrite changed files.\n\nGenerate and install one asset with:\n\n```sh\nnpx @drawcall/market generate --type <type> "<description>"\n```\n\nIf it returns a continuation, run the printed `generate install <jobId>` command. The Market agent can source a coherent set of assets from a broader goal:\n\n```sh\nnpx @drawcall/market agent "<goal>"\n```\n\nPublish only when asked. `pack <source> --out <zip>` creates a Market archive and `upload <name> <source> "<description>" --type <type>` publishes it. Use command help for dependency and visibility options. If authentication is required, ask before running `npx @drawcall/market login`.\n\n## Choose assets\n\nSearch one concrete need at a time. Use one result for an exact lookup and up to three when the user should choose. If nothing fits, try one broader noun phrase before generating a replacement.\n\nThe exact `name@version` returned by Market is authoritative. Copy it verbatim. Generated identifiers can legitimately end mid-word at the catalog limit; never expand, normalize, or reconstruct one from its description.\n\nPreview a finalist when appearance determines whether it fits. File, preview, and zip URLs returned by Market are opaque. Capability-bearing private URLs are secrets; never derive a URL from an asset name or preview metadata.\n\n## Generate\n\nGeneration creates one Market asset from a description. The description is provider input, not the eventual asset name. A fast provider may return the asset immediately; a slow provider returns a continuation ID for the matching status operation. Resume that job instead of starting the same generation again.\n\nReference images must be direct fetchable image URLs or image data, never webpage URLs. The current asset-type metadata says which types support references and how many they accept.\n\nA generated humanoid model is one expressive, animation-ready biped: one head, two arms, two legs, open empty hands, and no companions or scene. Describe identity, theme, silhouette, clothing, colors, and materials. Express topology outside the shared skeleton as costume or body-surface design so the result remains riggable.\n\nRequest public or private access only when visibility matters. Private generation requires the account\'s `market:private` entitlement.\n\n## Failures\n\nAn error means the operation did not happen. Correct invalid inputs, refresh an exact reference after a not-found response, and retry one upstream failure once. Never repeat an unchanged failed generation. Use unapproved assets only when the user explicitly requests and accepts them.\n';
+export const mcpMarketSkill = "---\nname: market\ndescription: Find, inspect, generate, and use Drawcall Market assets from a coding agent.\n---\n\n# Drawcall Market\n\n## MCP transport\n\nMCP tools are the only Market transport in this environment. Do not invoke the CLI, make direct API requests, or switch transports after a failed call.\n\nUse the same conceptual workflow as the Market CLI:\n\n```text\nlist_market_asset_types\nsearch_market\nget_market_asset\nget_market_asset_preview\n```\n\n`search_market` requires an asset type and returns exact `name@version` references. Inspect the exact manifest with `get_market_asset`; request its preview only when visual evidence matters. Remote MCP tools return immutable references and fetch-ready URLs. They do not install files into the caller's local project.\n\nWhen generation is available, call `generate_market_asset`. If it returns a `jobId`, continue with `get_market_asset_generation`. Do not start the same generation again.\n\nWhen the Market agent is available, call `start_market_agent_run` with the full goal and continue its returned `runId` with `get_market_agent_run`.\n\nUse an exact Market reference with `create_design_frame` when the selected asset belongs in Drawcall Design.\n\n## Choose assets\n\nSearch one concrete need at a time. Use one result for an exact lookup and up to three when the user should choose. If nothing fits, try one broader noun phrase before generating a replacement.\n\nThe exact `name@version` returned by Market is authoritative. Copy it verbatim. Generated identifiers can legitimately end mid-word at the catalog limit; never expand, normalize, or reconstruct one from its description.\n\nPreview a finalist when appearance determines whether it fits. File, preview, and zip URLs returned by Market are opaque. Capability-bearing private URLs are secrets; never derive a URL from an asset name or preview metadata.\n\n## Generate\n\nGeneration creates one Market asset from a description. The description is provider input, not the eventual asset name. A fast provider may return the asset immediately; a slow provider returns a continuation ID for the matching status operation. Resume that job instead of starting the same generation again.\n\nReference images must be direct fetchable image URLs or image data, never webpage URLs. The current asset-type metadata says which types support references and how many they accept.\n\nA generated humanoid model is one expressive, animation-ready biped: one head, two arms, two legs, open empty hands, and no companions or scene. Describe identity, theme, silhouette, clothing, colors, and materials. Express topology outside the shared skeleton as costume or body-surface design so the result remains riggable.\n\nRequest public or private access only when visibility matters. Private generation requires the account's `market:private` entitlement.\n\n## Failures\n\nAn error means the operation did not happen. Correct invalid inputs, refresh an exact reference after a not-found response, and retry one upstream failure once. Never repeat an unchanged failed generation. Use unapproved assets only when the user explicitly requests and accepts them.\n";
+//# sourceMappingURL=skill.generated.js.map

package/dist/skill.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.generated.js","sourceRoot":"","sources":["../src/skill.generated.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,MAAM,CAAC,MAAM,cAAc,GACzB,6oHAA6oH,CAAA;AAC/oH,MAAM,CAAC,MAAM,cAAc,GACzB,ymGAAymG,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drawcall/market",
-  "version": "0.8.31",
+  "version": "0.9.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/drawcall-ai/market",
@@ -27,12 +27,15 @@
     "market": "./dist/cli.js"
   },
   "scripts": {
-    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "generate": "node scripts/generate-skill.mjs",
+    "build": "pnpm run generate && rm -rf dist && tsc -p tsconfig.build.json",
     "prepack": "npm run build && node scripts/prepare-publish.mjs",
     "postpack": "node scripts/restore-package.mjs",
     "dev": "tsx src/cli.ts",
+    "pretest": "pnpm run generate",
     "test": "tsx --test tests/*.test.ts",
     "test:install-layout": "tsx --test tests/install-layout.test.ts tests/install-lock.test.ts tests/install-command.test.ts tests/list-command.test.ts tests/pack.test.ts",
+    "pretypecheck": "pnpm run generate",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
@@ -49,7 +52,16 @@
     "semver": "^7.7.0",
     "zod": "^4.3.6"
   },
+  "peerDependencies": {
+    "@modelcontextprotocol/server": "^2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@modelcontextprotocol/server": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "@modelcontextprotocol/server": "^2.0.0",
     "@types/node": "^25.6.0",
     "@types/semver": "^7.5.0",
     "tsx": "^4.19.0",

package/skills/market/SKILL.md

@@ -1,58 +1,63 @@
 ---
 name: market
-description: Find, preview, remotely reference, install, generate, and publish Drawcall Market assets from a coding agent.
+description: Find, inspect, generate, and use Drawcall Market assets from a coding agent.
 ---
 
 # Drawcall Market
 
-Run commands as `npx @drawcall/market <command>`; do not assume a global `market` binary. Use only the parts of this guide needed for the task.
+## CLI transport
 
-## Choose and install
+Run commands as `npx @drawcall/market <command>`; do not assume a global `market` binary or switch to MCP after a CLI failure. Use `npx @drawcall/market skill` when these instructions are not already available.
 
-Run `npx @drawcall/market types` when you need the current asset types, generation support, or type-specific search guidance.
+Discover the current vocabulary and choose an asset:
 
-Search one concrete need at a time:
+```sh
+npx @drawcall/market types
+npx @drawcall/market search "<query>" --type <type> --limit 3
+npx @drawcall/market preview <name@version> --out /tmp/<name>.png
+npx @drawcall/market urls <name@version>
+```
 
-`npx @drawcall/market search "<query>" --type <type> --limit 3`
+`urls` prints one base URL, file subpaths, and a preview URL without changing the project. Install exact refs together when the project needs local files:
 
-Use `--limit 1` for an exact lookup and `--limit 3` for a choice. Search requires `--type` and prints full descriptions. If nothing fits, try one broader noun phrase.
+```sh
+npx @drawcall/market install <name@range...> --cwd "$PWD"
+```
 
-Preview a finalist when the type supports it:
+Install records `assetDependencies` in the nearest `package.json`. `list --cwd "$PWD"` reads that inventory without network access. Run `sync --cwd "$PWD"` after moving installed files so aliases continue to resolve. Use `--force` only with permission to overwrite changed files.
 
-`npx @drawcall/market preview <name@version> --out /tmp/<name>.png`
+Generate and install one asset with:
 
-When the codebase cannot accept local asset files, resolve fetch-ready remote URLs without writing to the project:
+```sh
+npx @drawcall/market generate --type <type> "<description>"
+```
 
-`npx @drawcall/market urls <name@version>`
+If it returns a continuation, run the printed `generate install <jobId>` command. The Market agent can source a coherent set of assets from a broader goal:
 
-`urls` prints one `base`, URL-ready file subpaths, and a `preview`; each file URL is the base plus its indented subpath. Capability-bearing private URLs are secrets. Otherwise, search and preview only select an asset—a local consumer path is valid only after install or generation succeeds. Never derive a browser path from an asset name or preview metadata.
+```sh
+npx @drawcall/market agent "<goal>"
+```
 
-The exact `name@version` token printed before the first `|` in a search result is authoritative. Copy it verbatim. Generated identifiers can legitimately end mid-word at the catalog limit; never expand, normalize, or reconstruct one from the description beside it.
+Publish only when asked. `pack <source> --out <zip>` creates a Market archive and `upload <name> <source> "<description>" --type <type>` publishes it. Use command help for dependency and visibility options. If authentication is required, ask before running `npx @drawcall/market login`.
 
-Install exact refs together in one call; names need no `--type`:
+## Choose assets
 
-`npx @drawcall/market install <name@range...> --cwd "$PWD"`
+Search one concrete need at a time. Use one result for an exact lookup and up to three when the user should choose. If nothing fits, try one broader noun phrase before generating a replacement.
 
-Install prints the exact files it wrote and records the dependency so packing and later rebuilds can restore it. It never searches or generates. With no refs it installs `assetDependencies` from the nearest `package.json`. Assets may install declared skill dependencies with `npx skills add`. Use `--force` only with permission to overwrite changed local files.
+The exact `name@version` returned by Market is authoritative. Copy it verbatim. Generated identifiers can legitimately end mid-word at the catalog limit; never expand, normalize, or reconstruct one from its description.
 
-`list --cwd "$PWD"` is an offline, compact inventory of the `assetDependencies` in the nearest `package.json`, including file aliases. When selected refs are already installed, read this inventory instead of reinstalling them.
-
-An `assetDependencies` entry is either a range string or `{ "version": "<range>", "alias": { "<canonical path>": "<current path>" } }`. An alias records where the project keeps a renamed installed file: install writes the file at the aliased path, and packing omits exactly that one copy (extra duplicates ship as project content). Run `sync --cwd "$PWD"` after renaming installed files to record aliases in `package.json`; template packing runs the same update automatically.
+Preview a finalist when appearance determines whether it fits. File, preview, and zip URLs returned by Market are opaque. Capability-bearing private URLs are secrets; never derive a URL from an asset name or preview metadata.
 
 ## Generate
 
-`npx @drawcall/market generate --type <type> "<description>"` creates and installs one provider-supported asset. It requires login and normally waits through provider generation before printing exact installed paths and type-specific usage guidance. Unsupported types report an error. If an unusually long job returns a continuation, run the printed `generate install <jobId>`; it resumes the same server-side job rather than generating again.
-
-The description is provider input, not the installed filename. The command's successful output is the source of truth for consumer paths, so update a consumer with its exact printed browser path after success. If generation fails, leave the current path unchanged.
-
-Add repeatable `--reference-image <file-or-url>` when the result should match given images; `types` shows which asset types accept reference images. A remote ref must be a direct fetchable image URL, never a webpage URL; use the page only to find its underlying image. An environment matches the look of the references (at most 4). Types without reference image support reject them.
+Generation creates one Market asset from a description. The description is provider input, not the eventual asset name. A fast provider may return the asset immediately; a slow provider returns a continuation ID for the matching status operation. Resume that job instead of starting the same generation again.
 
-A generated humanoid-model is one expressive, animation-ready biped asset: one head, two arms, two legs, open empty hands, and no companions or scene. Describe its identity, theme, silhouette, clothing, colors, and materials rather than adding generation instructions. Keep imaginative species, creature, robotic, and fantasy ideas; express topology outside the shared skeleton as worn, costume, or body-surface design. A person or humanoid reference preserves the main subject's identity and distinctive features, while a non-person reference supplies visual language such as shapes, colors, and materials (at most 2 references). This boundary keeps the asset riggable without reducing it to a generic human.
+Reference images must be direct fetchable image URLs or image data, never webpage URLs. The current asset-type metadata says which types support references and how many they accept.
 
-Add `--access public` or `--access private` when visibility matters. Omitted access follows the account entitlement; private generation requires `market:private`.
+A generated humanoid model is one expressive, animation-ready biped: one head, two arms, two legs, open empty hands, and no companions or scene. Describe identity, theme, silhouette, clothing, colors, and materials. Express topology outside the shared skeleton as costume or body-surface design so the result remains riggable.
 
-## Publish only when asked
+Request public or private access only when visibility matters. Private generation requires the account's `market:private` entitlement.
 
-Use `pack <source> --out <zip>` to create a Market zip and `upload <name> <source> "<description>" --type <type>` to publish it. Both accept repeatable `--npm name@range`, `--asset name@range`, and `--skill label=source` dependencies. Template packing reads root `assetDependencies` and may use the API to omit installed dependency files matched by content hash — even when renamed — recording renames as aliases. A skill source is `owner/repo`, a git URL, a full GitHub `tree/<branch>/<subpath>` URL, or a local skill directory inside the zip. Use the command's `--help` for syntax.
+## Failures
 
-Use `--unapproved` only when explicitly requested. Do not install an unapproved asset without acceptance. If login is required, ask before running `npx @drawcall/market login`.
+An error means the operation did not happen. Correct invalid inputs, refresh an exact reference after a not-found response, and retry one upstream failure once. Never repeat an unchanged failed generation. Use unapproved assets only when the user explicitly requests and accepts them.

package/src/command.ts

@@ -13,7 +13,7 @@ import { previewCommand } from './commands/preview.js'
 import { urlsCommand } from './commands/urls.js'
 import { uploadCommand } from './commands/upload.js'
 import { typesCommand } from './commands/types.js'
-import { marketSkill } from './skill.js'
+import { cliMarketSkill } from './skill.generated.js'
 
 export interface MarketCommandOptions {
   name?: string
@@ -60,7 +60,7 @@ export function createMarketCommand(options: MarketCommandOptions = {}): Command
     .command('skill')
     .description('Print the Market agent skill')
     .action(() => {
-      process.stdout.write(marketSkill)
+      process.stdout.write(cliMarketSkill)
     })
 
   program

package/src/commands/preview.ts

@@ -2,9 +2,8 @@ import * as fs from 'fs/promises'
 import * as path from 'path'
 import ora from 'ora'
 import { getCliClient } from '../cli-client.js'
-import type { RefsReader } from '../refs.js'
+import { resolveAsset, type RefsReader } from '../refs.js'
 import { previewResult } from '../output.js'
-import { resolveAssetRef } from './asset-ref.js'
 
 export interface PreviewCommandOptions {
   unapproved?: boolean
@@ -17,7 +16,7 @@ export async function resolvePreviewRef(
   ref: string,
   includeUnapproved: boolean,
 ): Promise<{ name: string; version: string; previewUrl: string }> {
-  const asset = await resolveAssetRef(client, ref, { includeUnapproved })
+  const asset = await resolveAsset(client, ref, { includeUnapproved })
   if (!asset.previewUrl) {
     throw new Error(`Asset "${ref}" has no preview image`)
   }

package/src/commands/urls.ts

@@ -2,7 +2,7 @@ import type { AssetFileEntry } from '../contract.js'
 import { getCliClient } from '../cli-client.js'
 import { assetUrlsResult } from '../output.js'
 import type { RefsReader } from '../refs.js'
-import { resolveAssetRef } from './asset-ref.js'
+import { resolveAsset } from '../refs.js'
 
 export interface AssetUrls {
   name: string
@@ -23,7 +23,7 @@ export async function resolveAssetUrls(
   ref: string,
   opts: Pick<UrlsCommandOptions, 'unapproved' | 'key'> = {},
 ): Promise<AssetUrls> {
-  const asset = await resolveAssetRef(client, ref, {
+  const asset = await resolveAsset(client, ref, {
     includeUnapproved: opts.unapproved,
     key: opts.key,
   })

package/src/index.ts

@@ -16,6 +16,16 @@ export async function createMarketCommand(options: MarketCommandModule.MarketCom
 // The v1 REST surface (`/api/v1`): routed contract + typed client.
 export * as v1 from './v1/index.js'
 
+export {
+  registerMarketTools,
+  type MarketMcpCapabilities,
+  type MarketMcpOptions,
+  type MarketMcpServer,
+  type MarketMcpToolResult,
+} from './mcp/index.js'
+
+export { cliMarketSkill, mcpMarketSkill } from './skill.generated.js'
+
 // Client (an alias of the v1 client)
 export { downloadAssetZipBytes } from './client.js'
 export type { MarketClient, MarketClientOptions } from './client.js'

package/src/mcp/agent.ts

@@ -0,0 +1,39 @@
+import { agentStartSchema, agentStatusSchema } from '../schemas.js'
+import type { MarketV1Client } from '../v1/client.js'
+import { result } from './result.js'
+import type { MarketMcpServer } from './types.js'
+
+export function registerAgentTools(server: MarketMcpServer, client: MarketV1Client): void {
+  server.registerTool(
+    'start_market_agent_run',
+    {
+      title: 'Start Market agent run',
+      description:
+        'Start a Market agent run that plans, finds, judges, and generates a coherent set of assets for a goal.',
+      inputSchema: agentStartSchema,
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        openWorldHint: true,
+        idempotentHint: false,
+      },
+    },
+    async (input) => result({ run: await client.asset.agent.start(input) }),
+  )
+
+  server.registerTool(
+    'get_market_agent_run',
+    {
+      title: 'Get Market agent run',
+      description: 'Get the current state and result of a Market agent run.',
+      inputSchema: agentStatusSchema,
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: true,
+        idempotentHint: true,
+      },
+    },
+    async (input) => result({ run: await client.asset.agent.status(input) }),
+  )
+}

package/src/mcp/asset.ts

@@ -0,0 +1,158 @@
+import { z } from 'zod'
+import { resolveAsset } from '../refs.js'
+import { assetTypeSchema } from '../schemas.js'
+import type { MarketV1Client } from '../v1/client.js'
+import { base64, result } from './result.js'
+import type { MarketMcpServer } from './types.js'
+
+const searchMarketSchema = z
+  .object({
+    query: z.string().min(1).max(200),
+    type: assetTypeSchema,
+    limit: z.coerce.number().int().min(1).max(5).default(3),
+    includeUnapproved: z.boolean().default(false),
+  })
+  .strict()
+
+const assetRefSchema = z.string().min(1).describe('Asset name or exact name@version')
+const assetInput = z
+  .object({
+    asset: assetRefSchema,
+    includeUnapproved: z.boolean().default(false),
+    key: z.string().min(1).max(128).optional(),
+  })
+  .strict()
+
+export function registerAssetTools(
+  server: MarketMcpServer,
+  client: MarketV1Client,
+  fetcher: typeof globalThis.fetch,
+): void {
+  server.registerTool(
+    'list_market_asset_types',
+    {
+      title: 'List Market asset types',
+      description:
+        'List current Drawcall Market asset types with their search, generation, and installation guidance.',
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: true,
+        idempotentHint: true,
+      },
+    },
+    async () => result({ types: await client.asset.installMetadata() }),
+  )
+
+  server.registerTool(
+    'search_market',
+    {
+      title: 'Search Market',
+      description:
+        'Search Drawcall Market for assets matching one concrete need. Returns exact name@version references; call get_market_asset before selecting one.',
+      inputSchema: searchMarketSchema,
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: true,
+        idempotentHint: true,
+      },
+    },
+    async ({ query, type, limit, includeUnapproved }) => {
+      const response = await client.asset.search({
+        query,
+        type,
+        limit,
+        page: 1,
+        includeUnapproved,
+      })
+      if (!('items' in response)) {
+        throw new Error('Market search unexpectedly returned an exact asset result')
+      }
+      return result({
+        assets: response.items.map((asset) => ({
+          asset: `${asset.name}@${asset.latestVersion}`,
+          name: asset.name,
+          version: asset.latestVersion,
+          type: asset.type,
+          description: asset.description,
+          approved: asset.approved,
+          access: asset.access,
+          previewUrl: asset.previewUrl,
+        })),
+        total: response.total,
+      })
+    },
+  )
+
+  server.registerTool(
+    'get_market_asset',
+    {
+      title: 'Get Market asset',
+      description:
+        'Get one exact Drawcall Market asset manifest with its version history, dependencies, files, preview URL, and zip URL.',
+      inputSchema: assetInput,
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: true,
+        idempotentHint: true,
+      },
+    },
+    async ({ asset, includeUnapproved, key }) =>
+      result({
+        asset: await resolveAsset(client.asset, asset, {
+          includeUnapproved,
+          ...(key ? { key } : {}),
+        }),
+      }),
+  )
+
+  server.registerTool(
+    'get_market_asset_preview',
+    {
+      title: 'Get Market asset preview',
+      description: 'Return the preview image for one exact Drawcall Market asset.',
+      inputSchema: assetInput,
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: true,
+        idempotentHint: true,
+      },
+    },
+    async ({ asset: ref, includeUnapproved, key }) => {
+      const asset = await resolveAsset(client.asset, ref, {
+        includeUnapproved,
+        ...(key ? { key } : {}),
+      })
+      if (!asset.previewUrl) throw new Error(`Asset "${ref}" has no preview image`)
+
+      const response = await fetcher(asset.previewUrl)
+      if (!response.ok) {
+        throw new Error(
+          `Could not read preview ${asset.previewUrl}: ${response.status} ${response.statusText}`,
+        )
+      }
+      const mimeType = response.headers.get('content-type')?.split(';', 1)[0]
+      if (!mimeType?.startsWith('image/')) {
+        throw new Error(`Preview ${asset.previewUrl} returned ${mimeType ?? 'no media type'}`)
+      }
+
+      return {
+        content: [
+          {
+            type: 'image',
+            data: base64(new Uint8Array(await response.arrayBuffer())),
+            mimeType,
+          },
+        ],
+        structuredContent: {
+          asset: `${asset.name}@${asset.version}`,
+          url: asset.previewUrl,
+          mediaType: mimeType,
+        },
+      }
+    },
+  )
+}

package/src/mcp/generation.ts

@@ -0,0 +1,41 @@
+import { assetTypeSchema, generateAssetSchema, generateStatusInputSchema } from '../schemas.js'
+import type { MarketV1Client } from '../v1/client.js'
+import { result } from './result.js'
+import type { MarketMcpServer } from './types.js'
+
+const generateMarketAssetSchema = generateAssetSchema.extend({ type: assetTypeSchema }).strict()
+
+export function registerGenerationTools(server: MarketMcpServer, client: MarketV1Client): void {
+  server.registerTool(
+    'generate_market_asset',
+    {
+      title: 'Generate Market asset',
+      description:
+        'Generate one Drawcall Market asset. A slow provider returns a jobId to pass to get_market_asset_generation.',
+      inputSchema: generateMarketAssetSchema,
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        openWorldHint: true,
+        idempotentHint: false,
+      },
+    },
+    async (input) => result({ generation: await client.asset.generate(input) }),
+  )
+
+  server.registerTool(
+    'get_market_asset_generation',
+    {
+      title: 'Get Market asset generation',
+      description: 'Get the current state of a Market asset generation job.',
+      inputSchema: generateStatusInputSchema.strict(),
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: true,
+        idempotentHint: true,
+      },
+    },
+    async (input) => result({ generation: await client.asset.generateStatus(input) }),
+  )
+}

package/src/mcp/index.ts

@@ -0,0 +1,7 @@
+export { registerMarketTools } from './register.js'
+export type {
+  MarketMcpCapabilities,
+  MarketMcpOptions,
+  MarketMcpServer,
+  MarketMcpToolResult,
+} from './types.js'

package/src/mcp/instructions.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod'
+import { mcpMarketSkill } from '../skill.generated.js'
+import type { MarketMcpServer } from './types.js'
+
+export function registerInstructions(server: MarketMcpServer): void {
+  server.registerTool(
+    'get_market_instructions',
+    {
+      title: 'Get Market instructions',
+      description:
+        'Return instructions for finding, inspecting, generating, and using Drawcall Market assets.',
+      inputSchema: z.object({}).strict(),
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: false,
+        idempotentHint: true,
+      },
+    },
+    async () => ({ content: [{ type: 'text', text: mcpMarketSkill }] }),
+  )
+}

package/src/mcp/register.ts

@@ -0,0 +1,17 @@
+import type { MarketV1Client } from '../v1/client.js'
+import { registerAgentTools } from './agent.js'
+import { registerAssetTools } from './asset.js'
+import { registerGenerationTools } from './generation.js'
+import { registerInstructions } from './instructions.js'
+import type { MarketMcpOptions, MarketMcpServer } from './types.js'
+
+export function registerMarketTools(
+  server: MarketMcpServer,
+  client: MarketV1Client,
+  options: MarketMcpOptions = {},
+): void {
+  registerInstructions(server)
+  registerAssetTools(server, client, options.fetch ?? globalThis.fetch)
+  if (options.capabilities?.generate) registerGenerationTools(server, client)
+  if (options.capabilities?.agent) registerAgentTools(server, client)
+}

package/src/mcp/result.ts

@@ -0,0 +1,18 @@
+import type { MarketMcpToolResult } from './types.js'
+
+export function result<Structured extends Record<string, unknown>>(
+  structuredContent: Structured,
+): MarketMcpToolResult {
+  return {
+    content: [{ type: 'text', text: JSON.stringify(structuredContent) }],
+    structuredContent,
+  }
+}
+
+export function base64(bytes: Uint8Array): string {
+  let binary = ''
+  for (let offset = 0; offset < bytes.length; offset += 32_768) {
+    binary += String.fromCharCode(...bytes.subarray(offset, offset + 32_768))
+  }
+  return btoa(binary)
+}