@pixeldojo/mcp 0.4.0 → 0.5.0

package/README.md

@@ -3,7 +3,13 @@
 PixelDojo MCP server. One install for Claude Code, Cursor, OpenClaw, and any
 other [Model Context Protocol](https://modelcontextprotocol.io) host.
 
-Five named tools, 130+ models, async by default.
+16 named tools, 140+ models, async by default.
+
+**Prefer zero install?** PixelDojo also runs a hosted MCP server with OAuth
+sign-in (no API key): point any remote-capable client at
+`https://pixeldojo.ai/api/mcp` and approve in your browser. Setup guides for
+every platform: [pixeldojo.ai/skills](https://pixeldojo.ai/skills). This npm
+package is the local (stdio) twin — same skills, plus local-file uploads.
 
 ## Quick start
 
@@ -34,24 +40,32 @@ Add to your editor's MCP config (e.g. `~/.config/claude-code/mcp.json`):
 }
 ```
 
-Restart your agent. You'll see five new tools.
+Restart your agent. You'll see 16 new tools.
 
 ## Named skills
 
-| Skill | What it does | Default model |
-|---|---|---|
-| `pixeldojo:generate` | Any prompt → image or video | `google-nano-banana` |
-| `pixeldojo:character` | Consistent characters across shots | `ideogram-character` |
-| `pixeldojo:storyboard` | Multi-shot scenes from one brief | `veo-3.1` |
-| `pixeldojo:upscale` | Enhance any image | `magnific-upscaler` |
-| `pixeldojo:status` | Poll long-running jobs after a 30s sync handoff | — |
-
-Each skill takes a `model` field for whitelist-checked overrides. Pass any
-apiId from the [API Platform catalog](https://pixeldojo.ai/api-platform).
+| Skill | What it does |
+|---|---|
+| `pixeldojo:generate` | Any prompt → image or video. Picks the best model, or pass any apiId. |
+| `pixeldojo:edit` | Change an existing image with a text instruction (multi-image capable). |
+| `pixeldojo:character` | Consistent characters across shots. |
+| `pixeldojo:storyboard` | Multi-shot scenes from one brief. |
+| `pixeldojo:upscale` | Enhance any image, up to 16×. |
+| `pixeldojo:audio` | Full audio scenes: dialogue + effects + music in one clip (Seed Audio 1.0). |
+| `pixeldojo:library` | Search your media library: saved My Media + recent generations. |
+| `pixeldojo:save` | Save a result to My Media permanently (outputs otherwise expire in 24h). |
+| `pixeldojo:save_workflow` / `run_workflow` / `list_workflows` | Save a multi-step chain once, run it by name from any chat. |
+| `pixeldojo:upload` | Local file → 24h temp URL, for reference inputs. |
+| `pixeldojo:from_url` | Product page URL → structured product info. Free. |
+| `pixeldojo:campaign` / `campaign_status` | One product URL → hero + lifestyle set + optional video. |
+| `pixeldojo:status` | Poll long-running jobs after a 30s sync handoff. |
+
+Generation skills take a `model` field for whitelist-checked overrides. Pass
+any apiId from the [API Platform catalog](https://pixeldojo.ai/api-platform).
 
 ## How long jobs work
 
-The four generation skills wait synchronously for up to 30 seconds. If the
+Generation skills wait synchronously for up to 30 seconds. If the
 job is still running, they return `{ jobId, statusUrl }` and the LLM follows
 up by calling `pixeldojo:status` with the same `jobId`. Polling uses
 exponential backoff (1s → 2s → 4s → 8s, capped) to keep load low on long

package/dist/cli.cjs

@@ -1147,7 +1147,7 @@ var init_library = __esm({
     };
     librarySkill = {
       name: "pixeldojo:library",
-      description: "Search your own generation history (API/MCP outputs + results kept in the web app). Returns asset URLs to reuse as reference inputs.",
+      description: "Search your media library: saved My Media items (permanent) and recent API/MCP generations (expire after 24h), newest first. Returns asset URLs to reuse as reference inputs. Keep a result forever with pixeldojo:save.",
       inputZod: InputSchema12,
       inputJsonSchema: InputJsonSchema12,
       allowedModels: [],
@@ -1156,6 +1156,52 @@ var init_library = __esm({
     };
   }
 });
+async function run13(input, ctx) {
+  const res = await ctx.client.saveMedia({
+    url: input.url,
+    prompt: input.prompt,
+    tool_name: input.tool_name,
+    modality: input.modality,
+    job_id: input.job_id
+  });
+  return {
+    kind: "text",
+    text: `Saved to My Media (permanent): ${res.url}
+It will appear at https://pixeldojo.ai/my-images and in pixeldojo:library searches.`
+  };
+}
+var InputSchema13, InputJsonSchema13, saveSkill;
+var init_save = __esm({
+  "src/skills/save.ts"() {
+    InputSchema13 = zod.z.object({
+      url: zod.z.string().url().describe("The asset URL to save (image or video)."),
+      prompt: zod.z.string().optional().describe("The prompt that produced it \u2014 makes it findable in the library later."),
+      tool_name: zod.z.string().optional().describe("Tool/model slug that produced it."),
+      modality: zod.z.enum(["image", "video", "audio"]).optional(),
+      job_id: zod.z.string().optional().describe("The jobId that produced this asset, when known.")
+    });
+    InputJsonSchema13 = {
+      type: "object",
+      properties: {
+        url: { type: "string", format: "uri" },
+        prompt: { type: "string" },
+        tool_name: { type: "string" },
+        modality: { type: "string", enum: ["image", "video", "audio"] },
+        job_id: { type: "string" }
+      },
+      required: ["url"]
+    };
+    saveSkill = {
+      name: "pixeldojo:save",
+      description: "Save a generated image or video into the user's My Media library permanently. Generation outputs otherwise expire after 24 hours \u2014 call this when the user wants to keep a result.",
+      inputZod: InputSchema13,
+      inputJsonSchema: InputJsonSchema13,
+      allowedModels: [],
+      defaultModel: "",
+      run: run13
+    };
+  }
+});
 function substitutePlaceholders(args, inputs, prevUrl) {
   const missing = [];
   const fill = (value) => {
@@ -1350,6 +1396,7 @@ __export(skills_exports, {
   librarySkill: () => librarySkill,
   listWorkflowsSkill: () => listWorkflowsSkill,
   runWorkflowSkill: () => runWorkflowSkill,
+  saveSkill: () => saveSkill,
   saveWorkflowSkill: () => saveWorkflowSkill,
   statusSkill: () => statusSkill,
   storyboardSkill: () => storyboardSkill,
@@ -1374,6 +1421,7 @@ var init_skills = __esm({
     init_upload();
     init_audio();
     init_library();
+    init_save();
     init_workflows();
     ALL_SKILLS = [
       generateSkill,
@@ -1383,6 +1431,7 @@ var init_skills = __esm({
       upscaleSkill,
       audioSkill,
       librarySkill,
+      saveSkill,
       saveWorkflowSkill,
       runWorkflowSkill,
       listWorkflowsSkill,
@@ -1610,11 +1659,19 @@ function printInit() {
       `# Same shape as above.`,
       ``,
       `# 3. Restart your agent. You'll see these tools:`,
-      `#    pixeldojo:generate    Any prompt \u2192 image or video.`,
-      `#    pixeldojo:character   Consistent characters across shots.`,
-      `#    pixeldojo:storyboard  Multi-shot scenes from one brief.`,
-      `#    pixeldojo:upscale     Enhance any image.`,
-      `#    pixeldojo:status      Poll long-running jobs.`,
+      `#    pixeldojo:generate       Any prompt \u2192 image or video.`,
+      `#    pixeldojo:edit           Change an image with a text instruction.`,
+      `#    pixeldojo:character      Consistent characters across shots.`,
+      `#    pixeldojo:storyboard     Multi-shot scenes from one brief.`,
+      `#    pixeldojo:upscale        Enhance any image.`,
+      `#    pixeldojo:audio          Voices + effects + music in one clip.`,
+      `#    pixeldojo:library        Search your saved media + generations.`,
+      `#    pixeldojo:save           Keep a result in My Media permanently.`,
+      `#    pixeldojo:*_workflow     Save / run / list multi-step chains.`,
+      `#    pixeldojo:upload         Local file \u2192 temp URL for references.`,
+      `#    pixeldojo:from_url       Product URL \u2192 structured product info.`,
+      `#    pixeldojo:campaign*      Product URL \u2192 full launch pack.`,
+      `#    pixeldojo:status         Poll long-running jobs.`,
       ``
     ].join("\n")
   );