@drawcall/market 0.1.85 → 0.1.87

package/dist/client.d.ts

@@ -1,10 +1,19 @@
 import type { ContractRouterClient } from '@orpc/contract';
 import type { AppContract } from './contract.js';
 export type MarketClient = ContractRouterClient<AppContract>;
+type RequestFetch = (request: Request, init?: {
+    redirect?: Request['redirect'];
+}) => Promise<Response>;
 export interface MarketClientOptions {
     baseUrl?: string;
-    fetch?: typeof globalThis.fetch;
+    fetch?: RequestFetch;
     authToken?: string;
 }
+interface RetryOptions {
+    attempts?: number;
+    delayMs?: number;
+}
 export declare function createMarketClient(opts?: MarketClientOptions): MarketClient;
+export declare function createRetryingFetch(fetchImpl: RequestFetch, options?: RetryOptions): RequestFetch;
+export {};
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD,MAAM,MAAM,YAAY,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAA;AAI5D,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAMD,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,mBAAwB,GAAG,YAAY,CAQ/E"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD,MAAM,MAAM,YAAY,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAA;AAC5D,KAAK,YAAY,GAAG,CAClB,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAA;CAAE,KACtC,OAAO,CAAC,QAAQ,CAAC,CAAA;AAgBtB,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,UAAU,YAAY;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAMD,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,mBAAwB,GAAG,YAAY,CAY/E;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,YAAY,EACvB,OAAO,GAAE,YAAiB,GACzB,YAAY,CA2Bd"}

package/dist/client.js

@@ -1,16 +1,65 @@
 import { createORPCClient } from '@orpc/client';
 import { RPCLink } from '@orpc/client/fetch';
 const DEFAULT_BASE_URL = 'https://market.drawcall.ai';
+const RETRYABLE_RPC_PATHS = new Set([
+    '/api/rpc/asset/search',
+    '/api/rpc/asset/exact',
+    '/api/rpc/asset/downloadZip',
+    '/api/rpc/asset/files',
+    '/api/rpc/asset/fileManifest',
+    '/api/rpc/asset/generateStatus',
+    '/api/rpc/asset/installMetadata',
+    '/api/rpc/asset/agent/status',
+    '/api/rpc/user/getProfile',
+    '/api/rpc/user/getAuthToken',
+]);
 function buildHeaders(authToken) {
     return authToken ? { authorization: `Bearer ${authToken}` } : undefined;
 }
 export function createMarketClient(opts = {}) {
     const baseUrl = opts.baseUrl ?? DEFAULT_BASE_URL;
+    const fetch = opts.fetch ??
+        ((request, init) => globalThis.fetch(new Request(request), init));
     const link = new RPCLink({
         url: new URL('/api/rpc', baseUrl).href,
-        fetch: opts.fetch,
+        fetch: createRetryingFetch(fetch),
         headers: buildHeaders(opts.authToken),
     });
     return createORPCClient(link);
 }
