@orchyn/mcp 1.3.4 → 1.4.1

package/dist/shared/video.js

@@ -0,0 +1,152 @@
+/**
+ * URL validation + the analyze_post workflow: start the job, then poll until
+ * the analysis is done (or fails).
+ */
+export const POLL_INTERVAL_MS = 2000;
+export const POLL_TIMEOUT_MS = 300_000;
+const SUPPORTED_HOSTS_VIDEO = new Set([
+    "tiktok.com",
+    "vm.tiktok.com",
+    "m.tiktok.com",
+    "instagram.com",
+    "instagr.am",
+    "youtube.com",
+    "youtu.be",
+    "m.youtube.com",
+    "youtube-nocookie.com",
+    "douyin.com",
+    "xiaohongshu.com",
+    "xhslink.com",
+    "bilibili.com",
+    "m.bilibili.com",
+    "b23.tv",
+]);
+const SUPPORTED_HOSTS_POST = new Set([
+    ...SUPPORTED_HOSTS_VIDEO,
+    "x.com",
+    "twitter.com",
+    "mobile.twitter.com",
+]);
+function validateUrl(rawUrl, allowed) {
+    if (typeof rawUrl !== "string" || rawUrl.trim() === "") {
+        return { ok: false, error: "url must be a non-empty string." };
+    }
+    let parsed;
+    try {
+        parsed = new URL(rawUrl.trim());
+    }
+    catch {
+        return { ok: false, error: "url is not a valid URL." };
+    }
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        return { ok: false, error: "url must use http or https." };
+    }
+    let host = parsed.hostname.toLowerCase();
+    if (host.startsWith("www."))
+        host = host.slice(4);
+    if (host === "youtube.com" || host === "youtu.be") {
+        // accept all youtube.com paths, incl. /shorts/<id>
+        return { ok: true, url: parsed.toString() };
+    }
+    if (allowed.has(host)) {
+        return { ok: true, url: parsed.toString() };
+    }
+    return {
+        ok: false,
+        error: "url host is not supported. Supported: tiktok.com, instagram.com, youtube.com (and /shorts), x.com, twitter.com, douyin.com, xiaohongshu.com, xhslink.com, bilibili.com, b23.tv.",
+    };
+}
+export function validateVideoUrl(rawUrl) {
+    return validateUrl(rawUrl, SUPPORTED_HOSTS_VIDEO);
+}
+export function validatePostUrl(rawUrl) {
+    return validateUrl(rawUrl, SUPPORTED_HOSTS_POST);
+}
+export class JobTimeoutError extends Error {
+    constructor(jobId, elapsedMs, lastStatus) {
+        super(`Timed out after ${Math.round(elapsedMs / 1000)}s waiting for analysis job ${jobId} to finish.` +
+            (lastStatus?.contentPreview ? ` Partial content: ${lastStatus.contentPreview}` : ""));
+        this.name = "JobTimeoutError";
+    }
+}
+/**
+ * Polls a job until state is "done" or "error".
+ */
+export async function pollUntilDone(client, jobId, opts = {}) {
+    const pollIntervalMs = opts.pollIntervalMs ?? POLL_INTERVAL_MS;
+    const timeoutMs = opts.timeoutMs ?? POLL_TIMEOUT_MS;
+    const startedAt = Date.now();
+    let last;
+    for (;;) {
+        const elapsedMs = Date.now() - startedAt;
+        if (elapsedMs >= timeoutMs) {
+            throw new JobTimeoutError(jobId, elapsedMs, last);
+        }
+        const status = await client.getJob(jobId);
+        last = status;
+        opts.onPoll?.(status);
+        if (status.state === "done")
+            return status;
+        if (status.state === "error")
+            return status;
+        await new Promise((r) => setTimeout(r, pollIntervalMs));
+    }
+}
+/**
+ * Full tool workflow: start the analysis, poll until done, return a
+ * JSON-serializable result. Throws OrchynError on API-level failures
+ * (e.g. 402 paywall).
+ */
+export async function runVideoAnalysis(client, url, opts = {}) {
+    const job = await client.startVideoAnalysis(url, opts.appId);
+    const status = await pollUntilDone(client, job.jobId, opts);
+    const result = {
+        ok: status.state === "done",
+        jobId: status.jobId,
+        state: status.state,
+        platform: job.platform,
+        provider: status.provider ?? job.provider,
+        analysis: status.analysis,
+        contentPreview: status.contentPreview,
+        error: status.error,
+        elapsedMs: status.elapsedMs,
+        // Mirror the Rust `/mcp` understand_social_post shape: expose the
+        // imported post + inline thumbnails at the top level so the analysis
+        // tool renders the thumbnail and the full post, not just the analysis.
+        post: job.post,
+        inlineImages: job.inlineImages,
+    };
+    if (result.ok) {
+        result.job = {
+            ok: job.ok,
+            jobId: job.jobId,
+            state: job.state,
+            platform: job.platform,
+            provider: job.provider,
+            appId: job.appId,
+            workspaceId: job.workspaceId,
+            cost: job.cost,
+            freeGrant: job.freeGrant,
+            post: job.post,
+        };
+    }
+    return result;
+}
+export function formatPaywallError(err) {
+    const p = err.paywall;
+    const parts = [];
+    if (p?.reason)
+        parts.push(`reason: ${p.reason}`);
+    if (p?.used !== undefined && p?.max !== undefined) {
+        parts.push(`credits used: ${p.used}/${p.max}`);
+    }
+    else if (p?.used !== undefined) {
+        parts.push(`credits used: ${p.used}`);
+    }
+    if (p?.cost !== undefined)
+        parts.push(`cost: ${p.cost}`);
+    const detail = parts.length > 0 ? ` (${parts.join(", ")})` : "";
+    return (`Your orchyn account has no credits left for this analysis${detail}. ` +
+        `Top up or check your usage in the orchyn dashboard, then try again. ` +
+        `Note: the first analysis is covered by the free grant.`);
+}

