@pixeldojo/mcp 0.1.0 → 0.2.1

package/dist/cli.js

@@ -113,6 +113,9 @@ var InputSchema = z.object({
   model: z.string().optional().describe(
     'Override the model. Any apiId from /api/v1/models (e.g. "flux", "google-nano-banana", "veo-3.1", "kling-video"). Omit to use the default.'
   ),
+  preset: z.string().optional().describe(
+    'Preset slug to seed the params (e.g. "cinematic-portrait", "product-floating-clean", "magazine-cover-text"). Browse the catalog at https://pixeldojo.ai/presets. Explicit fields override preset values.'
+  ),
   aspect_ratio: z.string().optional().describe('Aspect ratio supported by the chosen model (e.g. "1:1", "16:9", "9:16").'),
   duration: z.number().int().positive().optional().describe("Video duration in seconds, when applicable."),
   image_url: z.string().url().optional().describe("Reference image URL for image-to-image / image-to-video tools.")
@@ -126,6 +129,10 @@ var InputJsonSchema = {
       type: "string",
       description: 'Override the model. Any apiId from /api/v1/models (e.g. "flux", "google-nano-banana", "veo-3.1", "kling-video"). Omit to use the default.'
     },
+    preset: {
+      type: "string",
+      description: 'Preset slug to seed the params (e.g. "cinematic-portrait", "product-floating-clean"). Explicit fields override preset values.'
+    },
     aspect_ratio: { type: "string" },
     duration: { type: "integer" },
     image_url: { type: "string", format: "uri" }
@@ -138,6 +145,7 @@ async function run(input, ctx) {
   if (input.aspect_ratio) body.aspect_ratio = input.aspect_ratio;
   if (input.duration !== void 0) body.duration = input.duration;
   if (input.image_url) body.image_url = input.image_url;
+  if (input.preset) body.preset = input.preset;
   const submitted = await ctx.client.run(apiId, body);
   const result = await pollJobUntilDoneOrHandoff(
     submitted.jobId,
@@ -358,6 +366,8 @@ var InputJsonSchema5 = {
   },
   required: ["jobId"]
 };
+var STUCK_HINT_MS = 5 * 60 * 1e3;
+var ABANDON_HINT_MS = 12 * 60 * 1e3;
 async function run5(input, ctx) {
   const job = await ctx.client.getJob(input.jobId);
   if (job.status === "completed") {
@@ -375,13 +385,44 @@ async function run5(input, ctx) {
       text: `Job ${input.jobId} failed: ${errMsg}`
     };
   }
+  const apiId = job.apiId ?? "unknown";
+  const ageMs = jobAgeMs(job);
+  const ageLabel = formatAge(ageMs);
+  let hint;
+  if (ageMs >= ABANDON_HINT_MS) {
+    hint = `That's well past the typical generation window for any model on PixelDojo. The job is almost certainly stuck. Submit a fresh request, or open ${ctx.buildStatusUrl(input.jobId)} for the raw record.`;
+  } else if (ageMs >= STUCK_HINT_MS) {
+    hint = `That's longer than most generations should take. Poll once more, or submit a fresh request if the next check still says ${job.status}.`;
+  } else {
+    hint = `Try again in a few seconds, or follow ${ctx.buildStatusUrl(input.jobId)}.`;
+  }
   return {
     kind: "handoff",
-    text: `Job ${input.jobId} is still ${job.status}. Try again in a few seconds, or follow ${ctx.buildStatusUrl(input.jobId)}.`,
+    text: `Job ${input.jobId} (${apiId}) is ${job.status} after ${ageLabel}. ${hint}`,
     jobId: input.jobId,
     statusUrl: ctx.buildStatusUrl(input.jobId)
   };
 }
+function jobAgeMs(job) {
+  const createdAt = job.createdAt;
+  if (!createdAt) return 0;
+  const t = Date.parse(createdAt);
+  if (Number.isNaN(t)) return 0;
+  const age = Date.now() - t;
+  return age >= 0 ? age : 0;
+}
+function formatAge(ms) {
+  if (ms < 6e4) return `${Math.max(1, Math.round(ms / 1e3))}s`;
+  const totalSeconds = Math.round(ms / 1e3);
+  const minutes = Math.floor(totalSeconds / 60);
+  const seconds = totalSeconds % 60;
+  if (minutes < 60) {
+    return seconds === 0 ? `${minutes}m` : `${minutes}m ${seconds}s`;
+  }
+  const hours = Math.floor(minutes / 60);
+  const remMinutes = minutes % 60;
+  return remMinutes === 0 ? `${hours}h` : `${hours}h ${remMinutes}m`;
+}
 function extractAssetUrls2(job) {
   if (job.assets && job.assets.length > 0) return job.assets.map((a) => a.url);
   const output = job.output;
@@ -401,6 +442,180 @@ var statusSkill = {
   defaultModel: "",
   run: run5
 };
+var InputSchema6 = z.object({
+  url: z.string().min(1).max(2048).describe("Product page URL. Shopify, BigCommerce, WooCommerce, or any page with JSON-LD / OpenGraph product metadata.")
+});
+var InputJsonSchema6 = {
+  type: "object",
+  properties: {
+    url: {
+      type: "string",
+      description: "Product page URL. Shopify, BigCommerce, WooCommerce, or any page with JSON-LD / OpenGraph product metadata."
+    }
+  },
+  required: ["url"]
+};
+async function run6(input, ctx) {
+  const product = await ctx.client.extractProduct(input.url);
+  const summary = [
+    `Product: ${product.name}`,
+    product.description ? `Description: ${truncate(product.description, 280)}` : null,
+    `Images (${product.images.length}): ${product.images.slice(0, 3).join(", ")}${product.images.length > 3 ? `, +${product.images.length - 3} more` : ""}`,
+    `Source strategy: ${product.source}`
+  ].filter(Boolean).join("\n");
+  return {
+    kind: "text",
+    text: summary
+  };
+}
+function truncate(input, max) {
+  if (input.length <= max) return input;
+  return input.slice(0, max - 3) + "...";
+}
+var fromUrlSkill = {
+  name: "pixeldojo:from_url",
+  description: "Extract product info (name, description, images) from any product page URL. Use this as the first step before pixeldojo:campaign / :ad / :lookbook so the agent has structured product data instead of a free-text description.",
+  inputZod: InputSchema6,
+  inputJsonSchema: InputJsonSchema6,
+  // No model dispatch — this skill calls a server-side scrape, not a generation.
+  allowedModels: [],
+  defaultModel: "",
+  run: run6
+};
+var InputSchema7 = z.object({
+  productUrl: z.string().url().optional().describe("Product page URL. We extract name + description + images automatically."),
+  product: z.object({
+    name: z.string().min(1).max(200),
+    description: z.string().max(2e3).optional(),
+    images: z.array(z.string().url()).max(5).optional()
+  }).optional().describe("Manual product fields, used when productUrl is omitted."),
+  tone: z.string().max(120).optional().describe('Optional creative direction ("premium minimalist", "playful Y2K"). Threaded through every prompt.'),
+  variants: z.number().int().min(1).max(8).optional().describe("Lifestyle shots in addition to the hero (default 4, max 8)."),
+  includeVideo: z.boolean().optional().describe("Whether to also generate a vertical launch video (default true)."),
+  videoAspectRatio: z.enum(["9:16", "16:9", "1:1"]).optional().describe("Aspect ratio of the launch video (default 9:16 for Reels/TikTok)."),
+  videoMode: z.enum(["lifestyle", "cgi", "ugc", "skip"]).optional().describe("Video styling \u2014 lifestyle (default), cgi, ugc, or skip to omit video.")
+}).refine((v) => v.productUrl || v.product, {
+  message: "productUrl or product is required",
+  path: ["productUrl"]
+});
+var InputJsonSchema7 = {
+  type: "object",
+  properties: {
+    productUrl: {
+      type: "string",
+      format: "uri",
+      description: "Product page URL. We extract name + description + images automatically."
+    },
+    product: {
+      type: "object",
+      properties: {
+        name: { type: "string" },
+        description: { type: "string" },
+        images: { type: "array", items: { type: "string", format: "uri" } }
+      },
+      required: ["name"]
+    },
+    tone: {
+      type: "string",
+      description: "Creative direction threaded through every prompt."
+    },
+    variants: { type: "integer", minimum: 1, maximum: 8 },
+    includeVideo: { type: "boolean" },
+    videoAspectRatio: { type: "string", enum: ["9:16", "16:9", "1:1"] },
+    videoMode: { type: "string", enum: ["lifestyle", "cgi", "ugc", "skip"] }
+  },
+  oneOf: [{ required: ["productUrl"] }, { required: ["product"] }]
+};
+async function run7(input, ctx) {
+  const client = ctx.client;
+  const result = await client.runCampaign(input);
+  if (result.kind === "campaign") {
+    const assets = result.assets ?? [];
+    const lines = [
+      `Campaign ${result.campaignId} for "${result.product?.name ?? "product"}":`,
+      ...assets.map(
+        (a) => `  - ${a.role}${a.variantIndex !== void 0 ? ` #${a.variantIndex}` : ""} (${a.kind}, ${a.apiId}): ${a.url}`
+      ),
+      "",
+      `Total credits: ${result.totalCreditCost ?? 0}.`,
+      ...result.warnings && result.warnings.length > 0 ? [`Warnings: ${result.warnings.join("; ")}`] : []
+    ];
+    return {
+      kind: "assets",
+      text: lines.join("\n"),
+      assetUrls: assets.map((a) => a.url)
+    };
+  }
+  return {
+    kind: "handoff",
+    text: result.message ?? `Campaign ${result.campaignId} queued. Poll via pixeldojo:campaign_status.`,
+    jobId: result.campaignId,
+    statusUrl: result.statusUrl ?? ctx.buildStatusUrl(result.campaignId)
+  };
+}
+var campaignSkill = {
+  name: "pixeldojo:campaign",
+  description: "Generate a coherent product launch package (hero image + N lifestyle variants + optional vertical video) from one URL or product profile. Composes hero / lifestyle / video models server-side; returns assets in one call or a handoff with campaignId to poll via pixeldojo:campaign_status.",
+  inputZod: InputSchema7,
+  inputJsonSchema: InputJsonSchema7,
+  // Composition skill — internal sub-jobs route to per-tool models, no
+  // single allowed-models list applies here.
+  allowedModels: [],
+  defaultModel: "",
+  run: run7
+};
+var InputSchema8 = z.object({
+  campaignId: z.string().min(1).max(200).describe("Campaign id returned from a prior pixeldojo:campaign handoff.")
+});
+var InputJsonSchema8 = {
+  type: "object",
+  properties: {
+    campaignId: {
+      type: "string",
+      description: "Campaign id returned from a prior pixeldojo:campaign handoff."
+    }
+  },
+  required: ["campaignId"]
+};
+async function run8(input, ctx) {
+  const client = ctx.client;
+  const result = await client.getCampaign(input.campaignId);
+  if (result.kind === "campaign") {
+    const assets = result.assets ?? [];
+    const lines = [
+      `Campaign ${result.campaignId} complete (${assets.length} assets):`,
+      ...assets.map(
+        (a) => `  - ${a.role}${a.variantIndex !== void 0 ? ` #${a.variantIndex}` : ""} (${a.kind}, ${a.apiId}): ${a.url}`
+      ),
+      "",
+      `Total credits: ${result.totalCreditCost ?? 0}.`,
+      ...result.warnings && result.warnings.length > 0 ? [`Warnings: ${result.warnings.join("; ")}`] : []
+    ];
+    return {
+      kind: "assets",
+      text: lines.join("\n"),
+      assetUrls: assets.map((a) => a.url)
+    };
+  }
+  const stillRunning = (result.subJobs ?? []).filter(
+    (s) => s.status !== "completed" && s.status !== "failed"
+  );
+  return {
+    kind: "handoff",
+    text: `Campaign ${result.campaignId}: ` + (stillRunning.length > 0 ? `${stillRunning.length} of ${result.subJobs?.length ?? 0} sub-jobs still ${stillRunning[0].status}. Wait a few seconds, then poll again.` : `aggregate state pending. Poll again shortly.`),
+    jobId: result.campaignId,
+    statusUrl: result.statusUrl ?? ctx.buildStatusUrl(result.campaignId)
+  };
+}
+var campaignStatusSkill = {
+  name: "pixeldojo:campaign_status",
+  description: "Poll a campaign by campaignId returned from pixeldojo:campaign. Returns assets when every sub-job is done, or a handoff describing what is still in flight.",
+  inputZod: InputSchema8,
+  inputJsonSchema: InputJsonSchema8,
+  allowedModels: [],
+  defaultModel: "",
+  run: run8
+};
 
 // src/skills/index.ts
 var ALL_SKILLS = [
@@ -408,7 +623,10 @@ var ALL_SKILLS = [
   characterSkill,
   storyboardSkill,
   upscaleSkill,
-  statusSkill
+  statusSkill,
+  fromUrlSkill,
+  campaignSkill,
+  campaignStatusSkill
 ];
 function findSkill(name) {
   return ALL_SKILLS.find((s) => s.name === name);