@nooticr/mcp 1.26.19

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 NooticrError 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) {
+        // Internal accounting stays internal. appId and workspaceId mean nothing
+        // to a caller, and `cost` is the workspace-credit price of the analysis
+        // job - a different currency from the MCP credits the tool is billed in.
+        // Surfacing it made the tool look like it charged 10 when it charges 6.
+        result.job = {
+            ok: job.ok,
+            jobId: job.jobId,
+            state: job.state,
+            platform: job.platform,
+            provider: job.provider,
+            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 nooticr account has no credits left for this analysis${detail}. ` +
+        `Top up or check your usage in the nooticr dashboard, then try again. ` +
+        `Note: the first analysis is covered by the free grant.`);
+}

package/dist/shared/view-meta.js

@@ -0,0 +1,34 @@
+/**
+ * The `_meta` block that gives a tool its card, in one place.
+ *
+ * Every registrar module outside `tools.ts` needs these three keys and none of
+ * them can import `tools.ts` to get them: `tools.ts` imports the registrars, so
+ * reaching back for its `uiResource` closes a cycle. The answer up to now was a
+ * local copy per module with a comment explaining why — which worked, and then
+ * there were three of them, each a place the URI could drift from the resource
+ * `tools.ts` actually registers under.
+ *
+ * Both halves of that contract are checked in CI's `Host contract` step: every
+ * tool not in `NO_APP` must declare `ui/resourceUri` at the MCP Apps mime type
+ * with a `.html` sibling for ChatGPT. A URI that drifts from the registered
+ * resource fails there rather than at runtime, but only after a push — so the
+ * cheaper fix is for there to be one string.
+ */
+/** The app resource a tool's card is served from. */
+export function uiResourceUri(tool) {
+    return `ui://nooticr/${tool}`;
+}
+/**
+ * A view for a tool, at the URIs both hosts read.
+ *
+ * `ui/resourceUri` is the MCP Apps spec key that Claude reads; the
+ * `.html`-suffixed `openai/outputTemplate` is ChatGPT's, which does not speak
+ * that spec. The duplicated `ui.resourceUri` is the pre-standard nesting some
+ * hosts still look for. See `CLAUDE.md`'s dual-mime section for why serving
+ * both is deliberate rather than a bug.
+ */
+export const viewMeta = (tool) => ({
+    ui: { resourceUri: uiResourceUri(tool) },
+    "ui/resourceUri": uiResourceUri(tool),
+    "openai/outputTemplate": `${uiResourceUri(tool)}.html`,
+});