@pixeldojo/mcp 0.12.0 → 0.13.1

package/dist/index.d.cts

@@ -78,6 +78,12 @@ interface SkillContext {
     baseUrl: string;
     /** Resolved version string for the source attribution header. */
     mcpVersion: string;
+    /**
+     * True only where "local" means the caller's own machine (the stdio npm
+     * server). The hosted /api/mcp route leaves it unset: there `*_path`
+     * fields would read the production container's disk. Fail-closed.
+     */
+    localFiles?: boolean;
     /** Optional logger that already redacts pd_xxx tokens. */
     logger: {
         error: (msg: string, ...args: unknown[]) => void;
@@ -115,6 +121,8 @@ interface SkillModule<TInput = unknown> {
     name: string;
     /** One-line description shown in `tools/list` to the LLM host. */
     description: string;
+    /** Replaces `description` on the hosted server when it advertises `*_path` fields. */
+    hostedDescription?: string;
     /** Zod schema for typed parsing inside the skill. */
     inputZod: z.ZodType<TInput>;
     /** JSON Schema (object) version for the MCP `tools/list` payload. */
@@ -146,6 +154,14 @@ interface SkillModule<TInput = unknown> {
  */
 
 declare const PACKAGE_VERSION: string;
+/**
+ * Server-level context sent on `initialize`, shared by this stdio server and
+ * the hosted /api/mcp route. Facts that span tools only: tool choice belongs
+ * in each tool's own description. API/MCP outputs live under the temp
+ * bucket's api-outputs/ folder and are swept one hour after they land;
+ * finished films are saved to the account library, so they stay.
+ */
+declare const 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.";
 interface ServerOptions {
     apiKey: string;
     baseUrl?: string;
@@ -225,6 +241,8 @@ declare function makeAttributedClient(options: MakeClientOptions): PixelDojoClie
 
 declare const ALL_SKILLS: ReadonlyArray<SkillModule<unknown>>;
 
+declare const HOSTED_SKILLS: ReadonlyArray<SkillModule<unknown>>;
+declare function findHostedSkill(name: string): SkillModule<unknown> | undefined;
 /**
  * Skill names were `pixeldojo:<x>` until 2026-07-29. A colon is illegal in a
  * tool name per Anthropic's `^[a-zA-Z0-9_-]{1,64}$`, so claude.ai's remote-MCP
@@ -268,4 +286,4 @@ declare function makeRedactedLogger(target?: Pick<Console, 'error'>): {
     error(msg: string, ...args: unknown[]): void;
 };
 
-export { ALL_SKILLS, type MakeClientOptions, PACKAGE_VERSION, type PollOptions, type PollResult, type PollableJob, type ServerOptions, type SkillContext, type SkillModule, type SkillResult, buildServer, errorToActionableMessage, 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, buildServer, errorToActionableMessage, findHostedSkill, findSkill, makeAttributedClient, makeRedactedLogger, pollJobUntilDoneOrHandoff, redactKeys, redactValue, runStdio, skillResultToMcpResponse };

package/dist/index.d.ts

@@ -78,6 +78,12 @@ interface SkillContext {
     baseUrl: string;
     /** Resolved version string for the source attribution header. */
     mcpVersion: string;
+    /**
+     * True only where "local" means the caller's own machine (the stdio npm
+     * server). The hosted /api/mcp route leaves it unset: there `*_path`
+     * fields would read the production container's disk. Fail-closed.
+     */
+    localFiles?: boolean;
     /** Optional logger that already redacts pd_xxx tokens. */
     logger: {
         error: (msg: string, ...args: unknown[]) => void;
@@ -115,6 +121,8 @@ interface SkillModule<TInput = unknown> {
     name: string;
     /** One-line description shown in `tools/list` to the LLM host. */
     description: string;
+    /** Replaces `description` on the hosted server when it advertises `*_path` fields. */
+    hostedDescription?: string;
     /** Zod schema for typed parsing inside the skill. */
     inputZod: z.ZodType<TInput>;
     /** JSON Schema (object) version for the MCP `tools/list` payload. */
@@ -146,6 +154,14 @@ interface SkillModule<TInput = unknown> {
  */
 
 declare const PACKAGE_VERSION: string;
+/**
+ * Server-level context sent on `initialize`, shared by this stdio server and
+ * the hosted /api/mcp route. Facts that span tools only: tool choice belongs
+ * in each tool's own description. API/MCP outputs live under the temp
+ * bucket's api-outputs/ folder and are swept one hour after they land;
+ * finished films are saved to the account library, so they stay.
+ */
+declare const 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.";
 interface ServerOptions {
     apiKey: string;
     baseUrl?: string;
@@ -225,6 +241,8 @@ declare function makeAttributedClient(options: MakeClientOptions): PixelDojoClie
 
 declare const ALL_SKILLS: ReadonlyArray<SkillModule<unknown>>;
 
+declare const HOSTED_SKILLS: ReadonlyArray<SkillModule<unknown>>;
+declare function findHostedSkill(name: string): SkillModule<unknown> | undefined;
 /**
  * Skill names were `pixeldojo:<x>` until 2026-07-29. A colon is illegal in a
  * tool name per Anthropic's `^[a-zA-Z0-9_-]{1,64}$`, so claude.ai's remote-MCP
@@ -268,4 +286,4 @@ declare function makeRedactedLogger(target?: Pick<Console, 'error'>): {
     error(msg: string, ...args: unknown[]): void;
 };
 
-export { ALL_SKILLS, type MakeClientOptions, PACKAGE_VERSION, type PollOptions, type PollResult, type PollableJob, type ServerOptions, type SkillContext, type SkillModule, type SkillResult, buildServer, errorToActionableMessage, 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, buildServer, errorToActionableMessage, findHostedSkill, findSkill, makeAttributedClient, makeRedactedLogger, pollJobUntilDoneOrHandoff, redactKeys, redactValue, runStdio, skillResultToMcpResponse };