@puppetry.com/sdk 0.1.0

package/dist/chunk-QK5VPBL7.mjs

@@ -0,0 +1,1500 @@
+// src/errors.ts
+var PuppetryError = class _PuppetryError extends Error {
+  constructor(status, code, message, details, options) {
+    super(message);
+    this.name = "PuppetryError";
+    this.status = status;
+    this.code = code;
+    this.details = details;
+    this.object = options?.object;
+    this.retryAfter = options?.retryAfter;
+    this.retryable = options?.retryable;
+    this.credits = options?.credits;
+    this.creationCredits = options?.creationCredits ?? options?.creation_credits;
+    this.creation_credits = this.creationCredits;
+    this.retryBlockedReason = options?.retryBlockedReason ?? options?.retry_blocked_reason;
+    this.retry_blocked_reason = this.retryBlockedReason;
+    this.retryBlockCode = options?.retryBlockCode ?? options?.retry_block_code;
+    this.retry_block_code = this.retryBlockCode;
+    this.jobId = options?.jobId ?? options?.job_id ?? options?.id;
+    this.job_id = this.jobId;
+    this.id = this.jobId;
+    this.operationId = options?.operationId ?? options?.operation_id;
+    this.operation_id = this.operationId;
+    this.taskId = options?.taskId ?? options?.task_id ?? this.jobId;
+    this.task_id = this.taskId;
+    this.statusUrl = options?.statusUrl ?? options?.status_url ?? options?.contentLocation ?? options?.content_location;
+    this.status_url = this.statusUrl;
+    this.contentLocation = options?.contentLocation ?? options?.content_location ?? options?.statusUrl ?? options?.status_url;
+    this.content_location = this.contentLocation;
+    this.createdAt = options?.createdAt ?? options?.created_at;
+    this.created_at = this.createdAt;
+    this.expiresAt = options?.expiresAt ?? options?.expires_at;
+    this.expires_at = this.expiresAt;
+    this.nextPollAt = options?.nextPollAt ?? options?.next_poll_at;
+    this.next_poll_at = this.nextPollAt;
+    this.source = options?.source ?? options?.requestSource ?? options?.request_source;
+    this.requestSource = options?.requestSource ?? options?.request_source ?? this.source;
+    this.request_source = this.requestSource;
+    this.requestId = options?.requestId ?? options?.request_id;
+    this.request_id = this.requestId;
+    this.requiredCredits = options?.requiredCredits ?? options?.required_credits;
+    this.required_credits = this.requiredCredits;
+    this.creditsRemaining = options?.creditsRemaining ?? options?.credits_remaining ?? options?.remainingCredits ?? options?.remaining_credits;
+    this.credits_remaining = this.creditsRemaining;
+    this.remainingCredits = this.creditsRemaining;
+    this.remaining_credits = this.creditsRemaining;
+  }
+  static fromResponse(status, body, options) {
+    return new _PuppetryError(status, body.error, body.message, body.details, {
+      ...options,
+      ...retryMetadataFromApiError(body),
+      ...creditReadinessMetadataFromApiError(body),
+      ...jobCorrelationMetadataFromApiError(body)
+    });
+  }
+};
+var PuppetryTimeoutError = class extends PuppetryError {
+  constructor(timeoutMs) {
+    super(408, "timeout", `Request timed out after ${timeoutMs}ms`);
+    this.name = "PuppetryTimeoutError";
+  }
+};
+function retryMetadataFromApiError(body) {
+  const readinessDetails = objectFromKeys(
+    body.details,
+    "video_generation",
+    "videoGeneration"
+  );
+  const readinessBlocker = firstObjectFromArrayKeys(
+    readinessDetails,
+    "blockers"
+  );
+  const retryable = typeof body.retryable === "boolean" ? body.retryable : typeof body.details?.retryable === "boolean" ? body.details.retryable : typeof readinessDetails?.retryable === "boolean" ? readinessDetails.retryable : typeof readinessBlocker?.retryable === "boolean" ? readinessBlocker.retryable : void 0;
+  const retryBlockedReason = stringFromAliases(body, "retryBlockedReason", "retry_blocked_reason") ?? stringFromAliases(
+    body.details,
+    "retryBlockedReason",
+    "retry_blocked_reason"
+  ) ?? stringFromAliases(
+    readinessDetails,
+    "retryBlockedReason",
+    "retry_blocked_reason"
+  ) ?? stringFromAliases(
+    readinessBlocker,
+    "retryBlockedReason",
+    "retry_blocked_reason"
+  ) ?? stringFromKeys(readinessBlocker, "reason", "code") ?? stringFromKeys(readinessDetails, "reason");
+  const retryBlockCode = stringFromAliases(body, "retryBlockCode", "retry_block_code") ?? stringFromAliases(body.details, "retryBlockCode", "retry_block_code") ?? stringFromAliases(readinessDetails, "retryBlockCode", "retry_block_code") ?? stringFromAliases(readinessBlocker, "retryBlockCode", "retry_block_code") ?? stringFromKeys(readinessBlocker, "code");
+  return {
+    ...retryable !== void 0 ? { retryable } : {},
+    ...retryBlockedReason ? {
+      retry_blocked_reason: retryBlockedReason,
+      retryBlockedReason
+    } : {},
+    ...retryBlockCode ? {
+      retry_block_code: retryBlockCode,
+      retryBlockCode
+    } : {}
+  };
+}
+function jobCorrelationMetadataFromApiError(body) {
+  const readinessDetails = objectFromKeys(
+    body.details,
+    "video_generation",
+    "videoGeneration"
+  );
+  const object = stringFromKeys(body, "object") ?? stringFromKeys(body.details, "object");
+  const jobId = stringFromKeys(body, "jobId", "job_id", "id") ?? stringFromKeys(body.details, "jobId", "job_id", "id");
+  const operationId = stringFromKeys(body, "operationId", "operation_id") ?? stringFromKeys(body.details, "operationId", "operation_id");
+  const taskId = stringFromKeys(body, "taskId", "task_id") ?? stringFromKeys(body.details, "taskId", "task_id") ?? jobId;
+  const bodyStatusUrl = stringFromKeys(body, "statusUrl", "status_url") ?? stringFromKeys(body.details, "statusUrl", "status_url");
+  const bodyContentLocation = stringFromKeys(body, "contentLocation", "content_location") ?? stringFromKeys(body.details, "contentLocation", "content_location");
+  const statusUrl = bodyStatusUrl ?? bodyContentLocation;
+  const contentLocation = bodyContentLocation ?? bodyStatusUrl;
+  const createdAt = stringFromKeys(body, "createdAt", "created_at") ?? stringFromKeys(body.details, "createdAt", "created_at");
+  const expiresAt = stringFromKeys(body, "expiresAt", "expires_at") ?? stringFromKeys(body.details, "expiresAt", "expires_at");
+  const nextPollAt = stringFromKeys(body, "nextPollAt", "next_poll_at") ?? stringFromKeys(body.details, "nextPollAt", "next_poll_at") ?? stringFromKeys(readinessDetails, "nextPollAt", "next_poll_at");
+  const source = stringFromKeys(body, "source") ?? stringFromKeys(body.details, "source");
+  const requestSource = stringFromKeys(body, "requestSource", "request_source") ?? stringFromKeys(body.details, "requestSource", "request_source") ?? source;
+  const requestId = stringFromKeys(body, "requestId", "request_id") ?? stringFromKeys(body.details, "requestId", "request_id") ?? stringFromKeys(readinessDetails, "requestId", "request_id");
+  const credits = statusCreditsFromKeys(body, "credits") ?? statusCreditsFromKeys(body.details, "credits");
+  const creationCredits = creationCreditsFromKeys(body, "creationCredits", "creation_credits") ?? creationCreditsFromKeys(
+    body.details,
+    "creationCredits",
+    "creation_credits"
+  );
+  return {
+    ...object ? { object } : {},
+    ...jobId ? { id: jobId, job_id: jobId, jobId } : {},
+    ...operationId ? { operation_id: operationId, operationId } : {},
+    ...taskId ? { task_id: taskId, taskId } : {},
+    ...statusUrl ? { status_url: statusUrl, statusUrl } : {},
+    ...contentLocation ? { content_location: contentLocation, contentLocation } : {},
+    ...createdAt ? { created_at: createdAt, createdAt } : {},
+    ...expiresAt ? { expires_at: expiresAt, expiresAt } : {},
+    ...nextPollAt ? { next_poll_at: nextPollAt, nextPollAt } : {},
+    ...source ? { source } : {},
+    ...requestSource ? { request_source: requestSource, requestSource } : {},
+    ...requestId ? { request_id: requestId, requestId } : {},
+    ...credits ? { credits } : {},
+    ...creationCredits ? { creation_credits: creationCredits, creationCredits } : {}
+  };
+}
+function creditReadinessMetadataFromApiError(body) {
+  const readinessDetails = objectFromKeys(
+    body.details,
+    "video_generation",
+    "videoGeneration"
+  );
+  const readinessBlocker = firstObjectFromArrayKeys(
+    readinessDetails,
+    "blockers"
+  );
+  const requiredCredits = numberFromKeys(body, "requiredCredits", "required_credits") ?? numberFromKeys(body.details, "requiredCredits", "required_credits") ?? numberFromKeys(readinessDetails, "requiredCredits", "required_credits") ?? numberFromKeys(readinessBlocker, "requiredCredits", "required_credits");
+  const creditsRemaining = numberFromKeys(
+    body,
+    "creditsRemaining",
+    "credits_remaining",
+    "remainingCredits",
+    "remaining_credits"
+  ) ?? numberFromKeys(
+    body.details,
+    "creditsRemaining",
+    "credits_remaining",
+    "remainingCredits",
+    "remaining_credits"
+  ) ?? numberFromKeys(readinessDetails, "creditsRemaining", "credits_remaining") ?? numberFromKeys(
+    readinessBlocker,
+    "creditsRemaining",
+    "credits_remaining",
+    "remainingCredits",
+    "remaining_credits"
+  );
+  return {
+    ...requiredCredits !== void 0 ? { required_credits: requiredCredits, requiredCredits } : {},
+    ...creditsRemaining !== void 0 ? {
+      credits_remaining: creditsRemaining,
+      creditsRemaining,
+      remaining_credits: creditsRemaining,
+      remainingCredits: creditsRemaining
+    } : {}
+  };
+}
+function stringFromAliases(record, camelKey, snakeKey) {
+  return stringFromKeys(record, camelKey, snakeKey);
+}
+function stringFromKeys(record, ...keys) {
+  if (!record) return void 0;
+  const source = record;
+  const value = keys.map((key) => source[key]).find((item) => item !== void 0);
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed || void 0;
+}
+function objectFromKeys(record, ...keys) {
+  if (!record) return void 0;
+  const source = record;
+  const value = keys.map((key) => source[key]).find((item) => item !== void 0);
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return void 0;
+  }
+  return value;
+}
+function statusCreditsFromKeys(record, ...keys) {
+  const value = objectFromKeys(record, ...keys);
+  if (!value) return void 0;
+  const charged = numberFromKeys(value, "charged");
+  const remaining = nullableNumberFromKeys(value, "remaining");
+  if (charged === void 0 || remaining === void 0) return void 0;
+  return { charged, remaining };
+}
+function creationCreditsFromKeys(record, ...keys) {
+  const value = objectFromKeys(record, ...keys);
+  if (!value) return void 0;
+  const charged = numberFromKeys(value, "charged");
+  const remainingAfterDebit = nullableNumberFromKeys(
+    value,
+    "remainingAfterDebit",
+    "remaining_after_debit"
+  );
+  if (charged === void 0 || remainingAfterDebit === void 0) {
+    return void 0;
+  }
+  return {
+    charged,
+    remaining_after_debit: remainingAfterDebit,
+    remainingAfterDebit
+  };
+}
+function numberFromKeys(record, ...keys) {
+  if (!record) return void 0;
+  const source = record;
+  const value = keys.map((key) => source[key]).find((item) => item !== void 0);
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function nullableNumberFromKeys(record, ...keys) {
+  if (!record) return void 0;
+  const source = record;
+  const value = keys.map((key) => source[key]).find((item) => item !== void 0);
+  if (value === null) return null;
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function firstObjectFromArrayKeys(record, ...keys) {
+  if (!record) return void 0;
+  const source = record;
+  const value = keys.map((key) => source[key]).find((item) => Array.isArray(item));
+  const first = Array.isArray(value) ? value[0] : void 0;
+  if (!first || typeof first !== "object" || Array.isArray(first)) {
+    return void 0;
+  }
+  return first;
+}
+var PuppetryAuthError = class extends PuppetryError {
+  constructor(message = "Invalid or missing API key") {
+    super(401, "unauthorized", message);
+    this.name = "PuppetryAuthError";
+  }
+};
+var PuppetryRateLimitError = class _PuppetryRateLimitError extends PuppetryError {
+  constructor(retryAfter, message = "Rate limit exceeded", details, code = "rate_limited", options) {
+    super(429, code, message, details, {
+      ...options,
+      retryAfter,
+      retryable: options?.retryable ?? (typeof details?.retryable === "boolean" ? details.retryable : void 0)
+    });
+    this.name = "PuppetryRateLimitError";
+  }
+  static fromRateLimitResponse(body, options) {
+    return new _PuppetryRateLimitError(
+      options?.retryAfter,
+      body.message,
+      body.details,
+      body.error || "rate_limited",
+      {
+        ...options,
+        ...retryMetadataFromApiError(body),
+        ...creditReadinessMetadataFromApiError(body),
+        ...jobCorrelationMetadataFromApiError(body)
+      }
+    );
+  }
+};
+var PuppetryNetworkError = class extends PuppetryError {
+  constructor(message = "Network request failed") {
+    super(0, "network_error", message);
+    this.name = "PuppetryNetworkError";
+  }
+};
+function puppetryErrorData(err) {
+  const videoGenerationReadiness = videoGenerationReadinessFromDetails(
+    err.details
+  );
+  return {
+    status: err.status,
+    statusCode: err.status,
+    code: err.code,
+    message: err.message,
+    ...err.object ? { object: err.object } : {},
+    ...err.retryAfter !== void 0 ? {
+      retry_after_seconds: err.retryAfter,
+      retryAfterSeconds: err.retryAfter,
+      retryAfter: err.retryAfter
+    } : {},
+    ...err.retryable !== void 0 ? { retryable: err.retryable } : {},
+    ...err.credits ? { credits: err.credits } : {},
+    ...err.creationCredits ? {
+      creation_credits: err.creationCredits,
+      creationCredits: err.creationCredits
+    } : {},
+    ...err.retryBlockedReason ? {
+      retry_blocked_reason: err.retryBlockedReason,
+      retryBlockedReason: err.retryBlockedReason
+    } : {},
+    ...err.retryBlockCode ? {
+      retry_block_code: err.retryBlockCode,
+      retryBlockCode: err.retryBlockCode
+    } : {},
+    ...err.jobId ? { id: err.jobId, job_id: err.jobId, jobId: err.jobId } : {},
+    ...err.operationId ? { operation_id: err.operationId, operationId: err.operationId } : {},
+    ...err.taskId ? { task_id: err.taskId, taskId: err.taskId } : {},
+    ...err.statusUrl ? { status_url: err.statusUrl, statusUrl: err.statusUrl } : {},
+    ...err.contentLocation ? {
+      content_location: err.contentLocation,
+      contentLocation: err.contentLocation
+    } : {},
+    ...err.createdAt ? { created_at: err.createdAt, createdAt: err.createdAt } : {},
+    ...err.expiresAt ? { expires_at: err.expiresAt, expiresAt: err.expiresAt } : {},
+    ...err.nextPollAt ? { next_poll_at: err.nextPollAt, nextPollAt: err.nextPollAt } : {},
+    ...err.source ? {
+      source: err.source,
+      request_source: err.requestSource ?? err.source,
+      requestSource: err.requestSource ?? err.source
+    } : {},
+    ...err.requestId ? { request_id: err.requestId, requestId: err.requestId } : {},
+    ...err.requiredCredits !== void 0 ? {
+      required_credits: err.requiredCredits,
+      requiredCredits: err.requiredCredits
+    } : {},
+    ...err.creditsRemaining !== void 0 ? {
+      credits_remaining: err.creditsRemaining,
+      creditsRemaining: err.creditsRemaining,
+      remaining_credits: err.creditsRemaining,
+      remainingCredits: err.creditsRemaining
+    } : {},
+    ...videoGenerationReadiness ? {
+      video_generation: videoGenerationReadiness,
+      videoGeneration: videoGenerationReadiness
+    } : {},
+    ...err.details !== void 0 ? { details: err.details } : {}
+  };
+}
+function videoGenerationReadinessFromDetails(details) {
+  const readiness = objectFromKeys(
+    details,
+    "video_generation",
+    "videoGeneration"
+  );
+  if (!readiness) return void 0;
+  const canCreate = booleanFromKeys(readiness, "canCreate", "can_create");
+  const requiredCredits = numberFromKeys(
+    readiness,
+    "requiredCredits",
+    "required_credits"
+  );
+  const creditsRemaining = numberFromKeys(
+    readiness,
+    "creditsRemaining",
+    "credits_remaining"
+  );
+  const retryAfterSeconds = numberFromKeys(
+    readiness,
+    "retryAfterSeconds",
+    "retryAfter",
+    "retry_after_seconds"
+  );
+  const nextPollAt = stringFromKeys(readiness, "nextPollAt", "next_poll_at");
+  return {
+    ...readiness,
+    ...canCreate === void 0 ? {} : { can_create: canCreate, canCreate },
+    ...requiredCredits === void 0 ? {} : { required_credits: requiredCredits, requiredCredits },
+    ...creditsRemaining === void 0 ? {} : { credits_remaining: creditsRemaining, creditsRemaining },
+    ...retryAfterSeconds === void 0 ? {} : {
+      retry_after_seconds: retryAfterSeconds,
+      retryAfter: retryAfterSeconds,
+      retryAfterSeconds
+    },
+    ...nextPollAt === void 0 ? {} : { next_poll_at: nextPollAt, nextPollAt }
+  };
+}
+function booleanFromKeys(record, ...keys) {
+  if (!record) return void 0;
+  const source = record;
+  const value = keys.map((key) => source[key]).find((item) => item !== void 0);
+  return typeof value === "boolean" ? value : void 0;
+}
+
+// src/agentTools.ts
+var imageUrlAliasRequirement = {
+  anyOf: [
+    { required: ["image_url"] },
+    { required: ["imageUrl"] },
+    { required: ["image"] },
+    { required: ["portrait"] },
+    { required: ["portrait_url"] },
+    { required: ["portraitUrl"] },
+    { required: ["avatar"] },
+    { required: ["avatarUrl"] },
+    { required: ["avatar_url"] },
+    { required: ["photo"] },
+    { required: ["photoUrl"] },
+    { required: ["photo_url"] }
+  ]
+};
+var textScriptAliasRequirement = {
+  anyOf: [
+    { required: ["text"] },
+    { required: ["script"] },
+    { required: ["prompt"] }
+  ]
+};
+var audioUrlAliasRequirement = {
+  anyOf: [
+    { required: ["audio_url"] },
+    { required: ["audioUrl"] },
+    { required: ["audio"] }
+  ]
+};
+var audioUploadReservationRequirement = {
+  allOf: [
+    {
+      anyOf: [
+        { required: ["mime_type"] },
+        { required: ["mimeType"] },
+        { required: ["contentType"] }
+      ]
+    },
+    {
+      anyOf: [
+        { required: ["content_length"] },
+        { required: ["contentLength"] },
+        { required: ["sizeBytes"] },
+        { required: ["file_size"] },
+        { required: ["fileSize"] }
+      ]
+    }
+  ]
+};
+var jobIdAliasRequirement = {
+  anyOf: [
+    { required: ["jobId"] },
+    { required: ["job_id"] },
+    { required: ["task_id"] },
+    { required: ["taskId"] },
+    { required: ["id"] }
+  ]
+};
+var waitOptionsProperties = {
+  intervalMs: {
+    type: "number",
+    description: "Polling interval in milliseconds. Defaults to 2000."
+  },
+  timeoutMs: {
+    type: "number",
+    description: "Maximum wait time in milliseconds. Defaults to 300000."
+  },
+  initialDelayMs: {
+    type: "number",
+    description: "Optional delay before the first status request, useful with Retry-After."
+  }
+};
+var readinessPreflightProperties = {
+  preflightReadiness: {
+    type: "boolean",
+    description: "Check video credits and active slots before queueing. Defaults to false on create-only tools and true on create-and-wait tools."
+  },
+  preflight_readiness: {
+    type: "boolean",
+    description: "Snake_case alias for preflightReadiness."
+  }
+};
+function resolveJobIdAlias(input) {
+  const aliases = [
+    { name: "jobId", value: input.jobId },
+    { name: "job_id", value: input.job_id },
+    { name: "task_id", value: input.task_id },
+    { name: "taskId", value: input.taskId },
+    { name: "id", value: input.id }
+  ];
+  const provided = aliases.filter((alias) => alias.value);
+  const first = provided[0];
+  if (!first?.value) {
+    throw new PuppetryError(
+      400,
+      "invalid_request",
+      "Pass one of jobId, job_id, task_id, taskId, id"
+    );
+  }
+  const conflictingAlias = provided.find(
+    (alias) => alias.value !== first.value
+  );
+  if (conflictingAlias) {
+    throw new PuppetryError(
+      400,
+      "invalid_request",
+      "Pass one of jobId, job_id, task_id, taskId, id, not conflicting values"
+    );
+  }
+  return first.value;
+}
+var PUPPETRY_AGENT_TOOLS = [
+  {
+    name: "puppetry_create_video_from_text",
+    resource: "videos.createFromText",
+    description: "Create a talking-head video from a portrait image and text.",
+    inputSchema: {
+      type: "object",
+      required: [],
+      allOf: [textScriptAliasRequirement, imageUrlAliasRequirement],
+      properties: {
+        text: {
+          type: "string",
+          description: "Script to synthesize and animate."
+        },
+        script: {
+          type: "string",
+          description: "Alias for text script to synthesize and animate."
+        },
+        prompt: {
+          type: "string",
+          description: "Alias for text script, useful for prompt-oriented agents."
+        },
+        image_url: {
+          type: "string",
+          description: "Hosted portrait image URL."
+        },
+        imageUrl: {
+          type: "string",
+          description: "Hosted portrait image URL alias."
+        },
+        image: {
+          type: "string",
+          description: "Hosted portrait image URL alias for agents."
+        },
+        portrait: {
+          type: "string",
+          description: "Deprecated hosted portrait image URL alias."
+        },
+        portrait_url: {
+          type: "string",
+          description: "Hosted portrait image URL snake_case alias."
+        },
+        portraitUrl: {
+          type: "string",
+          description: "Hosted portrait image URL alias."
+        },
+        avatar: {
+          type: "string",
+          description: "Hosted avatar image URL alias."
+        },
+        avatarUrl: {
+          type: "string",
+          description: "Hosted avatar image URL alias."
+        },
+        avatar_url: {
+          type: "string",
+          description: "Hosted avatar image URL snake_case alias."
+        },
+        photo: {
+          type: "string",
+          description: "Hosted photo image URL alias."
+        },
+        photoUrl: {
+          type: "string",
+          description: "Hosted photo image URL alias."
+        },
+        photo_url: {
+          type: "string",
+          description: "Hosted photo image URL snake_case alias."
+        },
+        voice_id: {
+          type: "string",
+          description: "Optional Puppetry voice ID from voices.listPuppetry()."
+        },
+        voiceId: {
+          type: "string",
+          description: "Optional Puppetry voice ID alias."
+        },
+        voice: {
+          type: "string",
+          description: "Optional Puppetry voice ID alias for SDK examples."
+        },
+        language: {
+          type: "string",
+          description: "Optional language code, such as en."
+        },
+        expressiveness: {
+          type: "number",
+          description: "Optional animation expressiveness from 0 to 2."
+        },
+        idempotencyKey: {
+          type: "string",
+          description: "Optional retry key sent as Idempotency-Key."
+        },
+        idempotency_key: {
+          type: "string",
+          description: "Optional retry key alias sent as Idempotency-Key."
+        },
+        ...readinessPreflightProperties
+      }
+    }
+  },
+  {
+    name: "puppetry_create_video_from_audio",
+    resource: "videos.createFromAudio",
+    description: "Create a talking-head video from a portrait image and audio.",
+    inputSchema: {
+      type: "object",
+      required: [],
+      allOf: [imageUrlAliasRequirement, audioUrlAliasRequirement],
+      properties: {
+        audio_url: {
+          type: "string",
+          description: "Hosted audio URL."
+        },
+        audioUrl: {
+          type: "string",
+          description: "Hosted audio URL alias."
+        },
+        audio: {
+          type: "string",
+          description: "Hosted audio URL alias for agents."
+        },
+        image_url: {
+          type: "string",
+          description: "Hosted portrait image URL."
+        },
+        imageUrl: {
+          type: "string",
+          description: "Hosted portrait image URL alias."
+        },
+        image: {
+          type: "string",
+          description: "Hosted portrait image URL alias for agents."
+        },
+        portrait: {
+          type: "string",
+          description: "Deprecated hosted portrait image URL alias."
+        },
+        portrait_url: {
+          type: "string",
+          description: "Hosted portrait image URL snake_case alias."
+        },
+        portraitUrl: {
+          type: "string",
+          description: "Hosted portrait image URL alias."
+        },
+        avatar: {
+          type: "string",
+          description: "Hosted avatar image URL alias."
+        },
+        avatarUrl: {
+          type: "string",
+          description: "Hosted avatar image URL alias."
+        },
+        avatar_url: {
+          type: "string",
+          description: "Hosted avatar image URL snake_case alias."
+        },
+        photo: {
+          type: "string",
+          description: "Hosted photo image URL alias."
+        },
+        photoUrl: {
+          type: "string",
+          description: "Hosted photo image URL alias."
+        },
+        photo_url: {
+          type: "string",
+          description: "Hosted photo image URL snake_case alias."
+        },
+        expressiveness: {
+          type: "number",
+          description: "Optional animation expressiveness from 0 to 2."
+        },
+        idempotencyKey: {
+          type: "string",
+          description: "Optional retry key sent as Idempotency-Key."
+        },
+        idempotency_key: {
+          type: "string",
+          description: "Optional retry key alias sent as Idempotency-Key."
+        },
+        ...readinessPreflightProperties
+      }
+    }
+  },
+  {
+    name: "puppetry_create_video_from_text_and_wait",
+    resource: "videos.createFromText.waitForCompletion",
+    description: "Create a talking-head video from text and wait for completed or failed status.",
+    inputSchema: {
+      type: "object",
+      required: [],
+      allOf: [textScriptAliasRequirement, imageUrlAliasRequirement],
+      properties: {
+        text: {
+          type: "string",
+          description: "Script to synthesize and animate."
+        },
+        script: {
+          type: "string",
+          description: "Alias for text script to synthesize and animate."
+        },
+        prompt: {
+          type: "string",
+          description: "Alias for text script, useful for prompt-oriented agents."
+        },
+        image_url: {
+          type: "string",
+          description: "Hosted portrait image URL."
+        },
+        imageUrl: {
+          type: "string",
+          description: "Hosted portrait image URL alias."
+        },
+        image: {
+          type: "string",
+          description: "Hosted portrait image URL alias for agents."
+        },
+        portrait: {
+          type: "string",
+          description: "Deprecated hosted portrait image URL alias."
+        },
+        portrait_url: {
+          type: "string",
+          description: "Hosted portrait image URL snake_case alias."
+        },
+        portraitUrl: {
+          type: "string",
+          description: "Hosted portrait image URL alias."
+        },
+        avatar: {
+          type: "string",
+          description: "Hosted avatar image URL alias."
+        },
+        avatarUrl: {
+          type: "string",
+          description: "Hosted avatar image URL alias."
+        },
+        avatar_url: {
+          type: "string",
+          description: "Hosted avatar image URL snake_case alias."
+        },
+        photo: {
+          type: "string",
+          description: "Hosted photo image URL alias."
+        },
+        photoUrl: {
+          type: "string",
+          description: "Hosted photo image URL alias."
+        },
+        photo_url: {
+          type: "string",
+          description: "Hosted photo image URL snake_case alias."
+        },
+        voice_id: {
+          type: "string",
+          description: "Optional Puppetry voice ID from voices.listPuppetry()."
+        },
+        voiceId: {
+          type: "string",
+          description: "Optional Puppetry voice ID alias."
+        },
+        voice: {
+          type: "string",
+          description: "Optional Puppetry voice ID alias for SDK examples."
+        },
+        language: {
+          type: "string",
+          description: "Optional language code, such as en."
+        },
+        expressiveness: {
+          type: "number",
+          description: "Optional animation expressiveness from 0 to 2."
+        },
+        idempotencyKey: {
+          type: "string",
+          description: "Optional retry key sent as Idempotency-Key."
+        },
+        idempotency_key: {
+          type: "string",
+          description: "Optional retry key alias sent as Idempotency-Key."
+        },
+        ...readinessPreflightProperties,
+        ...waitOptionsProperties
+      }
+    }
+  },
+  {
+    name: "puppetry_create_video_from_audio_and_wait",
+    resource: "videos.createFromAudio.waitForCompletion",
+    description: "Create a talking-head video from audio and wait for completed or failed status.",
+    inputSchema: {
+      type: "object",
+      required: [],
+      allOf: [imageUrlAliasRequirement, audioUrlAliasRequirement],
+      properties: {
+        audio_url: {
+          type: "string",
+          description: "Hosted audio URL."
+        },
+        audioUrl: {
+          type: "string",
+          description: "Hosted audio URL alias."
+        },
+        audio: {
+          type: "string",
+          description: "Hosted audio URL alias for agents."
+        },
+        image_url: {
+          type: "string",
+          description: "Hosted portrait image URL."
+        },
+        imageUrl: {
+          type: "string",
+          description: "Hosted portrait image URL alias."
+        },
+        image: {
+          type: "string",
+          description: "Hosted portrait image URL alias for agents."
+        },
+        portrait: {
+          type: "string",
+          description: "Deprecated hosted portrait image URL alias."
+        },
+        portrait_url: {
+          type: "string",
+          description: "Hosted portrait image URL snake_case alias."
+        },
+        portraitUrl: {
+          type: "string",
+          description: "Hosted portrait image URL alias."
+        },
+        avatar: {
+          type: "string",
+          description: "Hosted avatar image URL alias."
+        },
+        avatarUrl: {
+          type: "string",
+          description: "Hosted avatar image URL alias."
+        },
+        avatar_url: {
+          type: "string",
+          description: "Hosted avatar image URL snake_case alias."
+        },
+        photo: {
+          type: "string",
+          description: "Hosted photo image URL alias."
+        },
+        photoUrl: {
+          type: "string",
+          description: "Hosted photo image URL alias."
+        },
+        photo_url: {
+          type: "string",
+          description: "Hosted photo image URL snake_case alias."
+        },
+        expressiveness: {
+          type: "number",
+          description: "Optional animation expressiveness from 0 to 2."
+        },
+        idempotencyKey: {
+          type: "string",
+          description: "Optional retry key sent as Idempotency-Key."
+        },
+        idempotency_key: {
+          type: "string",
+          description: "Optional retry key alias sent as Idempotency-Key."
+        },
+        ...readinessPreflightProperties,
+        ...waitOptionsProperties
+      }
+    }
+  },
+  {
+    name: "puppetry_create_audio_upload_url",
+    resource: "uploads.createAudioUrl",
+    description: "Reserve a Puppetry-hosted signed audio upload URL for audio-to-video workflows.",
+    inputSchema: {
+      type: "object",
+      required: [],
+      ...audioUploadReservationRequirement,
+      properties: {
+        mime_type: {
+          type: "string",
+          description: "Audio MIME type, such as audio/wav, audio/mpeg, or audio/mp4."
+        },
+        mimeType: {
+          type: "string",
+          description: "Audio MIME type alias."
+        },
+        contentType: {
+          type: "string",
+          description: "Audio MIME type alias for signed-upload callers."
+        },
+        content_length: {
+          type: "number",
+          description: "Exact byte length of the audio file to upload."
+        },
+        contentLength: {
+          type: "number",
+          description: "Exact byte length alias."
+        },
+        sizeBytes: {
+          type: "number",
+          description: "Exact byte length alias for agent/runtime callers."
+        },
+        file_size: {
+          type: "number",
+          description: "Exact byte length alias for upload metadata callers."
+        },
+        fileSize: {
+          type: "number",
+          description: "Exact byte length alias for upload metadata callers."
+        },
+        idempotencyKey: {
+          type: "string",
+          description: "Optional retry key sent as Idempotency-Key."
+        },
+        idempotency_key: {
+          type: "string",
+          description: "Optional retry key alias sent as Idempotency-Key."
+        }
+      }
+    }
+  },
+  {
+    name: "puppetry_lipsync",
+    resource: "videos.createFromAudio",
+    description: "Lip sync a portrait or puppet with an existing audio URL.",
+    inputSchema: {
+      type: "object",
+      required: [],
+      allOf: [imageUrlAliasRequirement, audioUrlAliasRequirement],
+      properties: {
+        audio_url: {
+          type: "string",
+          description: "Hosted audio URL."
+        },
+        audioUrl: {
+          type: "string",
+          description: "Hosted audio URL alias."
+        },
+        audio: {
+          type: "string",
+          description: "Hosted audio URL alias for agents."
+        },
+        image_url: {
+          type: "string",
+          description: "Hosted portrait image URL."
+        },
+        imageUrl: {
+          type: "string",
+          description: "Hosted portrait image URL alias."
+        },
+        image: {
+          type: "string",
+          description: "Hosted portrait image URL alias for agents."
+        },
+        portrait: {
+          type: "string",
+          description: "Deprecated hosted portrait image URL alias."
+        },
+        portrait_url: {
+          type: "string",
+          description: "Hosted portrait image URL snake_case alias."
+        },
+        portraitUrl: {
+          type: "string",
+          description: "Hosted portrait image URL alias."
+        },
+        avatar: {
+          type: "string",
+          description: "Hosted avatar image URL alias."
+        },
+        avatarUrl: {
+          type: "string",
+          description: "Hosted avatar image URL alias."
+        },
+        avatar_url: {
+          type: "string",
+          description: "Hosted avatar image URL snake_case alias."
+        },
+        photo: {
+          type: "string",
+          description: "Hosted photo image URL alias."
+        },
+        photoUrl: {
+          type: "string",
+          description: "Hosted photo image URL alias."
+        },
+        photo_url: {
+          type: "string",
+          description: "Hosted photo image URL snake_case alias."
+        },
+        idempotencyKey: {
+          type: "string",
+          description: "Optional retry key sent as Idempotency-Key."
+        },
+        idempotency_key: {
+          type: "string",
+          description: "Optional retry key alias sent as Idempotency-Key."
+        }
+      }
+    }
+  },
+  {
+    name: "puppetry_list_voices",
+    resource: "voices.listPuppetry",
+    description: "List Puppetry-hosted voices with preview text and audio.",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  },
+  {
+    name: "puppetry_get_job_status",
+    resource: "jobs.get",
+    description: "Fetch a generated video job by ID.",
+    inputSchema: {
+      type: "object",
+      required: [],
+      ...jobIdAliasRequirement,
+      properties: {
+        jobId: {
+          type: "string",
+          description: "Generated video job ID."
+        },
+        job_id: {
+          type: "string",
+          description: "Generated video job ID alias."
+        },
+        task_id: {
+          type: "string",
+          description: "Generated video task ID alias."
+        },
+        taskId: {
+          type: "string",
+          description: "Generated video task ID camelCase alias."
+        },
+        id: {
+          type: "string",
+          description: "Generated video ID alias."
+        }
+      }
+    }
+  },
+  {
+    name: "puppetry_wait_for_video",
+    resource: "videos.waitForCompletion",
+    description: "Poll a generated video job until it reaches completed or failed.",
+    inputSchema: {
+      type: "object",
+      required: [],
+      ...jobIdAliasRequirement,
+      properties: {
+        jobId: {
+          type: "string",
+          description: "Generated video job ID."
+        },
+        job_id: {
+          type: "string",
+          description: "Generated video job ID alias."
+        },
+        task_id: {
+          type: "string",
+          description: "Generated video task ID alias."
+        },
+        taskId: {
+          type: "string",
+          description: "Generated video task ID camelCase alias."
+        },
+        id: {
+          type: "string",
+          description: "Generated video ID alias."
+        },
+        intervalMs: {
+          type: "number",
+          description: "Polling interval in milliseconds. Defaults to 2000."
+        },
+        timeoutMs: {
+          type: "number",
+          description: "Maximum wait time in milliseconds. Defaults to 300000."
+        },
+        initialDelayMs: {
+          type: "number",
+          description: "Optional delay before the first status request, useful with Retry-After."
+        }
+      }
+    }
+  },
+  {
+    name: "puppetry_get_video_readiness",
+    resource: "videos.getReadiness",
+    description: "Check whether credit-backed video creation can run now, including credit and active-slot blockers.",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  },
+  {
+    name: "puppetry_get_quota",
+    resource: "quota.get",
+    description: "Check current plan, credit usage, and remaining credits.",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  }
+];
+async function callPuppetryAgentTool(client, name, input) {
+  switch (name) {
+    case "puppetry_create_video_from_text":
+      return createTextVideo(
+        client,
+        input
+      );
+    case "puppetry_create_video_from_audio":
+      return createAudioVideo(
+        client,
+        input
+      );
+    case "puppetry_create_video_from_text_and_wait":
+      return createTextVideoAndWait(
+        client,
+        input
+      );
+    case "puppetry_create_video_from_audio_and_wait":
+      return createAudioVideoAndWait(
+        client,
+        input
+      );
+    case "puppetry_create_audio_upload_url":
+      return client.uploads.createAudioUrl(
+        input
+      );
+    case "puppetry_lipsync":
+      return client.videos.createFromAudio(
+        input
+      );
+    case "puppetry_list_voices":
+      return client.voices.listPuppetry();
+    case "puppetry_get_job_status":
+      return client.jobs.get(
+        resolveJobIdAlias(
+          input
+        )
+      );
+    case "puppetry_wait_for_video": {
+      const waitInput = input;
+      return client.videos.waitForCompletion(resolveJobIdAlias(waitInput), {
+        intervalMs: waitInput.intervalMs,
+        timeoutMs: waitInput.timeoutMs,
+        initialDelayMs: waitInput.initialDelayMs
+      });
+    }
+    case "puppetry_get_video_readiness":
+      return client.videos.getReadiness();
+    case "puppetry_get_quota":
+      return client.quota.get();
+    default:
+      throw new Error(`Unsupported Puppetry agent tool: ${String(name)}`);
+  }
+}
+async function createTextVideo(client, input) {
+  const readiness = await preflightVideoReadiness(client, input, false);
+  const job = await client.videos.createFromText(input);
+  return videoCreateResult(job, readiness);
+}
+async function createAudioVideo(client, input) {
+  const readiness = await preflightVideoReadiness(client, input, false);
+  const job = await client.videos.createFromAudio(input);
+  return videoCreateResult(job, readiness);
+}
+async function createTextVideoAndWait(client, input) {
+  const readiness = await preflightVideoReadiness(client, input, true);
+  const acceptedJob = await client.videos.createFromText(input);
+  const wait = measuredWaitOptions(input);
+  const finalJob = await acceptedJob.waitForCompletion(wait.options);
+  return videoFlowResult(acceptedJob, finalJob, wait.summary(), readiness);
+}
+async function createAudioVideoAndWait(client, input) {
+  const readiness = await preflightVideoReadiness(client, input, true);
+  const acceptedJob = await client.videos.createFromAudio(input);
+  const wait = measuredWaitOptions(input);
+  const finalJob = await acceptedJob.waitForCompletion(wait.options);
+  return videoFlowResult(acceptedJob, finalJob, wait.summary(), readiness);
+}
+async function preflightVideoReadiness(client, input, defaultValue) {
+  const shouldPreflight = resolveReadinessPreflight(input, defaultValue);
+  if (!shouldPreflight) return void 0;
+  return client.videos.ensureReady();
+}
+function resolveReadinessPreflight(input, defaultValue) {
+  const aliases = [
+    { name: "preflightReadiness", value: input.preflightReadiness },
+    { name: "preflight_readiness", value: input.preflight_readiness }
+  ].flatMap((alias) => {
+    if (alias.value === void 0 || alias.value === null) return [];
+    if (typeof alias.value !== "boolean") {
+      throw new PuppetryError(
+        400,
+        "invalid_request",
+        `${alias.name} must be a boolean`
+      );
+    }
+    return [{ name: alias.name, value: alias.value }];
+  });
+  const first = aliases[0];
+  if (!first) return defaultValue;
+  for (const alias of aliases) {
+    if (alias.value !== first.value) {
+      throw new PuppetryError(
+        400,
+        "invalid_request",
+        "preflightReadiness and preflight_readiness must describe the same boolean value"
+      );
+    }
+  }
+  return first.value;
+}
+function measuredWaitOptions(input) {
+  const startedAt = Date.now();
+  let pollCount = 0;
+  let retryCount = 0;
+  let latestRetryingEvent;
+  const options = {
+    ...input.intervalMs === void 0 ? {} : { intervalMs: input.intervalMs },
+    ...input.timeoutMs === void 0 ? {} : { timeoutMs: input.timeoutMs },
+    ...input.initialDelayMs === void 0 ? {} : { initialDelayMs: input.initialDelayMs },
+    onPoll: () => {
+      pollCount += 1;
+    },
+    onRetrying: (event) => {
+      retryCount += 1;
+      latestRetryingEvent = event;
+    }
+  };
+  return {
+    options,
+    summary: () => ({
+      pollCount,
+      retryCount,
+      ...latestRetryingEvent === void 0 ? {} : { latestRetryingEvent },
+      durationMs: Date.now() - startedAt
+    })
+  };
+}
+function videoFlowResult(acceptedJob, finalJob, wait, readiness) {
+  const operationId = nonDefaultOperationId(finalJob) ?? nonDefaultOperationId(acceptedJob) ?? finalJob.operationId ?? finalJob.operation_id ?? acceptedJob.operationId ?? acceptedJob.operation_id ?? finalJob.id;
+  const requestId = finalJob.requestId ?? finalJob.request_id ?? acceptedJob.requestId ?? acceptedJob.request_id;
+  const videoUrl = finalJob.videoUrl ?? finalJob.video_url ?? finalJob.url;
+  const acceptedCredits = videoCreditEvidence(acceptedJob.credits);
+  const finalCredits = videoCreditEvidence(finalJob.credits);
+  const creationCredits = videoCreationCreditEvidence(finalJob) ?? videoCreationCreditEvidence(acceptedJob);
+  return {
+    object: "video_flow",
+    accepted_job: acceptedJob,
+    acceptedJob,
+    final_job: finalJob,
+    finalJob,
+    ...acceptedCredits === void 0 ? {} : { accepted_credits: acceptedCredits, acceptedCredits },
+    ...finalCredits === void 0 ? {} : {
+      final_credits: finalCredits,
+      finalCredits,
+      credits: finalCredits
+    },
+    ...creationCredits === void 0 ? {} : { creation_credits: creationCredits, creationCredits },
+    job_id: finalJob.id,
+    jobId: finalJob.id,
+    operation_id: operationId,
+    operationId,
+    ...requestId === void 0 ? {} : { request_id: requestId, requestId },
+    status: finalJob.status,
+    completed: finalJob.status === "completed",
+    ...readiness === void 0 ? {} : { readiness: videoReadinessEvidence(readiness) },
+    readiness_checked: readiness !== void 0,
+    readinessChecked: readiness !== void 0,
+    poll_count: wait.pollCount,
+    pollCount: wait.pollCount,
+    retry_count: wait.retryCount,
+    retryCount: wait.retryCount,
+    ...wait.latestRetryingEvent === void 0 ? {} : {
+      latest_retrying_event: wait.latestRetryingEvent,
+      latestRetryingEvent: wait.latestRetryingEvent
+    },
+    duration_ms: wait.durationMs,
+    durationMs: wait.durationMs,
+    ...videoUrl === void 0 ? {} : { video_url: videoUrl, videoUrl }
+  };
+}
+function videoCreateResult(job, readiness) {
+  const result = job;
+  result.readiness_checked = readiness !== void 0;
+  result.readinessChecked = readiness !== void 0;
+  if (readiness !== void 0) {
+    result.readiness = videoReadinessEvidence(readiness);
+  }
+  return result;
+}
+function videoCreditEvidence(credits) {
+  if (!credits || typeof credits !== "object") return void 0;
+  if (typeof credits.charged !== "number" || !Number.isFinite(credits.charged)) {
+    return void 0;
+  }
+  return {
+    charged: credits.charged,
+    remaining: typeof credits.remaining === "number" && Number.isFinite(credits.remaining) ? credits.remaining : null
+  };
+}
+function videoCreationCreditEvidence(job) {
+  const raw = job.creationCredits ?? job.creation_credits;
+  if (!raw || typeof raw !== "object") return void 0;
+  if (typeof raw.charged !== "number" || !Number.isFinite(raw.charged)) {
+    return void 0;
+  }
+  const remainingAfterDebit = raw.remainingAfterDebit ?? raw.remaining_after_debit ?? null;
+  const normalizedRemainingAfterDebit = typeof remainingAfterDebit === "number" && Number.isFinite(remainingAfterDebit) ? remainingAfterDebit : null;
+  return {
+    charged: raw.charged,
+    remaining_after_debit: normalizedRemainingAfterDebit,
+    remainingAfterDebit: normalizedRemainingAfterDebit
+  };
+}
+function videoReadinessEvidence(readiness) {
+  const canCreate = readiness.canCreate ?? readiness.can_create;
+  const requiredCredits = readiness.requiredCredits ?? readiness.required_credits;
+  const creditsRemaining = readiness.creditsRemaining ?? readiness.credits_remaining;
+  const concurrentJobs = readiness.concurrentJobs ?? readiness.concurrent_jobs;
+  const activeJobs = readiness.activeJobs ?? readiness.active_jobs;
+  const availableSlots = readiness.availableSlots ?? readiness.available_slots;
+  const activeJobExpiresInSeconds = readiness.activeJobExpiresInSeconds ?? readiness.active_job_expires_in_seconds;
+  const retryAfterSeconds = readiness.retryAfterSeconds ?? readiness.retryAfter ?? readiness.retry_after_seconds;
+  const nextPollAt = readiness.nextPollAt ?? readiness.next_poll_at;
+  return {
+    ...readiness,
+    can_create: canCreate,
+    canCreate,
+    required_credits: requiredCredits,
+    requiredCredits,
+    credits_remaining: creditsRemaining,
+    creditsRemaining,
+    ...concurrentJobs === void 0 ? {} : { concurrent_jobs: concurrentJobs, concurrentJobs },
+    ...activeJobs === void 0 ? {} : { active_jobs: activeJobs, activeJobs },
+    ...availableSlots === void 0 ? {} : { available_slots: availableSlots, availableSlots },
+    ...activeJobExpiresInSeconds === void 0 ? {} : {
+      active_job_expires_in_seconds: activeJobExpiresInSeconds,
+      activeJobExpiresInSeconds
+    },
+    ...retryAfterSeconds === void 0 ? {} : {
+      retry_after_seconds: retryAfterSeconds,
+      retryAfter: readiness.retryAfter ?? retryAfterSeconds,
+      retryAfterSeconds
+    },
+    ...nextPollAt === void 0 ? {} : { next_poll_at: nextPollAt, nextPollAt }
+  };
+}
+function nonDefaultOperationId(job) {
+  const operationId = job.operationId ?? job.operation_id;
+  return operationId && operationId !== job.id ? operationId : void 0;
+}
+async function safeCallPuppetryAgentTool(client, name, input) {
+  try {
+    return {
+      ok: true,
+      data: await callPuppetryAgentTool(client, name, input)
+    };
+  } catch (err) {
+    if (err instanceof PuppetryError) {
+      return {
+        ok: false,
+        error: puppetryErrorData(err)
+      };
+    }
+    return {
+      ok: false,
+      error: {
+        status: 500,
+        statusCode: 500,
+        code: "internal_error",
+        message: err instanceof Error ? err.message : "Internal error"
+      }
+    };
+  }
+}
+
+// src/mcp.ts
+var SERVER_INFO = {
+  name: "puppetry",
+  version: "0.1.0"
+};
+var TOOL_NAMES = new Set(
+  PUPPETRY_AGENT_TOOLS.map((tool) => tool.name)
+);
+async function handlePuppetryMcpRequest(client, request) {
+  if (request.id === void 0 && request.method === "notifications/initialized") {
+    return null;
+  }
+  try {
+    switch (request.method) {
+      case "initialize":
+        return success(request.id, {
+          protocolVersion: requestedProtocolVersion(request.params),
+          capabilities: { tools: {} },
+          serverInfo: SERVER_INFO
+        });
+      case "ping":
+        return success(request.id, {});
+      case "tools/list":
+        return success(request.id, {
+          tools: PUPPETRY_AGENT_TOOLS.map(
+            ({ name, description, inputSchema }) => ({
+              name,
+              description,
+              inputSchema
+            })
+          )
+        });
+      case "tools/call":
+        return success(request.id, await callTool(client, request.params));
+      default:
+        return error(request.id, -32601, `Method not found: ${request.method}`);
+    }
+  } catch (err) {
+    if (err instanceof PuppetryError) {
+      return error(request.id, -32603, err.message, puppetryErrorData(err));
+    }
+    return error(
+      request.id,
+      -32603,
+      err instanceof Error ? err.message : "Internal error"
+    );
+  }
+}
+async function callTool(client, params) {
+  if (!isObject(params) || typeof params.name !== "string") {
+    throw new Error("tools/call requires a tool name");
+  }
+  if (!TOOL_NAMES.has(params.name)) {
+    throw new Error(`Unsupported Puppetry MCP tool: ${params.name}`);
+  }
+  const result = await callPuppetryAgentTool(
+    client,
+    params.name,
+    isObject(params.arguments) ? params.arguments : {}
+  );
+  return {
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify(result, null, 2)
+      }
+    ]
+  };
+}
+function requestedProtocolVersion(params) {
+  if (isObject(params) && typeof params.protocolVersion === "string") {
+    return params.protocolVersion;
+  }
+  return "2024-11-05";
+}
+function success(id, result) {
+  return {
+    jsonrpc: "2.0",
+    id: id ?? null,
+    result
+  };
+}
+function error(id, code, message, data) {
+  return {
+    jsonrpc: "2.0",
+    id: id ?? null,
+    error: data === void 0 ? { code, message } : { code, message, data }
+  };
+}
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+export {
+  PuppetryError,
+  PuppetryTimeoutError,
+  PuppetryAuthError,
+  PuppetryRateLimitError,
+  PuppetryNetworkError,
+  puppetryErrorData,
+  PUPPETRY_AGENT_TOOLS,
+  callPuppetryAgentTool,
+  safeCallPuppetryAgentTool,
+  handlePuppetryMcpRequest
+};