+export function createRetryingFetch(fetchImpl, options = {}) {
+    const attempts = options.attempts ?? 4;
+    const delayMs = options.delayMs ?? 250;
+    return async (request, init) => {
+        if (!RETRYABLE_RPC_PATHS.has(new URL(request.url).pathname)) {
+            return fetchImpl(request, init);
+        }
+        const body = request.body ? new Uint8Array(await request.clone().arrayBuffer()) : undefined;
+        const nextRequest = () => new Request(request.url, {
+            method: request.method,
+            headers: request.headers,
+            body,
+            credentials: request.credentials,
+            signal: request.signal,
+        });
+        for (let attempt = 1;; attempt += 1) {
+            try {
+                const response = await fetchImpl(nextRequest(), init);
+                if (attempt === attempts || !isTransientStatus(response.status))
+                    return response;
+            }
+            catch (error) {
+                if (attempt === attempts)
+                    throw error;
+            }
+            await delay(delayMs * 2 ** (attempt - 1));
+        }
+    };
+}
+function isTransientStatus(status) {
+    return status === 429 || status >= 500;
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAM5C,MAAM,gBAAgB,GAAG,4BAA4B,CAAA;AAQrD,SAAS,YAAY,CAAC,SAAkB;IACtC,OAAO,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;AACzE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAA4B,EAAE;IAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,gBAAgB,CAAA;IAChD,MAAM,IAAI,GAAG,IAAI,OAAO,CAAC;QACvB,GAAG,EAAE,IAAI,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI;QACtC,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC;KACtC,CAAC,CAAA;IACF,OAAO,gBAAgB,CAAe,IAAI,CAAC,CAAA;AAC7C,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/skill.d.ts

@@ -1,2 +1,2 @@
-export declare const marketSkill = "---\nname: market\ndescription: Find, preview, install, generate, and publish Drawcall Market assets from a coding agent.\n---\n\n# Drawcall Market\n\nRun commands as `npx @drawcall/market <command>`; do not assume a global `market` binary. Use only the parts of this guide needed for the task.\n\n## Choose and install\n\nRun `npx @drawcall/market types` when you need the current asset types, generation support, or type-specific search guidance.\n\nSearch one concrete need at a time:\n\n`npx @drawcall/market search \"<query>\" --type <type> --limit 3`\n\nUse `--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.\n\nPreview a finalist when the type supports it:\n\n`npx @drawcall/market preview <name@version> --out /tmp/<name>.png`\n\nInstall exact refs together in one call; names need no `--type`:\n\n`npx @drawcall/market install <name@range...> --cwd \"$PWD\"`\n\nInstall prints the exact files it wrote. 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.\n\n`list --cwd \"$PWD\"` is an offline, compact inventory from `.drawcall/market-lock.json`. Add `--files` only when exact paths for previously installed assets are needed; fresh install and generation already print their paths.\n\n## Generate\n\n`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.\n\nAdd repeatable `--reference-image <file-or-url>` when the result should match given images; `types` shows which asset types accept reference images. A humanoid-model keeps the face and distinctive features of the person shown (at most 2 images); an environment matches the look of the references (at most 4). Types without reference image support reject them.\n\nAdd `--access public` or `--access private` when visibility matters. Omitted access follows the account entitlement; private generation requires `market:private`.\n\n## Publish only when asked\n\nUse `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 unchanged installed dependency files. 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.\n\nUse `--unapproved` only when explicitly requested. Do not install an unapproved asset without acceptance. If login is required, ask before running `npx @drawcall/market login`.\n";
+export declare const marketSkill = "---\nname: market\ndescription: Find, preview, install, generate, and publish Drawcall Market assets from a coding agent.\n---\n\n# Drawcall Market\n\nRun commands as `npx @drawcall/market <command>`; do not assume a global `market` binary. Use only the parts of this guide needed for the task.\n\n## Choose and install\n\nRun `npx @drawcall/market types` when you need the current asset types, generation support, or type-specific search guidance.\n\nSearch one concrete need at a time:\n\n`npx @drawcall/market search \"<query>\" --type <type> --limit 3`\n\nUse `--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.\n\nPreview a finalist when the type supports it:\n\n`npx @drawcall/market preview <name@version> --out /tmp/<name>.png`\n\nInstall exact refs together in one call; names need no `--type`:\n\n`npx @drawcall/market install <name@range...> --cwd \"$PWD\"`\n\nInstall prints the exact files it wrote. 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.\n\n`list --cwd \"$PWD\"` is an offline, compact inventory from `.drawcall/market-lock.json`. Add `--files` only when exact paths for previously installed assets are needed; fresh install and generation already print their paths.\n\n## Generate\n\n`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.\n\nThe 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.\n\nAdd 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. A humanoid-model keeps the face and distinctive features of the person shown (at most 2 images); describe one isolated full-body character in one pose/view, with no companions. An environment matches the look of the references (at most 4). Types without reference image support reject them.\n\nAdd `--access public` or `--access private` when visibility matters. Omitted access follows the account entitlement; private generation requires `market:private`.\n\n## Publish only when asked\n\nUse `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 unchanged installed dependency files. 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.\n\nUse `--unapproved` only when explicitly requested. Do not install an unapproved asset without acceptance. If login is required, ask before running `npx @drawcall/market login`.\n";
 //# sourceMappingURL=skill.d.ts.map

package/dist/skill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,mqGA4CvB,CAAA"}
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,unHA8CvB,CAAA"}

package/dist/skill.js

@@ -33,7 +33,9 @@ Install prints the exact files it wrote. It never searches or generates. With no
 
 \`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.
 
-Add repeatable \`--reference-image <file-or-url>\` when the result should match given images; \`types\` shows which asset types accept reference images. A humanoid-model keeps the face and distinctive features of the person shown (at most 2 images); an environment matches the look of the references (at most 4). Types without reference image support reject them.
+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. A humanoid-model keeps the face and distinctive features of the person shown (at most 2 images); describe one isolated full-body character in one pose/view, with no companions. An environment matches the look of the references (at most 4). Types without reference image support reject them.
 
 Add \`--access public\` or \`--access private\` when visibility matters. Omitted access follows the account entitlement; private generation requires \`market:private\`.
 

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4C1B,CAAA"}
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8C1B,CAAA"}

package/package.json

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

package/skills/market/SKILL.md

@@ -35,7 +35,7 @@ Install prints the exact files it wrote. It never searches or generates. With no
 
 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 humanoid-model keeps the face and distinctive features of the person shown (at most 2 images); an environment matches the look of the references (at most 4). Types without reference image support reject them.
+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. A humanoid-model keeps the face and distinctive features of the person shown (at most 2 images); describe one isolated full-body character in one pose/view, with no companions. An environment matches the look of the references (at most 4). Types without reference image support reject them.
 
 Add `--access public` or `--access private` when visibility matters. Omitted access follows the account entitlement; private generation requires `market:private`.
 

package/src/client.ts

@@ -4,25 +4,90 @@ import type { ContractRouterClient } from '@orpc/contract'
 import type { AppContract } from './contract.js'
 
 export type MarketClient = ContractRouterClient<AppContract>
+type RequestFetch = (
+  request: Request,
+  init?: { redirect?: Request['redirect'] },
+) => Promise<Response>
 
 const DEFAULT_BASE_URL = 'https://market.drawcall.ai'
+const RETRYABLE_RPC_PATHS = new Set([
+  '/api/rpc/asset/search',
+  '/api/rpc/asset/exact',
+  '/api/rpc/asset/downloadZip',
+  '/api/rpc/asset/files',
+  '/api/rpc/asset/fileManifest',
+  '/api/rpc/asset/generateStatus',
+  '/api/rpc/asset/installMetadata',
+  '/api/rpc/asset/agent/status',
+  '/api/rpc/user/getProfile',
+  '/api/rpc/user/getAuthToken',
+])
 
 export interface MarketClientOptions {
   baseUrl?: string
-  fetch?: typeof globalThis.fetch
+  fetch?: RequestFetch
   authToken?: string
 }
 
+interface RetryOptions {
+  attempts?: number
+  delayMs?: number
+}
+
 function buildHeaders(authToken?: string): Record<string, string> | undefined {
   return authToken ? { authorization: `Bearer ${authToken}` } : undefined
 }
 
 export function createMarketClient(opts: MarketClientOptions = {}): MarketClient {
   const baseUrl = opts.baseUrl ?? DEFAULT_BASE_URL
+  const fetch =
+    opts.fetch ??
+    ((request: Request, init?: { redirect?: Request['redirect'] }) =>
+      globalThis.fetch(new Request(request), init))
   const link = new RPCLink({
     url: new URL('/api/rpc', baseUrl).href,
-    fetch: opts.fetch,
+    fetch: createRetryingFetch(fetch),
     headers: buildHeaders(opts.authToken),
   })
   return createORPCClient<MarketClient>(link)
 }
+
+export function createRetryingFetch(
+  fetchImpl: RequestFetch,
+  options: RetryOptions = {},
+): RequestFetch {
+  const attempts = options.attempts ?? 4
+  const delayMs = options.delayMs ?? 250
+
+  return async (request, init) => {
+    if (!RETRYABLE_RPC_PATHS.has(new URL(request.url).pathname)) {
+      return fetchImpl(request, init)
+    }
+    const body = request.body ? new Uint8Array(await request.clone().arrayBuffer()) : undefined
+    const nextRequest = () =>
+      new Request(request.url, {
+        method: request.method,
+        headers: request.headers,
+        body,
+        credentials: request.credentials,
+        signal: request.signal,
+      })
+    for (let attempt = 1; ; attempt += 1) {
+      try {
+        const response = await fetchImpl(nextRequest(), init)
+        if (attempt === attempts || !isTransientStatus(response.status)) return response
+      } catch (error) {
+        if (attempt === attempts) throw error
+      }
+      await delay(delayMs * 2 ** (attempt - 1))
+    }
+  }
+}
+
+function isTransientStatus(status: number): boolean {
+  return status === 429 || status >= 500
+}
+
+function delay(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms))
+}

package/src/skill.ts

@@ -33,7 +33,9 @@ Install prints the exact files it wrote. It never searches or generates. With no
 
 \`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.
 
-Add repeatable \`--reference-image <file-or-url>\` when the result should match given images; \`types\` shows which asset types accept reference images. A humanoid-model keeps the face and distinctive features of the person shown (at most 2 images); an environment matches the look of the references (at most 4). Types without reference image support reject them.
+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. A humanoid-model keeps the face and distinctive features of the person shown (at most 2 images); describe one isolated full-body character in one pose/view, with no companions. An environment matches the look of the references (at most 4). Types without reference image support reject them.
 
 Add \`--access public\` or \`--access private\` when visibility matters. Omitted access follows the account entitlement; private generation requires \`market:private\`.