@pixeldojo/mcp 0.15.1 → 0.16.0

package/dist/index.d.cts

@@ -242,6 +242,37 @@ declare function makeAttributedClient(options: MakeClientOptions): PixelDojoClie
 declare const ALL_SKILLS: ReadonlyArray<SkillModule<unknown>>;
 
 declare const HOSTED_SKILLS: ReadonlyArray<SkillModule<unknown>>;
+/**
+ * MCP tool annotations for every skill. ChatGPT's plugin review rejects tools
+ * without readOnlyHint / destructiveHint / openWorldHint, and clients use them
+ * to decide when to ask before a call. Rationale per hint:
+ * - readOnlyHint: false for anything that renders, spends credits or saves.
+ * - destructiveHint: renders are additive (new media, nothing of the user's
+ *   is changed or deleted; failed jobs refund), so false. save_workflow
+ *   overwrites a same-named workflow, so true.
+ * - openWorldHint: everything stays inside the user's own account, except
+ *   from_url, which fetches an arbitrary public page.
+ */
+type Hints = {
+    title: string;
+    readOnlyHint: boolean;
+    destructiveHint: boolean;
+    openWorldHint: boolean;
+};
+declare const TOOL_ANNOTATIONS: Record<string, Hints>;
+/** The tools/list entry for a skill, shared by the stdio server and the hosted /mcp route. */
+declare function toolListing(skill: SkillModule<unknown>): {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        openWorldHint: boolean;
+        title: string;
+    };
+};
 declare function findHostedSkill(name: string): SkillModule<unknown> | undefined;
 /**
  * Skill names were `pixeldojo:<x>` until 2026-07-29. A colon is illegal in a
@@ -286,4 +317,4 @@ declare function makeRedactedLogger(target?: Pick<Console, 'error'>): {
     error(msg: string, ...args: unknown[]): void;
 };
 
-export { ALL_SKILLS, HOSTED_SKILLS, type MakeClientOptions, PACKAGE_VERSION, type PollOptions, type PollResult, type PollableJob, SERVER_INSTRUCTIONS, type ServerOptions, type SkillContext, type SkillModule, type SkillResult, buildServer, errorToActionableMessage, findHostedSkill, findSkill, makeAttributedClient, makeRedactedLogger, pollJobUntilDoneOrHandoff, redactKeys, redactValue, runStdio, skillResultToMcpResponse };
+export { ALL_SKILLS, HOSTED_SKILLS, type MakeClientOptions, PACKAGE_VERSION, type PollOptions, type PollResult, type PollableJob, SERVER_INSTRUCTIONS, type ServerOptions, type SkillContext, type SkillModule, type SkillResult, TOOL_ANNOTATIONS, buildServer, errorToActionableMessage, findHostedSkill, findSkill, makeAttributedClient, makeRedactedLogger, pollJobUntilDoneOrHandoff, redactKeys, redactValue, runStdio, skillResultToMcpResponse, toolListing };

package/dist/index.d.ts

@@ -242,6 +242,37 @@ declare function makeAttributedClient(options: MakeClientOptions): PixelDojoClie
 declare const ALL_SKILLS: ReadonlyArray<SkillModule<unknown>>;
 
 declare const HOSTED_SKILLS: ReadonlyArray<SkillModule<unknown>>;
+/**
+ * MCP tool annotations for every skill. ChatGPT's plugin review rejects tools
+ * without readOnlyHint / destructiveHint / openWorldHint, and clients use them
+ * to decide when to ask before a call. Rationale per hint:
+ * - readOnlyHint: false for anything that renders, spends credits or saves.
+ * - destructiveHint: renders are additive (new media, nothing of the user's
+ *   is changed or deleted; failed jobs refund), so false. save_workflow
+ *   overwrites a same-named workflow, so true.
+ * - openWorldHint: everything stays inside the user's own account, except
+ *   from_url, which fetches an arbitrary public page.
+ */
+type Hints = {
+    title: string;
+    readOnlyHint: boolean;
+    destructiveHint: boolean;
+    openWorldHint: boolean;
+};
+declare const TOOL_ANNOTATIONS: Record<string, Hints>;
+/** The tools/list entry for a skill, shared by the stdio server and the hosted /mcp route. */
+declare function toolListing(skill: SkillModule<unknown>): {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        openWorldHint: boolean;
+        title: string;
+    };
+};
 declare function findHostedSkill(name: string): SkillModule<unknown> | undefined;
 /**
  * Skill names were `pixeldojo:<x>` until 2026-07-29. A colon is illegal in a
@@ -286,4 +317,4 @@ declare function makeRedactedLogger(target?: Pick<Console, 'error'>): {
     error(msg: string, ...args: unknown[]): void;
 };
 
-export { ALL_SKILLS, HOSTED_SKILLS, type MakeClientOptions, PACKAGE_VERSION, type PollOptions, type PollResult, type PollableJob, SERVER_INSTRUCTIONS, type ServerOptions, type SkillContext, type SkillModule, type SkillResult, buildServer, errorToActionableMessage, findHostedSkill, findSkill, makeAttributedClient, makeRedactedLogger, pollJobUntilDoneOrHandoff, redactKeys, redactValue, runStdio, skillResultToMcpResponse };
+export { ALL_SKILLS, HOSTED_SKILLS, type MakeClientOptions, PACKAGE_VERSION, type PollOptions, type PollResult, type PollableJob, SERVER_INSTRUCTIONS, type ServerOptions, type SkillContext, type SkillModule, type SkillResult, TOOL_ANNOTATIONS, buildServer, errorToActionableMessage, findHostedSkill, findSkill, makeAttributedClient, makeRedactedLogger, pollJobUntilDoneOrHandoff, redactKeys, redactValue, runStdio, skillResultToMcpResponse, toolListing };

package/dist/index.js

@@ -3050,6 +3050,7 @@ var skills_exports = {};
 __export(skills_exports, {
   ALL_SKILLS: () => ALL_SKILLS,
   HOSTED_SKILLS: () => HOSTED_SKILLS,
+  TOOL_ANNOTATIONS: () => TOOL_ANNOTATIONS,
   adSkill: () => adSkill,
   audioSkill: () => audioSkill,
   campaignSkill: () => campaignSkill,
@@ -3068,10 +3069,21 @@ __export(skills_exports, {
   saveWorkflowSkill: () => saveWorkflowSkill,
   statusSkill: () => statusSkill,
   storyboardSkill: () => storyboardSkill,
+  toolListing: () => toolListing,
   uploadSkill: () => uploadSkill,
   upscaleSkill: () => upscaleSkill,
   videoSkill: () => videoSkill
 });
+function toolListing(skill) {
+  const { title, ...hints } = TOOL_ANNOTATIONS[skill.name];
+  return {
+    name: skill.name,
+    title,
+    description: skill.description,
+    inputSchema: skill.inputJsonSchema,
+    annotations: { title, ...hints }
+  };
+}
 function findHostedSkill(name) {
   const wanted = name.replace(/^pixeldojo:/, "pixeldojo_");
   return HOSTED_SKILLS.find((s) => s.name === wanted);
@@ -3080,7 +3092,7 @@ function findSkill(name) {
   const wanted = name.replace(/^pixeldojo:/, "pixeldojo_");
   return ALL_SKILLS.find((s) => s.name === wanted);
 }
-var ALL_SKILLS, isLocalPathField, HOSTED_SKILLS;
+var ALL_SKILLS, isLocalPathField, HOSTED_SKILLS, render, read, TOOL_ANNOTATIONS;
 var init_skills = __esm({
   "src/skills/index.ts"() {
     init_generate();
@@ -3135,6 +3147,29 @@ var init_skills = __esm({
         }
       };
     });
+    render = (title) => ({ title, readOnlyHint: false, destructiveHint: false, openWorldHint: false });
+    read = (title) => ({ title, readOnlyHint: true, destructiveHint: false, openWorldHint: false });
+    TOOL_ANNOTATIONS = {
+      pixeldojo_generate: render("Generate image or video"),
+      pixeldojo_edit: render("Edit image"),
+      pixeldojo_character: render("Consistent character image"),
+      pixeldojo_storyboard: render("Storyboard preview video"),
+      pixeldojo_upscale: render("Upscale image or video"),
+      pixeldojo_audio: render("Generate music, speech or sound"),
+      pixeldojo_video: render("Change, animate or extend video"),
+      pixeldojo_ad: render("Make video ad"),
+      pixeldojo_campaign: render("Make product launch campaign"),
+      pixeldojo_film: render("Make short film"),
+      pixeldojo_episode: render("Make faceless video"),
+      pixeldojo_run_workflow: render("Run saved workflow"),
+      pixeldojo_upload: render("Upload local file"),
+      pixeldojo_save_workflow: { ...render("Save workflow"), destructiveHint: true },
+      pixeldojo_status: read("Check job status"),
+      pixeldojo_campaign_status: read("Check campaign status"),
+      pixeldojo_library: read("Search media library"),
+      pixeldojo_list_workflows: read("List saved workflows"),
+      pixeldojo_from_url: { ...read("Read product page"), openWorldHint: true }
+    };
   }
 });
 function makeAttributedClient(options) {
@@ -3188,7 +3223,7 @@ function makeRedactedLogger(target = console) {
 }
 
 // src/server.ts
-var PACKAGE_VERSION = "0.15.1" ;
+var PACKAGE_VERSION = "0.16.0" ;
 var SERVER_INSTRUCTIONS = "PixelDojo generates images, video, audio and short films across 100+ models, billed in credits from the connected PixelDojo account. A job that runs past the 30-second wait returns a jobId to check later; check it rather than submitting again, since every new submission is charged. Generated asset URLs are deleted one hour after they are created, so download anything the user wants to keep. Finished films are the exception and stay in the account library.";
 function buildServer(options) {
   if (!options.apiKey) {
@@ -3213,11 +3248,7 @@ function buildServer(options) {
   );
   server.setRequestHandler(ListToolsRequestSchema, async () => {
     return {
-      tools: ALL_SKILLS.map((skill) => ({
-        name: skill.name,
-        description: skill.description,
-        inputSchema: skill.inputJsonSchema
-      }))
+      tools: ALL_SKILLS.map(toolListing)
     };
   });
   server.setRequestHandler(CallToolRequestSchema, async (req) => {
@@ -3333,6 +3364,6 @@ async function runStdio(options) {
 init_skills();
 init_poll();
 
-export { ALL_SKILLS, HOSTED_SKILLS, PACKAGE_VERSION, SERVER_INSTRUCTIONS, buildServer, errorToActionableMessage, findHostedSkill, findSkill, makeAttributedClient, makeRedactedLogger, pollJobUntilDoneOrHandoff, redactKeys, redactValue, runStdio, skillResultToMcpResponse };
+export { ALL_SKILLS, HOSTED_SKILLS, PACKAGE_VERSION, SERVER_INSTRUCTIONS, TOOL_ANNOTATIONS, buildServer, errorToActionableMessage, findHostedSkill, findSkill, makeAttributedClient, makeRedactedLogger, pollJobUntilDoneOrHandoff, redactKeys, redactValue, runStdio, skillResultToMcpResponse, toolListing };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map