@gentbajko/slopify 3.25.9 → 4.1.0

package/dist/edge/mcp/tools-projects.js

@@ -1,5 +1,9 @@
 import { z } from "zod";
+import { checkpointChangeSchema } from "../../slices/checkpoints/change.js";
+import { revisionControlSchema } from "../../slices/control/revision-control-schema.js";
+import { addOutputPreviewRequestSchema, addOutputRequestSchema, } from "../../slices/outputs/model.js";
 import { oldVersionsConsequence } from "../../slices/storage/consequences.js";
+import { approvalBody } from "../http/checkpoints.js";
 import { control } from "./route-tool.js";
 import { listWithStateWords, projectWithStateWords } from "./state-shapes.js";
 // What get_project_storage (and the page's Free up space) reads for the old versions.
@@ -9,7 +13,7 @@ const projects = [
         name: "list_projects",
         route: "GET /api/projects",
         title: "List projects",
-        description: "Every project as the Projects list shows it: id, title, status, stateWord (how Slopify's pages say it: Queued, Running, Paused, Waiting for your review, Waiting for the agent, Stopped (only Continue the run, resume_project, goes on), Prepared, Kept as is, Failed, Done with problems, Done, Canceled; an uploaded project reads Done once nothing it admitted is left to run; a run whose step failed while another step waits for the agent or the person reads by that wait, with stepFailed: true, and Failed once nothing else can go on), stepFailures (each step that failed while another step waits for the agent, the person or its day, even while a third still runs, as kind@finishedAt; absent otherwise), progress from 0 to 1, channelId and uploadedAt.",
+        description: "Every project as the Projects list shows it: id, title, status, stateWord (how Slopify's pages say it: Queued, Running, Paused, Waiting for your review, Waiting for the agent, Stopped (only Continue the run, resume_project, goes on), Waiting for its day (made ahead by its schedule), Kept as is, Failed, Done with problems, Done, Canceled; an uploaded project reads Done once nothing it admitted is left to run; a run whose step failed while another step waits for the agent or the person reads by that wait, with stepFailed: true, and Failed once nothing else can go on), stepFailures (each step that failed while another step waits for the agent, the person or its day, even while a third still runs, as kind@finishedAt; absent otherwise), progress from 0 to 1, channelId and uploadedAt.",
         shape: listWithStateWords,
     },
     {
@@ -24,7 +28,7 @@ const projects = [
         route: "DELETE /api/projects/:id",
         title: "Delete a project",
         description: "Delete on the Projects list: moves the project to the trash. A running project is refused: cancel it first.",
-        confirm: "This moves the project to Settings → Backup & storage → Trash, where it is kept 30 days before it is deleted for good.",
+        confirm: "This moves the project to Settings → Trash, where it is kept 30 days before it is deleted for good.",
     },
     {
         name: "move_projects_to_channel",
@@ -36,7 +40,7 @@ const projects = [
         name: "get_run_queue",
         route: "GET /api/projects/queue",
         title: "Read the run queue",
-        description: "The batch queue: projects waiting their turn, in order. Play's Queue switch (the draft's queue field) puts a run's videos here.",
+        description: "The batch queue: projects waiting their turn, in order. Create's One after another switch (the draft's queue field) puts a run's videos here.",
     },
     {
         name: "move_in_run_queue",
@@ -48,14 +52,14 @@ const projects = [
         name: "estimate_run",
         route: "POST /api/projects/estimate",
         title: "Estimate a run",
-        description: "The cost estimate Play shows before Start. Body: {draft: a run draft, expectedWords?: 1-100000, items?}. For a Play draft, review_draft returns the same estimate.",
+        description: "The cost estimate Create shows before Make the video. Body: {draft: a run draft, expectedWords?: 1-100000, items?}. For a draft on Create, review_draft returns the same estimate.",
         unrecorded: true,
     },
     {
         name: "get_run_cost",
         route: "GET /api/projects/:id/run-cost",
         title: "Read a project's run cost",
-        description: "What the project's runs cost so far, by stage and provider, and any wait on a CLI plan's limits, as its Run cost tab shows.",
+        description: 'What the project\'s runs cost so far, by stage and provider, and any wait on a CLI plan\'s limits, as its Run cost tab shows. Each plan window has two figures: usedPercent, this run\'s own share from each call\'s before→after readings (basis "measured"; "split" when overlapping calls shared a rise by tokens; "shared" when some calls ran beside other use on the account and are not counted, usedPercent null if none could be told apart; "approximate" for projects run before per-call readings were kept, the account\'s rise as an upper bound), and fromPercent → nowPercent, all use on the account while the run went (accountPercent, never above 100), with resetsAt.',
     },
     {
         name: "get_week",
@@ -63,6 +67,24 @@ const projects = [
         title: "Read this week",
         description: "Home's This week: videos made, calls, cost and CLI plan standings. Query: {since: an ISO time, channelId?}.",
     },
+    {
+        name: "get_autopilot",
+        route: "GET /api/home/autopilot",
+        title: "Read autopilot health",
+        description: "Home's autopilot block: how far ahead the schedules' content is (forecast: readyCount, daysAhead, coveredUntil, runsDryAt and each schedule's own), the warnings that may stop them (each with key, what failed, why, and where the fix is), checkedAt (when sign-ins, the OpenRouter key and the disk were last checked, hourly), the last seven days (finished, failed steps, cost) and weeklyNotify. It never starts a CLI. Query: {channelId?}.",
+    },
+    {
+        name: "hide_autopilot_warning",
+        route: "POST /api/home/autopilot/snooze",
+        title: "Hide an autopilot warning",
+        description: "Hide, like the button beside a warning on Home: the warning stays hidden for 7 days, or until it changes. It fixes nothing. Body: {key: a warning's key from get_autopilot}.",
+    },
+    {
+        name: "set_weekly_report",
+        route: "PUT /api/home/autopilot/weekly",
+        title: "Turn the weekly report on or off",
+        description: "Settings → Notifications → Weekly report: each Monday from 09:00 Slopify sends last week's report (made, failed, cost) to the Notification URL. Off by default. Body: {enabled: true | false}.",
+    },
     {
         name: "mark_uploaded",
         route: "PUT /api/projects/:id/uploaded",
@@ -109,6 +131,7 @@ const outputs = [
     {
         name: "preview_added_output",
         route: "POST /api/projects/:id/outputs/preview",
+        body: addOutputPreviewRequestSchema,
         title: "Preview another output",
         description: "Add another output, first step: what the new output reuses, makes and is estimated to cost, and any choice the project lacks for it. Body: {baseRevisionId, kind: narration | audiobook | images | video | pdf | podcast}.",
         unrecorded: true,
@@ -116,6 +139,7 @@ const outputs = [
     {
         name: "add_output",
         route: "POST /api/projects/:id/outputs",
+        body: addOutputRequestSchema,
         title: "Add another output",
         description: 'Switches the output on as a new version and answers the workKeys to make; it starts nothing. Then preview_rebuild with {kind: "selected", workKeys} and start_rebuild, as the page\'s Add does. Body: {baseRevisionId, idempotencyKey: a new UUID, kind, adapt?: true to accept rewriting the text as a conversation}.',
     },
@@ -124,20 +148,22 @@ const decisions = [
     {
         name: "get_checkpoints",
         route: "GET /api/projects/:id/checkpoints",
-        title: "Read review checkpoints",
-        description: "The project's review checkpoints: each gate's stage, state, fingerprint and currentFingerprint. A gate is Waiting for your review while held.",
+        title: "Read the pauses for your review",
+        description: "The project's pauses for your review (Pauses and checks): each gate's stage, state, fingerprint and currentFingerprint. A gate is Waiting for your review while held.",
     },
     {
         name: "approve_checkpoint",
         route: "POST /api/projects/:id/checkpoints/:checkpointId/approve",
-        title: "Approve a checkpoint",
-        description: "Approves a held checkpoint so the stages after it run, like Approve on the project page. Body: {revisionId, fingerprint: the gate's currentFingerprint, idempotencyKey: a new UUID}.",
+        body: approvalBody,
+        title: "Approve a pause",
+        description: "Approves a held pause so the stages after it run, like Approve and make the … on the project page. Body: {revisionId, fingerprint: the gate's currentFingerprint, idempotencyKey: a new UUID}.",
     },
     {
         name: "change_checkpoints",
         route: "PATCH /api/projects/:id/checkpoints",
-        title: "Change checkpoints",
-        description: 'Sets the stages that stop for approval, like the Checkpoints tab. Body: {revisionId, stages: ["audio" | "images" | "video"]}.',
+        body: checkpointChangeSchema,
+        title: "Change the pauses",
+        description: 'Sets the stages that stop for approval, like Pause after … in Edit settings → Pauses and checks. Body: {revisionId, stages: ["audio" | "images" | "video"]}.',
     },
     {
         name: "list_reviews",
@@ -154,6 +180,7 @@ const decisions = [
     {
         name: "redo_review",
         route: "POST /api/projects/:id/reviews/:verdictId/redo",
+        body: revisionControlSchema,
         title: "Redo a flagged item",
         description: `Makes a flagged item again, like Redo beside it. ${control}`,
     },

package/dist/edge/mcp/tools-publishing.js

@@ -36,32 +36,32 @@ const uploadPrep = [
     {
         name: "get_upload_pack",
         route: "GET /api/studio/packs/:projectId",
-        title: "Read the upload pack",
-        description: "Prepare upload: the title, description, tags, thumbnails, playlists and release time of each upload (the video and each short), and the plan's free slots. The agent's work ends here, at Ready to upload: uploading is the person's.",
+        title: "Read Copy for YouTube Studio",
+        description: "Copy for YouTube Studio: the title, description, tags, thumbnails, playlists and release time of each upload (the video and each short), and the plan's free release times (slots). The agent's work ends here, at Ready to upload: uploading is the person's.",
     },
     {
         name: "set_pack_slot",
         route: "PUT /api/studio/packs/:projectId/slot",
-        title: "Choose the release slot",
-        description: "Prepare upload's slot picker: one of the free slots get_upload_pack lists, or none. Body: {slot: {row, longAt} | null}.",
+        title: "Choose the release time",
+        description: "Copy for YouTube Studio's release picker: one of the free release times (slots) get_upload_pack lists, or none. Body: {slot: {row, longAt} | null}.",
     },
     {
         name: "set_pack_real_footage",
         route: "PUT /api/studio/packs/:projectId/real-footage",
         title: "Set the altered-content answer",
-        description: "Prepare upload's AI use tick: the project's uploaded clips are real footage. Body: {realFootage: true | false}.",
+        description: "Copy for YouTube Studio's AI use tick: the project's uploaded clips are real footage. Body: {realFootage: true | false}.",
     },
     {
         name: "set_pack_pick",
         route: "PUT /api/studio/packs/:projectId/pick",
         title: "Pick the title and thumbnail",
-        description: "Prepare upload's pick: which title and thumbnail the upload carries (the A/B test tries the others once the video is public). Body: {title: 0-9, thumbnail: 0-9}.",
+        description: "Copy for YouTube Studio's pick: which title and thumbnail the upload carries (the A/B test tries the others once the video is public). Body: {title: 0-9, thumbnail: 0-9}.",
     },
     {
         name: "set_pack_playlists",
         route: "PUT /api/studio/packs/:projectId/playlists",
-        title: "Set the pack's playlists",
-        description: "Prepare upload's playlist ticks. Body: {playlists: [names] | null for the channel's defaults}.",
+        title: "Set the upload's playlists",
+        description: "Copy for YouTube Studio's playlist ticks. Body: {playlists: [names] | null for the channel's defaults}.",
     },
     {
         name: "get_fill_queue",
@@ -137,7 +137,7 @@ const youtube = [
         name: "get_ab_results",
         route: "GET /api/studio/ab-results",
         title: "Read A/B results",
-        description: "Library → A/B results: every finished title and thumbnail test.",
+        description: "What worked on YouTube (on a channel's page): every finished title and thumbnail test.",
     },
 ];
 export const publishingTools = [

package/dist/edge/mcp/tools-runs.js

@@ -1,20 +1,26 @@
+import { revisionControlSchema } from "../../slices/control/revision-control-schema.js";
+import { previewRebuildSchema, startRebuildSchema } from "../../slices/rebuild/model.js";
+import { restoreBody, saveBody } from "../http/revisions.js";
 import { control } from "./route-tool.js";
 const runs = [
     {
         name: "pause_project",
         route: "POST /api/projects/:id/pause",
+        body: revisionControlSchema,
         title: "Pause",
         description: `Pause: the run stops after the steps already sent finish; nothing starts until resume_project. ${control}`,
     },
     {
         name: "resume_project",
         route: "POST /api/projects/:id/resume",
+        body: revisionControlSchema,
         title: "Continue the run",
         description: `Continue the run: starts the project's held and unfinished work, including work a saved edit left waiting. On a canceled run it resumes the whole run, the canceled steps too; once a step of it was taken up again (retry_stage), only the steps taken up again go on and the rest stay canceled. ${control}`,
     },
     {
         name: "cancel_project",
         route: "POST /api/projects/:id/cancel",
+        body: revisionControlSchema,
         title: "Cancel run",
         description: `Cancel run: stops every running stage of the project. ${control}`,
         confirm: "Cancel this run? It stops every running stage; finished outputs are kept.",
@@ -22,12 +28,14 @@ const runs = [
     {
         name: "retry_stage",
         route: "POST /api/projects/:id/stages/:kind/retry",
+        body: revisionControlSchema,
         title: "Try again",
         description: `Try again on a failed step (kind: research, article, audio, images, thumbnail, video or document), keeping what it already made. ${control}`,
     },
     {
         name: "soften_stage",
         route: "POST /api/projects/:id/stages/:kind/soften",
+        body: revisionControlSchema,
         title: "Soften and retry",
         description: `Soften and retry, for a picture a content filter refused (kind images or thumbnail, or video for a short's picture): rewords the refused prompts and draws them again. ${control}`,
         confirm: "Your project's AI model rewrites each refused prompt without what a content filter could flag, keeping the scene and style. The image is then drawn again from the new wording, which it keeps as its prompt. The AI call and the new image are charged like any other.",
@@ -35,9 +43,10 @@ const runs = [
     {
         name: "rerun_stage",
         route: "POST /api/projects/:id/stages/:kind/rerun",
-        title: "Re-run a stage",
-        description: `Re-run section: makes a stage again and everything built on it. A re-run that costs money is refused until it is reviewed: use preview_rebuild (Choose what to remake), then start_rebuild. ${control}`,
-        confirm: "Re-run this stage? It generates the stage and its dependent outputs again, which costs what the stage cost the first time; previous outputs stay in History.",
+        body: revisionControlSchema,
+        title: "Make a stage again",
+        description: `A section's Make … again button (Write the article again, Make all images again): makes a stage again and everything built on it. Making again what costs money is refused until it is reviewed: use preview_rebuild (Choose what to make again), then start_rebuild. ${control}`,
+        confirm: "Make this stage again? It makes the stage and what is built on it again, which costs what the stage cost the first time; the previous outputs stay under Versions.",
     },
 ];
 const revisions = [
@@ -51,7 +60,7 @@ const revisions = [
         name: "list_revisions",
         route: "GET /api/projects/:id/revisions",
         title: "Read project history",
-        description: "Every saved version of the project, newest first, as Project history lists them (byAgent marks one an agent saved), and agentActions: what agents did in the project.",
+        description: "Every saved version of the project, newest first, as Project history lists them (byAgent marks one an agent saved, byAssistant one the in-app assistant saved), and agentActions: what agents and the assistant did in the project (actor says which).",
     },
     {
         name: "get_revision",
@@ -68,27 +77,31 @@ const revisions = [
     {
         name: "save_revision",
         route: "POST /api/projects/:id/revisions",
+        body: saveBody,
         title: "Save an edit",
-        description: "Saves an edit as a new version, like Save in Edit project; it starts nothing. Body: {baseRevisionId, idempotencyKey: a new UUID, edit: {config, content, regenerate?: [work keys to make again, such as a narration chunk key], uploads?: [{stagedFileId, destination}]}}; send get_revision's revision.config and revision.content with your change. One chunk's wording or delivery note is content.narrationOverrides[chunk key] = {kind: \"text\", text, direction?}. Finished shorts kept through a new pick are content.shortsKeep: leave one out to pick a new moment for it, and lower config.shorts.count as well to drop it. Then preview_rebuild (Choose what to remake) says what it makes and costs, and start_rebuild starts it.",
+        description: "Saves an edit as a new version, like Save in Edit settings; it starts nothing. Body: {baseRevisionId, idempotencyKey: a new UUID, edit: {config, content, regenerate?: [work keys to make again, such as a narration chunk key], uploads?: [{stagedFileId, destination}]}}; send get_revision's revision.config and revision.content with your change. One chunk's wording or delivery note is content.narrationOverrides[chunk key] = {kind: \"text\", text, direction?}. Finished shorts kept through a new pick are content.shortsKeep: leave one out to pick a new moment for it, and lower config.shorts.count as well to drop it. Then preview_rebuild (Choose what to make again) says what it makes and costs, and start_rebuild starts it.",
     },
     {
         name: "restore_revision",
         route: "POST /api/projects/:id/revisions/restore",
+        body: restoreBody,
         title: "Restore a version",
-        description: "Makes an earlier version current again, like Restore this revision; it starts nothing. Body: {baseRevisionId, idempotencyKey: a new UUID, targetRevisionId}.",
+        description: "Makes an earlier version current again, like Restore on a row of Versions; it starts nothing. Body: {baseRevisionId, idempotencyKey: a new UUID, targetRevisionId}.",
     },
     {
         name: "preview_rebuild",
         route: "POST /api/projects/:id/rebuild/preview",
-        title: "Choose what to remake",
-        description: 'Choose what to remake: what a remake makes again, reuses or leaves blocked, each output\'s estimate and the total, like the project\'s Choose what to remake. Body: {baseRevisionId, request: {kind: "allAffected"} | {kind: "selected", workKeys: [...]}}. Nothing starts; start_rebuild does, with this preview\'s id.',
+        body: previewRebuildSchema,
+        title: "Choose what to make again",
+        description: 'Choose what to make again: what making it again makes, reuses or leaves blocked, each output\'s estimate and the total, like the project\'s Choose what to make again. Body: {baseRevisionId, request: {kind: "allAffected"} | {kind: "selected", workKeys: [...]}}. Nothing starts; start_rebuild does, with this preview\'s id.',
         unrecorded: true,
     },
     {
         name: "start_rebuild",
         route: "POST /api/projects/:id/rebuild",
-        title: "Start a remake",
-        description: "Starts the remake you previewed: the acknowledgement Choose what to remake asks for. Body: {baseRevisionId, idempotencyKey: a new UUID, previewId: the preview's id, acknowledgeUnknownCosts: true only after reading the preview's unknown costs, confirmedProvidedWorkKeys: the preview's providedReuseRequired keys you accept replacing}.",
+        body: startRebuildSchema,
+        title: "Make the previewed parts again",
+        description: "Starts making again what you previewed: the acknowledgement Choose what to make again asks for. Body: {baseRevisionId, idempotencyKey: a new UUID, previewId: the preview's id, acknowledgeUnknownCosts: true only after reading the preview's unknown costs, confirmedProvidedWorkKeys: the preview's providedReuseRequired keys you accept replacing}.",
     },
 ];
 export const runTools = [...runs, ...revisions];

package/dist/edge/mcp/tools-schedules.js

@@ -1,3 +1,5 @@
+import { heldTopicEditSchema, scheduleCreateSchema, scheduleSaveBodySchema, scheduleVersionBodySchema, topicMoveSchema, topicQueueSchema, topicTransferSchema, } from "../../slices/schedules/schema.js";
+import { approveHeldTopicBody, heldIds, heldRestore, prepareTopicBody } from "../http/schedules.js";
 import { formBody } from "./route-tool.js";
 export const scheduleTools = [
     {
@@ -9,36 +11,41 @@ export const scheduleTools = [
     {
         name: "create_schedule",
         route: "POST /api/schedules",
+        body: scheduleCreateSchema,
         title: "Create a schedule",
-        description: `${formBody("the schedule editor")} Duplicate on a schedule is this with get_schedule's settings, a new id, a new name ending "(copy)" and items: [], then pause_schedule on the copy.`,
+        description: `${formBody("the schedule editor")} Duplicate on a schedule is this with get_schedule's settings, a new id, a new name ending "(copy)" and items: [], then pause_schedule on the copy. A design schedule (one designed piece per row, made ahead of the row's date) is {templateKind: "design", templateId: the design template's id, templateVersion: its headVersion, cadence: {kind: "by-date", time: "HH:MM"}, items: [{title, values: {every field, the date field as YYYY-MM-DD}}]}; it has no topic generation or release days, and makes only from a version approved for schedules.`,
     },
     {
         name: "get_schedule",
         route: "GET /api/schedules/:id",
         title: "Read a schedule",
-        description: "One schedule with its topic queue and release lines.",
+        description: "One schedule with its topic queue and release lines, and scores: each queued topic's score (0-100) and reasons by normalised title while the schedule ranks topics (topicScoring library or search).",
     },
     {
         name: "update_schedule",
         route: "PUT /api/schedules/:id",
+        body: scheduleSaveBodySchema,
         title: "Save a schedule",
-        description: `${formBody("the schedule editor")} Its release lines set when each run's videos are released.`,
+        description: `${formBody("the schedule editor")} Its release lines set when each run's videos are released. topicScoring ranks generated topics: "off" (the default), "library" (by what the library already covers) or "search" (also by public search interest: sends topic titles to Google, DuckDuckGo and Wikipedia); left out, a save keeps it.`,
     },
     {
         name: "pause_schedule",
         route: "POST /api/schedules/:id/pause",
+        body: scheduleVersionBodySchema,
         title: "Pause a schedule",
         description: "No run starts from it until resume_schedule.",
     },
     {
         name: "resume_schedule",
         route: "POST /api/schedules/:id/resume",
+        body: scheduleVersionBodySchema,
         title: "Resume a schedule",
         description: "Runs start from it again at its times.",
     },
     {
         name: "cancel_schedule",
         route: "POST /api/schedules/:id/cancel",
+        body: scheduleVersionBodySchema,
         title: "Cancel a schedule",
         description: "Cancel schedule, as the schedule's page does.",
         confirm: "Stops future scheduled runs. Existing projects and run history are kept.",
@@ -46,6 +53,7 @@ export const scheduleTools = [
     {
         name: "delete_schedule",
         route: "DELETE /api/schedules/:id",
+        body: scheduleVersionBodySchema,
         title: "Delete a schedule",
         description: "Moves the schedule to the trash.",
         confirm: "Moves this schedule to the trash for 30 days (Settings → Trash). Its run history is kept.",
@@ -59,20 +67,28 @@ export const scheduleTools = [
     {
         name: "list_prepared_topics",
         route: "GET /api/schedules/:id/prepared",
-        title: "Read prepared topics",
-        description: "Which queued topics are Prepared ahead, and their projects.",
+        title: "Read topics made ahead",
+        description: "Which queued topics are made ahead (Make ahead), and their projects.",
     },
     {
         name: "prepare_topic",
         route: "POST /api/schedules/:id/topics/prepare",
-        title: "Prepare a topic",
-        description: "Prepare, from the schedule's topics or Open on calendar: makes the topic's project now, exactly as the schedule would, and runs everything but the video, which its scheduled day renders. It spends what Play's review estimates and is refused over the schedule's spend limit. Body: {topic: the topic's title}.",
+        body: prepareTopicBody,
+        title: "Make a topic ahead",
+        description: "Make ahead, on a topic in the calendar: makes the topic's project now, exactly as the schedule would, and runs everything but the video, which its scheduled day puts together. It spends what Create's estimate says and is refused over the schedule's spend limit and while the schedule is paused. Body: {topic: the topic's title}.",
     },
     {
         name: "generate_topics",
         route: "POST /api/schedules/:id/topics/generate",
         title: "Suggest topics",
-        description: "Asks the schedule's text model for topics, a paid call, like Suggest topics.",
+        description: "Asks the schedule's AI model for topics, a paid call, like Suggest topics.",
+    },
+    {
+        name: "score_topics",
+        route: "POST /api/schedules/:id/topics/score",
+        title: "Rescore topics",
+        description: "Rescore, like the button under the schedule's queue: scores every queued and held topic again (by what the library already covers; with search ranking also by Google, DuckDuckGo and Wikipedia, which are sent each topic's title) and puts them in score order. Topics the person added or moved keep their places. Refused while the schedule's Rank topics is Off. get_schedule and list_held_topics answer the scores (score 0-100 and reasons, by normalised title).",
+        reachesOut: "asks",
     },
     {
         name: "approve_all_topics",
@@ -83,24 +99,28 @@ export const scheduleTools = [
     {
         name: "approve_topics",
         route: "POST /api/schedules/:id/topics/held/approve",
+        body: heldIds,
         title: "Approve selected topics",
         description: "Approve selected: moves these held topics into the queue. Body: {ids: [held topic ids]}.",
     },
     {
         name: "reject_topics",
         route: "POST /api/schedules/:id/topics/held/reject",
+        body: heldIds,
         title: "Reject selected topics",
         description: "Reject selected, or Reject all with every id shown: later generations won't suggest them again. Body: {ids: [held topic ids]}.",
     },
     {
         name: "restore_topics",
         route: "POST /api/schedules/:id/topics/held/restore",
+        body: heldRestore,
         title: "Bring rejected topics back",
         description: `The Undo after a rejection: puts turned-down topics back. ${formBody("the Undo in the rejection's message")}`,
     },
     {
         name: "approve_topic",
         route: "POST /api/schedules/:id/topics/held/:topicId/approve",
+        body: approveHeldTopicBody,
         title: "Approve a topic",
         description: formBody("Approve in Calendar → Suggested topics"),
     },
@@ -113,24 +133,28 @@ export const scheduleTools = [
     {
         name: "edit_held_topic",
         route: "PUT /api/schedules/:id/topics/held/:topicId",
+        body: heldTopicEditSchema,
         title: "Edit a suggested topic",
         description: formBody("the suggested topic's editor"),
     },
     {
         name: "set_topic_queue",
         route: "PUT /api/schedules/:id/topics",
+        body: topicQueueSchema,
         title: "Set the topic queue",
         description: `${formBody("the schedule's topic queue")} Bulk paste is this with the pasted topics added to the queue.`,
     },
     {
         name: "move_topic",
         route: "POST /api/schedules/:id/topics/move",
+        body: topicMoveSchema,
         title: "Move a topic",
         description: `Reorders the queue. ${formBody("the topic queue's move")}`,
     },
     {
         name: "transfer_topic",
         route: "POST /api/schedules/:id/topics/transfer",
+        body: topicTransferSchema,
         title: "Move a topic to another schedule",
         description: formBody("the topic queue's move to another schedule"),
     },

package/dist/edge/mcp/tools-setup.js

@@ -1,5 +1,10 @@
 import { z } from "zod";
 import { readinessIsUsable } from "../../kernel/ports/model.js";
+import { costPhrase } from "../../slices/model-checks/rules.js";
+import { quoteBody } from "../http/auditions.js";
+import { checkBody } from "../http/model-checks.js";
+import { switchBody } from "../http/providers.js";
+import { notificationBody } from "../http/settings.js";
 import { formBody } from "./route-tool.js";
 const readinessShape = z.discriminatedUnion("kind", [
     z.object({ kind: z.literal("keyed"), hasKey: z.boolean() }).loose(),
@@ -48,23 +53,35 @@ export function notificationUrlState(value) {
     return { notificationUrl: url === null || url.trim() === "" ? "missing" : "configured" };
 }
 const settings = [
+    {
+        name: "get_remote_access",
+        route: "GET /api/settings/remote-access",
+        title: "Read remote access",
+        description: "Settings → Remote access: whether Slopify's page is open on the person's other devices through Tailscale serve (their tailnet only, never the public internet), its https address, and any problem with the exact fix. Turning it on or off is the person's; agents can't.",
+    },
     {
         name: "get_settings",
         route: "GET /api/settings",
         title: "Read production defaults",
-        description: "Settings → Production defaults: silence gap, appearance, loudness and the English subtitle timing model.",
+        description: "Settings → Production defaults: silence gap, appearance, loudness, the English subtitle timing model and the render settings (video encoder, clip encoding, render priority).",
     },
     {
         name: "update_settings",
         route: "PUT /api/settings",
         title: "Save production defaults",
-        description: "Body: {silenceGapSeconds, appearance: system | light | dark, loudness?: {enabled, videoLufs, audioFilesLufs}, subtitleModel?: fp32 | fp16 | int8}. subtitleModel is this computer's English caption-timing model (fp32 378 MB most accurate, the default; fp16 189 MB; int8 95 MB, less accurate); it never marks subtitles outdated.",
+        description: "Body: {silenceGapSeconds, appearance: system | light | dark, loudness?: {enabled, videoLufs, audioFilesLufs}, subtitleModel?: fp32 | fp16 | int8, videoEncoder?: cpu | nvidia, clipEncodeSpeed?: thorough | fast, renderPriority?: normal | background}. subtitleModel is this computer's English caption-timing model (fp32 378 MB most accurate, the default; fp16 189 MB; int8 95 MB, less accurate). videoEncoder nvidia encodes on the NVIDIA card (check get_video_encoders first; a render falls back to the processor when it does not work); clipEncodeSpeed fast encodes the clips under burned-in captions with x264 veryfast; renderPriority background runs renders below normal priority. None of these marks anything outdated.",
+    },
+    {
+        name: "get_video_encoders",
+        route: "GET /api/settings/encoders",
+        title: "Check the NVIDIA encoder",
+        description: "Settings → Production defaults → Video encoder: whether this computer's NVIDIA encoder (NVENC) works, and why not when it does not. The first check runs a tiny test encode.",
     },
     {
         name: "get_default_channel_links",
         route: "GET /api/settings/channel-links",
         title: "Read the default channel links",
-        description: "Settings → Channel links: the links a description's {{Name}} placeholders fill from.",
+        description: "Settings → YouTube Studio and posting: the links a description's {{Name}} placeholders fill from.",
     },
     {
         name: "set_default_channel_links",
@@ -82,6 +99,7 @@ const settings = [
     {
         name: "set_notification_url",
         route: "PUT /api/settings/notifications",
+        body: notificationBody,
         title: "Save the Notification URL",
         description: "Body: {url: an http(s) address, or empty to stop}. Answers configured or missing, never the address.",
         shape: notificationUrlState,
@@ -128,8 +146,9 @@ const settings = [
     {
         name: "quote_voice_sample",
         route: "POST /api/auditions/quote",
+        body: quoteBody,
         title: "Price a voice sample",
-        description: "Try a sample's price, as Play shows it before playing one. Body: {lines: [{speaker, provider, model, text}]}.",
+        description: "Try a sample's price, as Create shows it before playing one. Body: {lines: [{speaker, provider, model, text}]}.",
         unrecorded: true,
     },
     {
@@ -148,7 +167,7 @@ const settings = [
         name: "get_studio_settings",
         route: "GET /api/studio/settings",
         title: "Read YouTube Studio settings",
-        description: "Settings → YouTube Studio: the playlists upload packs name, and whether the comment is posted.",
+        description: "Settings → YouTube Studio and posting: the playlists upload packs name, and whether the comment is posted.",
         shape: withoutExtensionSecrets,
     },
     {
@@ -168,15 +187,59 @@ const providers = [
     {
         name: "list_providers",
         route: "GET /api/providers",
-        title: "List providers",
-        description: "Each provider as configured or missing.",
+        title: "List the services",
+        description: "Each service on Settings → Keys & services, as configured or missing.",
         shape: configuredOrMissing,
     },
     {
         name: "list_models",
         route: "GET /api/providers/:id/models",
-        title: "List a provider's models",
-        description: "The models Slopify offers for the provider, with prices where known.",
+        title: "List a service's models",
+        description: "The models Slopify offers for the provider, with prices where known, and each model's standing for the saved key or CLI under standings: works (a check or a run succeeded), listed (the key's own model list names it), known (only Slopify's model list does), no-access (the provider said it is not on the plan, with its sentence), and retiring with its replacement when one is due. Standings never stop a run: a model chosen anywhere keeps working as before.",
+    },
+    {
+        name: "get_model_checks",
+        route: "GET /api/model-checks",
+        title: "Read Settings → Models' model checks",
+        description: "Per provider: when its models were last checked, how many work, are listed or are not on the plan, whether a check is running and what checks have cost; the New for you list; and whether automatic checks are free-only or off.",
+    },
+    {
+        name: "estimate_model_checks",
+        route: "GET /api/providers/:id/models/check/estimate",
+        title: "Estimate checking a service's models",
+        description: "What Check models in Settings → Models would check for this provider and what it costs at list price, before anything is sent. Query: models (optional, comma-separated ids).",
+    },
+    {
+        name: "check_models",
+        route: "POST /api/providers/:id/models/check",
+        body: checkBody,
+        title: "Check a service's models",
+        description: "Settings → Models' Check models: sends each model the smallest request (one word, a spoken Hi, one small image) to learn whether it works for the saved key or CLI, in the background. A check that costs money is refused with its estimate until the body carries confirmedDollars of at least the estimate's totalDollars (read estimate_model_checks first). Body: {models?: [ids], confirmedDollars?: number}.",
+        confirm: "Each model checked is sent one small paid request at list price (a CLI's checks use its plan's allowance instead).",
+        confirmFrom: {
+            route: "/api/providers/:id/models/check/estimate",
+            text: (value) => {
+                const estimate = z
+                    .object({
+                    count: z.number(),
+                    totalDollars: z.number(),
+                    unpriced: z.number(),
+                    planAccounts: z.array(z.string()),
+                })
+                    .safeParse(value);
+                if (!estimate.success)
+                    return undefined;
+                const { count, totalDollars, unpriced, planAccounts } = estimate.data;
+                return `Checks ${String(count)} model${count === 1 ? "" : "s"}, one small request each: ${costPhrase(totalDollars, unpriced)}${planAccounts.length > 0 ? ", using the CLI plan's allowance" : ""}.`;
+            },
+        },
+        reachesOut: "asks",
+    },
+    {
+        name: "dismiss_model_notices",
+        route: "POST /api/model-checks/notices/dismiss",
+        title: "Dismiss New for you models",
+        description: "Settings → Models' Dismiss on New for you. Body: {keys: [{provider, family, model}]} as get_model_checks lists them.",
     },
     {
         name: "list_system_voices",
@@ -187,8 +250,8 @@ const providers = [
     {
         name: "check_providers",
         route: "POST /api/providers/health",
-        title: "Check providers",
-        description: "Settings → Providers' Check all: which providers answer and which CLIs are signed in.",
+        title: "Check every service",
+        description: "Settings → Keys & services' Check every service: which services answer and which CLIs are signed in.",
         unrecorded: true,
         reachesOut: "asks",
     },
@@ -221,6 +284,7 @@ const providers = [
     {
         name: "switch_retired_model",
         route: "POST /api/providers/catalogue/retired/switch",
+        body: switchBody,
         title: "Switch a retired model",
         description: formBody("Settings → Models' Switch"),
     },