@nooticr/mcp 1.26.21 → 1.26.23

package/dist/shared/loading-plans.js

@@ -0,0 +1,365 @@
+/**
+ * What each tool is about to do, and what it will cost — for the wait.
+ *
+ * ## Why this exists rather than a table in the view
+ *
+ * The view is a static HTML string with no imports, so its first version of
+ * this was a hand-copied price list. It was wrong within the hour: it took its
+ * numbers from `mcp_tool_cost` in nooticr-server, which prices a *direct*
+ * `/mcp` call, while every evidence tool in this server fans out to cheaper
+ * calls instead. `analyze_post` is billed 6 there and 3 here (frames 2 plus
+ * transcript 1); `analyze_creator_profile` 15 there and 2 here. A price on the
+ * face of a loading screen is a promise, and one copied from the wrong table
+ * is worse than none at all.
+ *
+ * So the plans are built here, from the same constants the tools bill against
+ * — `EVIDENCE_PLANS` and `BACKEND_CALL_CREDITS` — and substituted into the
+ * template as JSON. A tool that changes what it fetches changes what the wait
+ * says, with no second place to remember.
+ *
+ * ## What the view may and may not claim
+ *
+ * MCP Apps gives a view four notifications: tool-input, tool-input-partial,
+ * tool-result and tool-cancelled (`@modelcontextprotocol/ext-apps`). There is
+ * no progress notification, so nothing here can honestly say a step has
+ * *finished* — only what the call is going to do and what each line costs.
+ * The design board's ledger ticks green checks through its rows; that is a
+ * canvas loop, and reproducing it would assert completions this server has no
+ * way to know. The rows are drawn, priced, and left un-ticked.
+ */
+import { planCalls } from "./evidence.js";
+import { BACKEND_CALL_CREDITS, CREDITS_PER_CREATOR, CREDITS_PER_NETWORK, MAX_SPOKEN_HANDLE_CALLS, MAX_SPOKEN_TRANSCRIPTS, SEARCH_PLATFORMS, SPOKEN_PLATFORMS, XIAOHONGSHU_CREDITS, } from "./spend.js";
+/** What each backend call is doing, in words a person reads rather than a tool name. */
+const CALL_LABELS = {
+    get_post_frames: { label: "Sampling frames", detail: "one per shot, by scene change" },
+    get_post_transcript: { label: "Reading the caption track", detail: "exact wording, not inferred" },
+    get_social_media: { label: "Fetching the post", detail: "stats, caption and media" },
+    get_user_posts: { label: "Loading their posts", detail: "recent window, with stats" },
+    get_post_comments: { label: "Reading the comments", detail: "top replies and their themes" },
+    discover_social_posts: { label: "Searching posts", detail: "recent, for the niche" },
+    search_creators: { label: "Finding creators", detail: "by keyword" },
+    get_similar_creators: { label: "Finding lookalikes", detail: "from the seed creator" },
+    discover_sounds: { label: "Finding sounds", detail: "trending audio" },
+    discover_hashtags: { label: "Reading the trend board", detail: "with volumes and direction" },
+};
+function step(via) {
+    const said = CALL_LABELS[via] ?? { label: via };
+    return { via, label: said.label, detail: said.detail, credits: BACKEND_CALL_CREDITS[via] ?? 0 };
+}
+/** The fan-out an evidence tool declares, as priced lines. */
+function evidenceSteps(tool) {
+    return planCalls(tool).map(step);
+}
+const CREATOR_UNIT = {
+    via: "get_user_posts",
+    label: "Checking a creator",
+    detail: "since your last catch-up",
+    credits: CREDITS_PER_CREATOR,
+    defaultCount: 1,
+};
+/**
+ * One plan per registered tool.
+ *
+ * Pinned by tests/loading-plans.test.ts against the server's own tool list, so
+ * a tool cannot ship without a wait that says what it is doing — which is how
+ * search_mentions, the slowest and dearest call here, ended up drawing a
+ * generic grey box that said "Working".
+ */
+export const LOADING_PLANS = {
+    // ─── Read a post ───
+    get_social_media: { label: "Fetching the post", kind: "post", n: 1, steps: [step("get_social_media")] },
+    get_post_transcript: {
+        label: "Reading the caption track",
+        kind: "text",
+        n: 1,
+        steps: [step("get_post_transcript")],
+    },
+    get_post_frames: { label: "Sampling frames", kind: "post", n: 1, steps: [step("get_post_frames")] },
+    get_post_comments: { label: "Loading comments", kind: "list", n: 6, steps: [step("get_post_comments")] },
+    // ─── Understand a post ───
+    analyze_post: { label: "Analysing the post", kind: "post", n: 1, steps: evidenceSteps("analyze_post") },
+    understand_social_post: {
+        label: "Watching the video",
+        kind: "post",
+        n: 1,
+        steps: evidenceSteps("understand_social_post"),
+    },
+    analyze_post_fast: {
+        label: "Reading the post",
+        kind: "text",
+        n: 1,
+        steps: evidenceSteps("analyze_post_fast"),
+    },
+    analyze_comments: {
+        label: "Reading the comment section",
+        kind: "text",
+        n: 1,
+        // Not an evidence plan: it proxies one get_post_comments and synthesises.
+        steps: [step("get_post_comments")],
+    },
+    compare_posts: {
+        label: "Fetching the first post",
+        kind: "strip",
+        n: 2,
+        steps: evidenceSteps("compare_posts"),
+        note: "1 credit more for every further post you fetch yourself.",
+    },
+    // ─── Research ───
+    discover_social_posts: {
+        label: "Searching posts",
+        kind: "strip",
+        n: 3,
+        steps: [step("discover_social_posts")],
+    },
+    get_user_posts: { label: "Loading their posts", kind: "strip", n: 3, steps: [step("get_user_posts")] },
+    search_creators: { label: "Finding creators", kind: "list", n: 5, steps: [step("search_creators")] },
+    get_similar_creators: {
+        label: "Finding similar creators",
+        kind: "list",
+        n: 5,
+        steps: [step("get_similar_creators")],
+    },
+    discover_sounds: { label: "Finding trending sounds", kind: "list", n: 4, steps: [step("discover_sounds")] },
+    discover_hashtags: {
+        label: "Reading the trend board",
+        kind: "list",
+        n: 6,
+        steps: [step("discover_hashtags")],
+    },
+    analyze_creator_profile: {
+        label: "Reading the profile",
+        kind: "list",
+        n: 4,
+        steps: evidenceSteps("analyze_creator_profile"),
+    },
+    find_hook_pattern: {
+        label: "Reading their openings",
+        kind: "list",
+        n: 5,
+        steps: evidenceSteps("find_hook_pattern"),
+    },
+    niche_report: { label: "Reading the niche", kind: "text", n: 1, steps: evidenceSteps("niche_report") },
+    // ─── Make something ───
+    write_hooks: { label: "Reading the source post", kind: "text", n: 1, steps: evidenceSteps("write_hooks") },
+    create_variants: {
+        label: "Reading the post that worked",
+        kind: "text",
+        n: 1,
+        steps: evidenceSteps("create_variants"),
+    },
+    repurpose_post: {
+        label: "Reading the source post",
+        kind: "text",
+        n: 1,
+        steps: evidenceSteps("repurpose_post"),
+    },
+    // Fetches nothing: the draft is already the caller's.
+    score_draft: { label: "Scoring the draft", kind: "text", n: 1, steps: [], free: true },
+    // ─── Brand monitoring ───
+    search_mentions: {
+        label: "Sweeping for mentions",
+        kind: "list",
+        n: 6,
+        steps: [],
+        perUnit: [
+            {
+                via: "search_mentions",
+                label: "Sweeping a network",
+                detail: "every comment that names the term",
+                credits: CREDITS_PER_NETWORK,
+                arg: "platforms",
+                defaultCount: SEARCH_PLATFORMS.length,
+                perPlatform: true,
+            },
+        ],
+        note: "Priced per network. Omitting platforms means all of them.",
+    },
+    // The one plan whose arithmetic is not a single argument read straight off:
+    // it mirrors the worst case jobs.ts computes before it asks to spend, line
+    // for line, because the two numbers are shown to the same person minutes
+    // apart and any gap between them reads as one of them lying.
+    search_spoken_mentions: {
+        label: "Listening for mentions",
+        kind: "list",
+        n: 4,
+        steps: [],
+        perUnit: [
+            {
+                via: "discover_social_posts",
+                label: "Sweeping for candidates",
+                detail: "per network, when a niche is given",
+                credits: BACKEND_CALL_CREDITS.discover_social_posts,
+                arg: "platforms",
+                only: SPOKEN_PLATFORMS,
+                defaultCount: SPOKEN_PLATFORMS.length,
+                onlyWith: "niche",
+            },
+            {
+                via: "get_user_posts",
+                label: "Checking a creator",
+                detail: "once per network asked for",
+                credits: BACKEND_CALL_CREDITS.get_user_posts,
+                arg: "usernames",
+                per: { arg: "platforms", only: SPOKEN_PLATFORMS, defaultCount: SPOKEN_PLATFORMS.length },
+                defaultCount: 0,
+                max: MAX_SPOKEN_HANDLE_CALLS,
+                ceilingWith: "useWatchlist",
+            },
+            {
+                via: "get_post_transcript",
+                label: "Transcribing a candidate",
+                detail: "most-viewed first, up to the ceiling",
+                credits: BACKEND_CALL_CREDITS.get_post_transcript,
+                arg: "maxTranscripts",
+                defaultCount: 8,
+                min: 1,
+                max: MAX_SPOKEN_TRANSCRIPTS,
+            },
+        ],
+        note: "The ceiling is the price. Only the survivors are transcribed.",
+    },
+    catch_up_watchlist: {
+        label: "Checking your watchlist",
+        kind: "list",
+        n: 5,
+        steps: [],
+        perUnit: [CREATOR_UNIT],
+        note: "Priced per creator on the watchlist.",
+    },
+    // ─── The goal tools (jobs.ts) ───
+    answer_my_audience: {
+        label: "Reading your own replies",
+        kind: "list",
+        n: 6,
+        steps: [step("get_user_posts")],
+        perUnit: [
+            {
+                via: "get_post_comments",
+                label: "Opening a post",
+                detail: "reading what was asked under it",
+                credits: BACKEND_CALL_CREDITS.get_post_comments,
+                arg: "limit",
+                defaultCount: 6,
+            },
+        ],
+    },
+    track_competitor: {
+        label: "Reading what they shipped",
+        kind: "strip",
+        n: 3,
+        steps: [step("get_user_posts")],
+    },
+    who_should_i_work_with: {
+        label: "Building a shortlist",
+        kind: "list",
+        n: 5,
+        steps: [step("search_creators")],
+        perUnit: [
+            {
+                via: "get_similar_creators",
+                label: "Adding their lookalikes",
+                credits: BACKEND_CALL_CREDITS.get_similar_creators,
+                defaultCount: 1,
+                onlyWith: "seed",
+            },
+        ],
+    },
+    why_did_this_underperform: {
+        label: "Measuring it against their own median",
+        kind: "text",
+        n: 1,
+        steps: [step("get_social_media"), step("get_user_posts")],
+    },
+    what_should_i_make_next: {
+        label: "Reading demand against supply",
+        kind: "list",
+        n: 6,
+        steps: [step("get_user_posts"), step("discover_social_posts")],
+        perUnit: [
+            {
+                via: "get_post_comments",
+                label: "Reading a post's comments",
+                detail: "what the audience asked for",
+                credits: BACKEND_CALL_CREDITS.get_post_comments,
+                arg: "limit",
+                defaultCount: 4,
+            },
+        ],
+    },
+    // ─── Draws what the caller already has: no fetch, no price ───
+    show_comment_review: { label: "Drawing the labels", kind: "list", n: 6, steps: [], free: true },
+    show_audience_replies: { label: "Laying out the drafts", kind: "list", n: 5, steps: [], free: true },
+    // ─── Draws what the caller already produced: no fetch, no price ───
+    // The show_* family renders the model's own output. A wait here is brief
+    // and free, but it still says which, because "nothing is happening" and
+    // "this is free and instant" look identical on a blank screen.
+    show_analysis: { label: "Drawing the reading", kind: "text", n: 1, steps: [], free: true },
+    show_comparison: { label: "Drawing the comparison", kind: "strip", n: 2, steps: [], free: true },
+    show_hooks: { label: "Laying out the hooks", kind: "list", n: 5, steps: [], free: true },
+    show_variants: { label: "Laying out the variants", kind: "list", n: 4, steps: [], free: true },
+    show_repurposed_post: { label: "Laying out the rewrites", kind: "text", n: 1, steps: [], free: true },
+    show_collab_shortlist: { label: "Drawing the shortlist", kind: "list", n: 5, steps: [], free: true },
+    prepare_handoff: { label: "Packaging the handoff", kind: "list", n: 4, steps: [], free: true },
+    // ─── Own-account reads: nooticr's own stored rows ───
+    get_scheduled_posts: { label: "Reading your pipeline", kind: "list", n: 5, steps: [], free: true },
+    get_post_performance: { label: "Reading your numbers", kind: "list", n: 5, steps: [], free: true },
+    get_video_stats: { label: "Reading the last sync", kind: "strip", n: 3, steps: [], free: true },
+    get_brand_playbook: { label: "Reading the playbook", kind: "text", n: 1, steps: [], free: true },
+    // ─── The product analysis: the one own-account tool that spends ───
+    // The only outbound fetch in this family — it reads an excerpt of the
+    // product's own site — and it is billed against the workspace's plan AI
+    // credits, not the personal MCP balance.
+    analyze_product: { label: "Starting the analysis", kind: "text", n: 1, steps: [], planAi: true },
+    // Free to poll: the spend already happened when the job was started.
+    analyze_product_status: {
+        label: "Checking the analysis",
+        kind: "text",
+        n: 1,
+        steps: [],
+        free: true,
+    },
+    // ─── Scheduled monitoring (brand-watch.ts) ───
+    // Managing a schedule is not using it: the sweeps a watch makes are billed
+    // as search_mentions when the worker runs them, later and elsewhere.
+    create_brand_watch: { label: "Setting up the watch", kind: "text", n: 1, steps: [], free: true },
+    list_brand_watches: { label: "Reading your watches", kind: "list", n: 3, steps: [], free: true },
+    stop_brand_watch: { label: "Stopping the watch", kind: "text", n: 1, steps: [], free: true },
+    // ─── Own-account reads: nooticr's own stored rows, never an upstream call ───
+    list_own_apps: { label: "Reading your products", kind: "list", n: 3, steps: [], free: true },
+    get_content_plan: { label: "Reading the saved plan", kind: "text", n: 1, steps: [], free: true },
+    // Calls AI, but the dashboard's own pre-publish review has never billed for
+    // it, so neither does this.
+    review_post: { label: "Scoring the post", kind: "text", n: 1, steps: [], free: true },
+    // ─── Own-account generation: a different balance ───
+    draft_post: { label: "Drafting the post", kind: "text", n: 1, steps: [], planAi: true },
+    growth_brief: { label: "Writing the brief", kind: "text", n: 1, steps: [], planAi: true },
+    generate_content_plan: {
+        label: "Planning the week",
+        kind: "list",
+        n: 5,
+        steps: [],
+        planAi: true,
+    },
+    generate_captions: { label: "Writing the captions", kind: "text", n: 1, steps: [], planAi: true },
+    // ─── Account and own-account: free, and free at a zero balance ───
+    check_nooticr_credits: { label: "Checking your balance", kind: "text", n: 1, steps: [], free: true },
+    buy_nooticr_credits: { label: "Opening checkout", kind: "text", n: 1, steps: [], free: true },
+    nooticr_login: { label: "Getting a sign-in link", kind: "text", n: 1, steps: [], free: true },
+    watch_creator: { label: "Adding to your watchlist", kind: "text", n: 1, steps: [], free: true },
+    unwatch_creator: { label: "Removing from your watchlist", kind: "text", n: 1, steps: [], free: true },
+    list_social_connections: { label: "Reading your connections", kind: "list", n: 3, steps: [], free: true },
+    connect_social_account: { label: "Minting a fresh link", kind: "text", n: 1, steps: [], free: true },
+    create_product: { label: "Writing the row", kind: "text", n: 1, steps: [], free: true },
+    update_product: { label: "Patching the row", kind: "text", n: 1, steps: [], free: true },
+};
+/** Everything the view needs, as one JSON blob substituted into the template. */
+export function loadingPlansJson() {
+    return JSON.stringify({
+        plans: LOADING_PLANS,
+        platforms: SEARCH_PLATFORMS,
+        perNetwork: CREDITS_PER_NETWORK,
+        xiaohongshu: XIAOHONGSHU_CREDITS,
+    });
+}
+/** Tools that fan out over an argument, for the tests that pin the wait. */
+export const ARGUMENT_PRICED = Object.keys(LOADING_PLANS).filter((t) => !!LOADING_PLANS[t].perUnit);