package/dist/video.js

@@ -1,141 +1,6 @@
 /**
- * URL validation + the analyze_video workflow: start the job, then poll until
- * the analysis is done (or fails).
+ * URL validation + analysis workflow helpers now live in `shared/video.ts`
+ * (shared with the Cloudflare Worker). This file re-exports them for
+ * backward compatibility.
  */
-export const POLL_INTERVAL_MS = 2000;
-export const POLL_TIMEOUT_MS = 300_000;
-const SUPPORTED_HOSTS_VIDEO = new Set([
-    "tiktok.com",
-    "vm.tiktok.com",
-    "instagram.com",
-    "instagr.am",
-    "youtube.com",
-    "youtu.be",
-    "m.youtube.com",
-    "youtube-nocookie.com",
-    "m.tiktok.com",
-]);
-const SUPPORTED_HOSTS_POST = new Set([
-    ...SUPPORTED_HOSTS_VIDEO,
-    "x.com",
-    "twitter.com",
-    "mobile.twitter.com",
-]);
-function validateUrl(rawUrl, allowed) {
-    if (typeof rawUrl !== "string" || rawUrl.trim() === "") {
-        return { ok: false, error: "url must be a non-empty string." };
-    }
-    let parsed;
-    try {
-        parsed = new URL(rawUrl.trim());
-    }
-    catch {
-        return { ok: false, error: "url is not a valid URL." };
-    }
-    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
-        return { ok: false, error: "url must use http or https." };
-    }
-    let host = parsed.hostname.toLowerCase();
-    if (host.startsWith("www."))
-        host = host.slice(4);
-    if (host === "youtube.com" || host === "youtu.be") {
-        // accept all youtube.com paths, incl. /shorts/<id>
-        return { ok: true, url: parsed.toString() };
-    }
-    if (allowed.has(host)) {
-        return { ok: true, url: parsed.toString() };
-    }
-    return {
-        ok: false,
-        error: "url host is not supported. Supported: tiktok.com, vm.tiktok.com, instagram.com, instagr.am, youtube.com, youtu.be, m.youtube.com (and /shorts).",
-    };
-}
-export function validateVideoUrl(rawUrl) {
-    return validateUrl(rawUrl, SUPPORTED_HOSTS_VIDEO);
-}
-export function validatePostUrl(rawUrl) {
-    return validateUrl(rawUrl, SUPPORTED_HOSTS_POST);
-}
-export class JobTimeoutError extends Error {
-    constructor(jobId, elapsedMs, lastStatus) {
-        super(`Timed out after ${Math.round(elapsedMs / 1000)}s waiting for analysis job ${jobId} to finish.` +
-            (lastStatus?.contentPreview ? ` Partial content: ${lastStatus.contentPreview}` : ""));
-        this.name = "JobTimeoutError";
-    }
-}
-/**
- * Polls a job until state is "done" or "error".
- */
-export async function pollUntilDone(client, jobId, opts = {}) {
-    const pollIntervalMs = opts.pollIntervalMs ?? POLL_INTERVAL_MS;
-    const timeoutMs = opts.timeoutMs ?? POLL_TIMEOUT_MS;
-    const startedAt = Date.now();
-    let last;
-    for (;;) {
-        const elapsedMs = Date.now() - startedAt;
-        if (elapsedMs >= timeoutMs) {
-            throw new JobTimeoutError(jobId, elapsedMs, last);
-        }
-        const status = await client.getJob(jobId);
-        last = status;
-        opts.onPoll?.(status);
-        if (status.state === "done")
-            return status;
-        if (status.state === "error")
-            return status;
-        await new Promise((r) => setTimeout(r, pollIntervalMs));
-    }
-}
-/**
- * Full tool workflow: start the analysis, poll until done, return a
- * JSON-serializable result. Throws OrchynError on API-level failures
- * (e.g. 402 paywall).
- */
-export async function runVideoAnalysis(client, url, opts = {}) {
-    const job = await client.startVideoAnalysis(url, opts.appId);
-    const status = await pollUntilDone(client, job.jobId, opts);
-    const result = {
-        ok: status.state === "done",
-        jobId: status.jobId,
-        state: status.state,
-        platform: job.platform,
-        provider: status.provider ?? job.provider,
-        analysis: status.analysis,
-        contentPreview: status.contentPreview,
-        error: status.error,
-        elapsedMs: status.elapsedMs,
-    };
-    if (result.ok) {
-        result.job = {
-            ok: job.ok,
-            jobId: job.jobId,
-            state: job.state,
-            platform: job.platform,
-            provider: job.provider,
-            appId: job.appId,
-            workspaceId: job.workspaceId,
-            cost: job.cost,
-            freeGrant: job.freeGrant,
-            post: job.post,
-        };
-    }
-    return result;
-}
-export function formatPaywallError(err) {
-    const p = err.paywall;
-    const parts = [];
-    if (p?.reason)
-        parts.push(`reason: ${p.reason}`);
-    if (p?.used !== undefined && p?.max !== undefined) {
-        parts.push(`credits used: ${p.used}/${p.max}`);
-    }
-    else if (p?.used !== undefined) {
-        parts.push(`credits used: ${p.used}`);
-    }
-    if (p?.cost !== undefined)
-        parts.push(`cost: ${p.cost}`);
-    const detail = parts.length > 0 ? ` (${parts.join(", ")})` : "";
-    return (`Your orchyn account has no credits left for this analysis${detail}. ` +
-        `Top up or check your usage in the orchyn dashboard, then try again. ` +
-        `Note: the first analysis is covered by the free grant.`);
-}
+export * from "./shared/video.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orchyn/mcp",
-  "version": "1.3.4",
+  "version": "1.4.1",
   "description": "MCP server for orchyn - fetch, discover and understand TikTok/Instagram/YouTube/X posts with AI (media metadata, niche discovery, hook & viral analysis)",
   "type": "module",
   "main": "dist/index.js",
@@ -23,7 +23,15 @@
     "test": "vitest run",
     "prepare": "npm run build"
   },
-  "keywords": ["mcp", "orchyn", "video", "analysis", "tiktok", "instagram", "youtube"],
+  "keywords": [
+    "mcp",
+    "orchyn",
+    "video",
+    "analysis",
+    "tiktok",
+    "instagram",
+    "youtube"
+  ],
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.16.0",