package/dist/shared/output-schemas.js

@@ -587,6 +587,9 @@ export const OUTPUT_SCHEMAS = {
                 text: scalar().describe("The spoken line, with surrounding context to judge tone from."),
                 position: scalar().describe("Character offset of the match inside the full transcript."),
                 occurrence: scalar().describe("Which match this is, 1-based. Only the first few carry an excerpt."),
+                startMs: scalar().describe("When it was said, from the caption track's own cue timings. Absent, never " +
+                    "estimated, when the platform published no timings."),
+                timecode: scalar().describe('The same instant as "4:12".'),
             })),
             wordCount: scalar(),
             language: scalar(),
@@ -599,6 +602,16 @@ export const OUTPUT_SCHEMAS = {
     }),
     get_post_transcript: open({
         available: scalar().describe("false when the post carries no caption track."),
+        // Deliberately no text: it is already in `transcript`, and a caption
+        // track is long enough that sending it twice would be a real cost in a
+        // payload that ends up in a model's context. `offset` is what makes that
+        // safe — it indexes into the transcript that is there.
+        cues: listOf(open({
+            startMs: scalar().describe("When this line starts, in milliseconds."),
+            endMs: scalar(),
+            offset: scalar().describe("Where this line's words begin in `transcript`, in UTF-16 code units — so a match " +
+                "found at a string index maps back to the moment it was said."),
+        })).describe("Cue timings, where the platform published a timed track. Absent for speech-to-text."),
         transcript: scalar(),
         wordCount: scalar(),
         language: scalar(),

package/dist/shared/own-account.js

@@ -87,6 +87,7 @@ export function registerOwnAccountTools(server, makeClient) {
         }
     });
     server.registerTool("create_product", {
+        _meta: viewMeta("create_product"),
         title: "Create Product",
         description: "Create a new product (\"app\") in your own workspace — the row every other own-account " +
             "tool needs before it has anything to work with; a fresh workspace has none. Takes no " +
@@ -138,6 +139,7 @@ export function registerOwnAccountTools(server, makeClient) {
         }
     });
     server.registerTool("update_product", {
+        _meta: viewMeta("update_product"),
         title: "Update Product",
         description: "Patch your own product's fields — omitted arguments leave their column unchanged. Takes " +
             "appId (optional when your workspace has only one product); every other field is " +

package/dist/shared/prompts.js

@@ -355,7 +355,7 @@ export function registerPrompts(server) {
         `than the caption, because that is usually where a brand gets named. 2 credits per network ` +
         `swept, 5 for Xiaohongshu — a bare call with no platforms sweeps all nine for 21 credits, so ` +
         `say that number before you spend it if the user has not already narrowed it.\n` +
-        `2. search_spoken_mentions for "${brand}"${niche ? ` narrowed by "${niche}"` : ", narrowed by the niche you just found"} — the words said out loud on TikTok and ` +
+        `2. search_spoken_mentions for "${brand}"${niche ? ` narrowed by "${niche}"` : ", narrowed by the niche you just found"} — the words said out loud on TikTok, Douyin and ` +
         `YouTube that search_mentions cannot see, because it only reads text. 2 credits per platform ` +
         `the niche is searched on, 2 per named handle checked, 1 per transcript actually fetched up ` +
         `to maxTranscripts — pricier than search_mentions, which is why it runs second.\n` +

package/dist/shared/spend.js

@@ -10,6 +10,32 @@ export const SEARCH_PLATFORMS = [
     "reddit",
     "weibo",
 ];
+/**
+ * The networks `search_spoken_mentions` can reach on the caption-track route.
+ *
+ * These three are the ones whose post detail already carries a caption track,
+ * so a transcript is one synchronous read at 1 credit —
+ * `TRANSCRIPT_CAPTION_PLATFORMS` in nooticr-server, mirrored here.
+ *
+ * This list is the *fast path*, not the boundary of what could be searched:
+ * `get_post_transcript`'s `_` arm transcribes any other platform's audio with
+ * whisper, behind the same tool at the same price. It stays a fast path rather
+ * than the whole story for two reasons that are about the deployment, not the
+ * network — speech-to-text is gated on a `WHISPER_MODEL` no environment sets
+ * yet, and the listening path byte-downloads the media, so an HLS-only
+ * platform (Reddit) and one that carries no media URL at all (Bilibili) cannot
+ * be reached even once it is configured. Widening past these three waits on
+ * nooticr-server#39 and #42; the earlier wording here claimed instead that
+ * listening was "a different tool at a different price", which was wrong on
+ * both halves and is why Douyin sat unreachable behind a two-network limit
+ * despite reading captions exactly like the other two.
+ *
+ * Named here rather than inline because three places have to agree on it — the
+ * tool's own enum, the filter it puts every requested platform through, and the
+ * wait that prices the sweep. A platform the filter drops but the price counts
+ * is a credit quoted for a call that never happens.
+ */
+export const SPOKEN_PLATFORMS = ["tiktok", "youtube", "douyin"];
 /** Two per network, except the one that costs an order of magnitude more upstream. */
 export const CREDITS_PER_NETWORK = 2;
 export const XIAOHONGSHU_CREDITS = 5;

package/dist/shared/tools-def.js

@@ -3,7 +3,7 @@ export const TOOL_DEFINITIONS = [
     {
         name: "analyze_post",
         title: "Analyze Post",
-        description: "Frames sampled evenly across a social post (video, image, carousel/slideshow), returned as real images you can look at, together with the post's transcript, caption and stats. It hands you the material rather than a verdict: read the frames and the words, then work out the hook, the structure, the visual style, the CTA and the audience yourself, citing the frame or line behind each claim. Supports TikTok, Instagram, YouTube, X, Reddit, Douyin, Xiaohongshu, Weibo and Bilibili. Use when the visuals are the point — framing, editing, on-screen text; analyze_post_fast reads the same post without the frames for one credit less. Fans out to get_post_frames and get_post_transcript: 3 nooticr credits, 2 for the frames plus 1 for the transcript.",
+        description: "Frames sampled evenly across a social post (video, image, carousel/slideshow), returned as real images you can look at, together with the post's transcript, caption and stats. It hands you the material rather than a verdict: read the frames and the words, then work out the hook, the structure, the visual style, the CTA and the audience yourself, citing the frame or line behind each claim. Supports TikTok, Instagram, YouTube, X, Reddit, Douyin, Xiaohongshu, Weibo, Bilibili and LinkedIn. Use when the visuals are the point — framing, editing, on-screen text; analyze_post_fast reads the same post without the frames for one credit less. Fans out to get_post_frames and get_post_transcript: 3 nooticr credits, 2 for the frames plus 1 for the transcript.",
         inputSchema: z.object({ url: z.string().describe("Public post URL (TikTok/Instagram/YouTube/X/Reddit/Douyin/Xiaohongshu/Weibo/Bilibili/LinkedIn).") }).strict(),
     },
     {
@@ -57,7 +57,7 @@ export const TOOL_DEFINITIONS = [
     {
         name: "understand_social_post",
         title: "Understand Social Post",
-        description: "The same frames and transcript analyze_post returns, asked a different question: describe what physically happens on screen, in order, with every observation anchored to a frame. Supports TikTok, Instagram, YouTube, X, Reddit, Douyin, Xiaohongshu, Weibo and Bilibili. Use when you need the events rather than the strategy; analyze_post puts the strategic question to the same material. Fans out to get_post_frames and get_post_transcript: 3 nooticr credits, 2 for the frames plus 1 for the transcript.",
+        description: "The same frames and transcript analyze_post returns, asked a different question: describe what physically happens on screen, in order, with every observation anchored to a frame. Supports TikTok, Instagram, YouTube, X, Reddit, Douyin, Xiaohongshu, Weibo, Bilibili and LinkedIn. Use when you need the events rather than the strategy; analyze_post puts the strategic question to the same material. Fans out to get_post_frames and get_post_transcript: 3 nooticr credits, 2 for the frames plus 1 for the transcript.",
         inputSchema: z.object({ url: z.string().describe("Full public post URL (TikTok/Instagram/YouTube/X/Reddit/Douyin/Xiaohongshu/Weibo/Bilibili/LinkedIn)."), focus: z.string().optional().describe("Extra instruction, e.g. 'focus on the CTA'.") }).strict(),
     },
     {
@@ -246,18 +246,6 @@ export const TOOL_DEFINITIONS = [
         description: "List every product (\"app\") in your own workspace — id, name, niche and product type. Call this first when your workspace has more than one product and another own-account tool asks for appId. Reads only your own workspace. No cost to call.",
         inputSchema: z.object({}).strict(),
     },
-    {
-        name: "create_product",
-        title: "Create Product",
-        description: "Create a new product (\"app\") in your own workspace — the row every other own-account tool needs before it has anything to work with. Takes no workspace argument: it always creates in the calling session's own workspace. Subject to your plan's product limit. Does not generate a brand playbook by itself; call analyze_product afterwards for that. name and slug are required; description, website_url, niche, product_type and the store-listing fields are optional and snake_case. Free — no AI call, just a row.",
-        inputSchema: z.object({ name: z.string().describe("Product name."), slug: z.string().describe("URL-safe slug, unique within your workspace."), description: z.string().optional(), website_url: z.string().optional().describe("The product's own site; analyze_product later fetches an excerpt of it."), niche: z.string().optional(), product_type: z.string().optional(), icon_url: z.string().optional(), primary_cta_label: z.string().optional(), primary_cta_url: z.string().optional(), external_listing_id: z.string().optional(), ios_bundle_id: z.string().optional(), android_package: z.string().optional() }).strict(),
-    },
-    {
-        name: "update_product",
-        title: "Update Product",
-        description: "Patch your own product's fields — omitted arguments leave their column unchanged. Takes appId (optional with a single-app workspace); every other field is snake_case, same as create_product. Free — no AI call, just a row.",
-        inputSchema: z.object({ appId: z.number().int().optional().describe("Your product's id. Omit only with a single-app workspace."), name: z.string().optional(), slug: z.string().optional(), description: z.string().optional(), website_url: z.string().optional(), niche: z.string().optional(), product_type: z.string().optional(), icon_url: z.string().optional(), primary_cta_label: z.string().optional(), primary_cta_url: z.string().optional(), external_listing_id: z.string().optional(), ios_bundle_id: z.string().optional(), android_package: z.string().optional() }).strict(),
-    },
     {
         name: "get_brand_playbook",
         title: "Get Brand Playbook",
@@ -381,7 +369,19 @@ export const TOOL_DEFINITIONS = [
     {
         name: "search_spoken_mentions",
         title: "Search Spoken Mentions",
-        description: "Brand mentions people SAY but never type. search_mentions reads captions, post bodies and comments — text — so a video that names a brand only out loud is invisible to it. This reads the words actually spoken, from the platform's own caption track, and searches them for a term. Narrows to candidate posts first (a niche sweep, named creator handles, and/or your watchlist), transcribes only the most-viewed survivors up to a hard ceiling you set, and returns the matched line with surrounding context. TikTok and YouTube only — the only two networks whose posts carry a caption track this cheaply — and even there a video with no captions is invisible to this tool; the result says how many candidates were found, transcribed and matched. Use when a term might be spoken on camera but not written anywhere. Consumes 2 nooticr credits per platform a niche is searched on, 2 per creator handle checked, and 1 per transcript actually fetched, capped by maxTranscripts.",
+        description: "Brand mentions people SAY but never type. search_mentions reads captions, post bodies and comments — text — so a video that names a brand only out loud is invisible to it. This reads the words actually spoken, from the platform's own caption track, and searches them for a term. Narrows to candidate posts first (a niche sweep, named creator handles, and/or your watchlist), transcribes only the most-viewed survivors up to a hard ceiling you set, and returns the matched line with surrounding context. TikTok, YouTube and Douyin — the networks whose post detail already carries a caption track; every other network's audio can be transcribed at the same price but not yet from here, and even on these three a video whose creator disabled captions is invisible to this tool; the result says how many candidates were found, transcribed and matched. Use when a term might be spoken on camera but not written anywhere. Consumes 2 nooticr credits per platform a niche is searched on, 2 per creator handle checked, and 1 per transcript actually fetched, capped by maxTranscripts.",
         inputSchema: z.object({ term: z.string().describe("Brand, product or person to listen for, e.g. 'nooticr'."), platforms: z.array(z.enum(["tiktok", "youtube"])).optional().describe("Which networks to check (default: both)."), niche: z.string().optional().describe("Niche or keyword for a candidate sweep. Provide this, usernames, useWatchlist, or any combination."), usernames: z.array(z.string()).optional().describe("Specific creator handles to check."), useWatchlist: z.boolean().optional().describe("Also check your watchlisted creators on tiktok or youtube."), candidateLimit: z.number().int().optional().describe("Posts pulled per narrowing call (default 15, max 25)."), maxTranscripts: z.number().int().optional().describe("Hard ceiling on transcripts fetched (default 8, max 20).") }).strict(),
     },
+    {
+        name: "create_product",
+        title: "Create Product",
+        description: "Create a product in your own workspace \u2014 the row every other own-account tool needs before it has anything to work with; a fresh workspace has none. Takes no workspace argument: it always creates in the workspace of the session calling it, never one you could name. name and slug are required; every other field is optional and all of them are snake_case, read by exact key \u2014 a camelCase websiteUrl is not an alias, it is a field that lands nowhere. Subject to your plan's product limit; the error names the limit if you hit it. Does not generate a brand playbook. Free \u2014 no AI call, just a row.",
+        inputSchema: z.object({ name: z.string().describe("Product name."), slug: z.string().describe("URL-safe slug, unique within your workspace."), description: z.string().optional(), website_url: z.string().optional().describe("The product's own site; analyze_product later fetches an excerpt of it."), niche: z.string().optional(), product_type: z.string().optional(), icon_url: z.string().optional(), primary_cta_label: z.string().optional(), primary_cta_url: z.string().optional(), external_listing_id: z.string().optional(), ios_bundle_id: z.string().optional(), android_package: z.string().optional() }).strict(),
+    },
+    {
+        name: "update_product",
+        title: "Update Product",
+        description: "Patch your own product's fields \u2014 omitted arguments leave their column unchanged, so this cannot blank a field by not mentioning it. Takes appId, optional when your workspace has exactly one product; every other field is snake_case, the same names create_product takes and read the same way. The result lists which fields were actually written, so a name you spelled wrong shows up as a field that did not change rather than as a silent no-op. Free \u2014 no AI call, just a row.",
+        inputSchema: z.object({ appId: z.number().int().optional().describe("Your product's id. Omit only with a single-product workspace."), name: z.string().optional(), slug: z.string().optional(), description: z.string().optional(), website_url: z.string().optional(), niche: z.string().optional(), product_type: z.string().optional(), icon_url: z.string().optional(), primary_cta_label: z.string().optional(), primary_cta_url: z.string().optional(), external_listing_id: z.string().optional(), ios_bundle_id: z.string().optional(), android_package: z.string().optional() }).strict(),
+    },
 ];

package/dist/shared/tools.js

@@ -20,10 +20,11 @@ import { registerJobTools } from "./jobs.js";
 import { registerBrandWatch } from "./brand-watch.js";
 import { registerOwnAccountTools } from "./own-account.js";
 import { registerConnectionTools } from "./connections.js";
+import { loadingPlansJson } from "./loading-plans.js";
 import { registerHandoff } from "./handoff.js";
 import { registerCollabTools } from "./collab.js";
 /** Current MCP server version — bumped on every deploy for traceability. */
-export const MCP_SERVER_VERSION = "1.26.21";
+export const MCP_SERVER_VERSION = "1.26.23";
 /** MCP Apps extension identifier */
 const UI_EXTENSION = "io.modelcontextprotocol/ui";
 /** MIME type for MCP Apps HTML resources */
@@ -58,8 +59,28 @@ function uiResource(tool) {
  * "Interactive View" and a generic placeholder while Claude, whose URL carries
  * the URI, named the tool. The server is the one party that always knows.
  */
+/**
+ * The view, with the two things it cannot work out for itself baked in.
+ *
+ * The tool name, because a host that serves this HTML from its own URL leaves
+ * no ui:// path to read one out of. And the loading plans, because the view is
+ * a static string with no imports and the alternative — a price list copied by
+ * hand — was wrong about six tools within a day of being written.
+ */
+const LOADING_PLANS_JSON = loadingPlansJson();
+/**
+ * The view as a host actually receives it, for tests and tooling.
+ *
+ * The raw NOOTICR_UI_TEMPLATE still carries its `__NOOTICR_PLANS__`
+ * placeholder, so a browser test that renders it directly gets a view with no
+ * prices and no ledger — passing while the real thing is broken. Anything
+ * that renders the template outside the server should come through here.
+ */
+export function uiTemplateFor(tool = "") {
+    return templateFor(tool);
+}
 function templateFor(tool) {
-    return NOOTICR_UI_TEMPLATE.replace("__NOOTICR_TOOL__", tool);
+    return NOOTICR_UI_TEMPLATE.replace("__NOOTICR_TOOL__", tool).replace('"__NOOTICR_PLANS__"', LOADING_PLANS_JSON);
 }
 /**
  * The skybridge half of a resource read.
@@ -504,8 +525,8 @@ export function createMcpServer(rawMakeClient, opts) {
         // The playbook text and a finished analysis are exactly the kind of prose
         // get_content_plan already proved the generic fallback (a formatted JSON
         // block) is an acceptable view for — see scripts/host-contract.py for why
-        // create_product/update_product/analyze_product, which return only
-        // metadata or a bare job-start ack, do not get one.
+        // analyze_product, whose immediate reply is a bare job-start ack, does not
+        // get one while the status tool that polls it does.
         "get_brand_playbook",
         "analyze_product_status",
         "review_post",
@@ -518,6 +539,15 @@ export function createMcpServer(rawMakeClient, opts) {
         // shortlist through the creator gallery.
         "prepare_handoff",
         "show_collab_shortlist",
+        // The two product writes draw the row they made and what it can reach next
+        // — and, for a patch, which fields actually moved, which is the one thing
+        // the reply says that prose reliably loses.
+        "create_product",
+        "update_product",
+        // The connection pair (connections.ts). Registered view-less at first; the
+        // grant each connection carries is a table, which is what a view is for.
+        "list_social_connections",
+        "connect_social_account",
     ];
     // Human-readable resource name per tool (used in resources/list + tools/list).
     function resourceName(tool) {
@@ -707,7 +737,7 @@ export function createMcpServer(rawMakeClient, opts) {
             "lands and who it is aimed at, citing the frame or line behind each claim. " +
             "It fans out to two fetches and you pay for both. " +
             `${costSentence("analyze_post")} Each frame costs roughly 1,200 tokens of your context. ` +
-            "Supports TikTok, Instagram, YouTube, X, Reddit, Douyin, Xiaohongshu, Weibo and Bilibili. " +
+            "Supports TikTok, Instagram, YouTube, X, Reddit, Douyin, Xiaohongshu, Weibo, Bilibili and LinkedIn. " +
             "Use when the visuals are the point; analyze_post_fast reads the same post without the frames for one credit less.",
         _meta: {
             ui: { resourceUri: uiResource("analyze_post") },
@@ -866,7 +896,7 @@ export function createMcpServer(rawMakeClient, opts) {
                 .enum(["tiktok", "instagram", "youtube", "douyin", "xiaohongshu", "twitter", "bilibili", "linkedin", "reddit", "weibo"])
                 .optional()
                 .describe("Which platform (default tiktok)."),
-            limit: z.number().int().optional().describe("Posts to fetch (default 6; first 3 analyzed)."),
+            limit: z.number().int().optional().describe("Posts to fetch (default 12, max 30)."),
             focus: z.string().optional().describe("Extra instruction for the profile synthesis."),
         })
             .strict(),
@@ -1745,7 +1775,7 @@ export function createMcpServer(rawMakeClient, opts) {
             .object({
             niche: z.string().describe("Niche or topic, e.g. 'home fitness'."),
             platform: z.string().optional().describe("Platform to survey (default tiktok)."),
-            count: z.number().int().optional().describe("Posts to survey (default 20, max 40)."),
+            count: z.number().int().optional().describe("Posts to survey (default 12, max 40)."),
         })
             .strict(),
     }, async (args, extra) => {
@@ -1777,7 +1807,7 @@ export function createMcpServer(rawMakeClient, opts) {
             .object({
             username: z.string().describe("Creator handle, with or without @."),
             platform: z.string().optional().describe("Platform (default tiktok)."),
-            limit: z.number().int().optional().describe("Posts to read (default 20, max 40)."),
+            limit: z.number().int().optional().describe("Posts to read (default 12, max 40)."),
         })
             .strict(),
     }, async (args, extra) => {
@@ -1981,7 +2011,7 @@ export function createMcpServer(rawMakeClient, opts) {
             "what physically happens on screen, in order, with every observation anchored to a frame. " +
             "It fans out to two fetches and you pay for both. " +
             `${costSentence("understand_social_post")} Each frame costs roughly 1,200 tokens of your context. ` +
-            "Supports TikTok, Instagram, YouTube, X, Reddit, Douyin, Xiaohongshu, Weibo and Bilibili. " +
+            "Supports TikTok, Instagram, YouTube, X, Reddit, Douyin, Xiaohongshu, Weibo, Bilibili and LinkedIn. " +
             "Use when you need the events rather than the strategy; analyze_post puts the strategic question to the same material.",
         _meta: {
             ui: { resourceUri: uiResource("understand_social_post") },