@gentbajko/slopify 3.25.8 → 4.0.0

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

@@ -0,0 +1,165 @@
+import { editPictureSchema, makeArtworkSchema, quoteEditSchema, retryStepSchema, } from "../../slices/designs/requests.js";
+import { makeFromTemplateSchema } from "../../slices/designs/template-make.js";
+import { createTemplateSchema, markReadySchema as markDesignReadySchema, saveTemplateSchema, } from "../../slices/designs/templates.js";
+import { sampleRequestSchema } from "../http/design-templates.js";
+import { formBody } from "./route-tool.js";
+// Library → Designs: pictures edited step by step and designed pieces (posters, flyers,
+// brochures, social images), and the design templates they are made from. Every paid step
+// starts only with the acknowledgedHigh its quote gave.
+const paid = "a paid call: send acknowledgedHigh as the quote's high (refused with the new quote when the price rose)";
+export const designTools = [
+    {
+        name: "list_designs",
+        route: "GET /api/designs",
+        title: "List designs",
+        description: "Every design with its versions, newest first. Query: projectId to list one project's.",
+    },
+    {
+        name: "upload_design_picture",
+        route: "POST /api/designs/pictures",
+        title: "Upload a picture to design with",
+        description: "Keeps a PNG or JPEG (at most 10 MB) and answers its sha256, which create_design takes as fromStepSha.",
+        upload: "raw",
+    },
+    {
+        name: "create_design",
+        route: "POST /api/designs",
+        title: "Start a design",
+        description: `Starts an edit from a picture (kind "edit" with fromStepSha or stagedFileId) or a designed piece (kind "design" with its document). Body: {id: a new id of letters, digits, - and _, mutationId: a new UUID, kind, name, channelId?, projectId?, stagedFileId? | fromStepSha?, document?, values?}.`,
+    },
+    {
+        name: "get_design",
+        route: "GET /api/designs/:id",
+        title: "Read a design",
+        description: "One design: its settings, values, current version (headStepId) and every version.",
+    },
+    {
+        name: "update_design",
+        route: "PUT /api/designs/:id",
+        title: "Save a design",
+        description: `Renames it, links it to a project (projectId, or null to unlink), saves its settings (document; an edit with a document becomes a designed piece) and values. Body: {baseUpdatedAt: the updatedAt get_design returns, name?, projectId?, document?, values?}. ${formBody("the design's Text and Formats tabs")}`,
+    },
+    {
+        name: "delete_design",
+        route: "DELETE /api/designs/:id",
+        title: "Delete a design",
+        description: "Moves the design to Settings → Trash, where it stays 30 days.",
+        confirm: "It moves to Settings → Trash. After 30 days it is removed for good with every version and every file drawn from it.",
+    },
+    {
+        name: "quote_design_edit",
+        route: "POST /api/designs/:id/quote",
+        body: quoteEditSchema,
+        title: "Price a picture edit",
+        description: "What one edit costs with this model. Body: {provider, model, castMemberIds?}. Records nothing.",
+        unrecorded: true,
+    },
+    {
+        name: "quote_design_artwork",
+        route: "POST /api/designs/:id/artwork/quote",
+        title: "Price a design's artwork",
+        description: "What drawing the designed piece's artwork costs. Records nothing.",
+        unrecorded: true,
+    },
+    {
+        name: "edit_design_picture",
+        route: "POST /api/designs/:id/edit",
+        body: editPictureSchema,
+        title: "Edit the picture",
+        description: `Changes a version of the picture as the instruction says; the result lands as the next version (read get_design until it is ready or failed). This is ${paid}. Body: {mutationId: a new UUID, fromStepId, instruction, provider, model, castMemberIds?, acknowledgedHigh}.`,
+    },
+    {
+        name: "make_design_artwork",
+        route: "POST /api/designs/:id/artwork",
+        body: makeArtworkSchema,
+        title: "Make the artwork",
+        description: `Draws the designed piece's artwork from its picture prompt with its fields filled. This is ${paid}. Body: {mutationId: a new UUID, acknowledgedHigh}.`,
+    },
+    {
+        name: "retry_design_step",
+        route: "POST /api/designs/:id/steps/:stepId/retry",
+        body: retryStepSchema,
+        title: "Try a failed version again",
+        description: "Asks the provider again for a version that failed, as Try again does. It is paid again, even for a version a restart stopped that may already have been charged: send acknowledgedHigh as the high price quote_design_edit (an edited picture) or quote_design_artwork (artwork) gives for that version's provider and model, and acknowledgedUnknown: true when that price is unknown; refused with the current quote when it differs. Body: {acknowledgedHigh, acknowledgedUnknown?}.",
+    },
+    {
+        name: "set_design_version",
+        route: "PUT /api/designs/:id/head",
+        title: "Continue from a version",
+        description: "Makes a ready version the one the next edit starts from and the files are drawn from. Free. Body: {stepId}.",
+    },
+    {
+        name: "get_design_picture",
+        route: "GET /api/designs/:id/steps/:stepId/picture",
+        title: "See a version",
+        description: "One version of the design's picture, as an image.",
+    },
+    {
+        name: "get_design_file",
+        route: "GET /api/designs/:id/files/:file",
+        title: "Draw a finished piece",
+        description: "Draws the piece in one format with Slopify's text layer, as the design page's Download does: file is <format>.png (a4, a3, flyer, square, portrait, story, wide) or <format>.pdf (a4, a3, flyer, brochure). A PNG comes back as an image; a PDF is drawn and its size reported.",
+    },
+    {
+        name: "list_design_templates",
+        route: "GET /api/design-templates",
+        title: "List design templates",
+        description: "Every design template with its versions and the version marked ready.",
+    },
+    {
+        name: "create_design_template",
+        route: "POST /api/design-templates",
+        body: createTemplateSchema,
+        title: "Create a design template",
+        description: "Body: {id: a new id, mutationId: a new UUID, name, document, channelId?}.",
+    },
+    {
+        name: "get_design_template",
+        route: "GET /api/design-templates/:id",
+        title: "Read a design template",
+        description: "One design template: its newest version, its checks and every version.",
+    },
+    {
+        name: "save_design_template",
+        route: "PUT /api/design-templates/:id",
+        body: saveTemplateSchema,
+        title: "Save a design template",
+        description: `Saves a new version. Body: {baseVersion: the headVersion get_design_template returns, name, document, sample?: "make" | "skip", acknowledgedHigh?}. ${formBody("the template editor")}`,
+    },
+    {
+        name: "delete_design_template",
+        route: "DELETE /api/design-templates/:id",
+        title: "Delete a design template",
+        description: "Moves the template to Settings → Trash, where it stays 30 days.",
+        confirm: "It moves to Settings → Trash, and schedules that make from it stop making pieces. After 30 days it is removed for good with its versions and its sample.",
+    },
+    {
+        name: "quote_design_template",
+        route: "POST /api/design-templates/:id/quote",
+        title: "Price a piece from a template",
+        description: "What one piece made from the template's newest version costs. With a body {document}: what saving that document would cost the editor's sample instead (only a changed picture is paid), with the sections it changes and whether it makes a picture. Records nothing.",
+        unrecorded: true,
+    },
+    {
+        name: "make_design_template_sample",
+        route: "POST /api/design-templates/:id/sample",
+        body: sampleRequestSchema,
+        title: "Make a template's sample",
+        description: `Makes the template editor's sample of a version now, when it is held (it cost more than shown, a price is unknown or the day's sample budget is spent), failed or not made yet. This is ${paid}. Body: {version, acknowledgedHigh: the quote's high}.`,
+    },
+    {
+        name: "mark_design_template_ready",
+        route: "POST /api/design-templates/:id/ready",
+        body: markDesignReadySchema,
+        title: "Mark a template version ready",
+        description: "Runs the version's checks and marks it ready when they pass; refused with the checks that failed. Body: {version}.",
+        confirm: "Schedules start making pieces from this version.",
+    },
+    {
+        name: "make_design_from_template",
+        route: "POST /api/design-templates/:id/make",
+        body: makeFromTemplateSchema,
+        title: "Make a piece from a template",
+        description: `Makes one designed piece from a template version with these values and starts its artwork. This is ${paid}. Body: {mutationId: a new UUID, values, acknowledgedHigh, version?, name?, projectId?}.`,
+    },
+];

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

@@ -10,13 +10,25 @@ export const libraryTools = [
         name: "create_prompt",
         route: "POST /api/prompts",
         title: "Create a prompt",
-        description: "Body: {kind: article | image | thumbnail | narration | description | shorts | review | script, name, body}.",
+        description: "Body: {kind: article | image | thumbnail | narration | description | shorts | review | script, name, body}. A body can use the keywords Slopify fills ({{Slopify_Title}}, {{Slopify_Summary}}, {{Slopify_Scene}}…; list_keywords says which work in which kind); any other name starting with Slopify_ is refused.",
     },
     {
         name: "update_prompt",
         route: "PUT /api/prompts/:id",
         title: "Save a prompt",
-        description: "Body: {kind, name, body}. Saving adds a history version; a rename follows into templates and Play drafts.",
+        description: "Body: {kind, name, body}. Saving adds a history version; a rename follows into templates and Play drafts. The body follows create_prompt's keyword rules; an unknown Slopify_ name the prompt already had is kept.",
+    },
+    {
+        name: "list_keywords",
+        route: "GET /api/keywords",
+        title: "List the keywords Slopify fills",
+        description: "Every {{Slopify_…}} keyword: what it fills in, an example, when it exists, which prompt kinds can use it and what it costs (free, or part of one AI call per run). {{Scene}} and {{Appearance}} are the old names of {{Slopify_Scene}} and {{Slopify_Appearance}}.",
+    },
+    {
+        name: "get_keyword_facts",
+        route: "GET /api/keywords/facts/:projectId",
+        title: "Read a project's keyword facts as they are now",
+        description: "The facts keywords like {{Slopify_Channel}}, {{Slopify_Links}} and {{Slopify_Previous_Video}} are filled from, copied again from the project's channel and its other projects, like Refresh keyword facts in Edit project. Put the answer's keywordFacts into the revision's config and save it with save_revision.",
     },
     {
         name: "set_prompt_photorealistic",

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

@@ -1,3 +1,8 @@
+import { createDraftInputSchema } from "../../slices/play-drafts/schema.js";
+import { templateCreateSchema } from "../../slices/project-templates/schema.js";
+import { startBody, versionBody } from "../http/drafts.js";
+import { nextChapterBody, templateDeleteBody, templateFromProjectBody, templateInstantiateBody, templateUpdateBody, } from "../http/project-templates.js";
+import { saveBody } from "../http/revisions.js";
 import { formBody } from "./route-tool.js";
 const drafts = [
     {
@@ -9,6 +14,7 @@ const drafts = [
     {
         name: "create_draft",
         route: "POST /api/drafts",
+        body: createDraftInputSchema,
         title: "Create a Play draft",
         description: "Create, like New project: a draft whose document is the Play form (kind and outputs, format including square 1:1, sources, prompts, voices, reviews, the queue switch). Body: {id: a new UUID, document}. get_draft shows a document's shape; instantiate_template makes one from a template.",
     },
@@ -21,18 +27,21 @@ const drafts = [
     {
         name: "save_draft",
         route: "PUT /api/drafts/:id",
+        body: saveBody,
         title: "Save a Play draft",
         description: "Saves the draft's document; queue: true is Play's Queue switch, so several videos run one after another. Body: {baseVersion: the draft's version, mutationId: a new UUID, document}.",
     },
     {
         name: "fork_draft",
         route: "POST /api/drafts/:id/fork",
+        body: createDraftInputSchema,
         title: "Copy a Play draft",
         description: "Body: {id: a new UUID for the copy, sourceId: this draft's id, document}.",
     },
     {
         name: "discard_draft",
         route: "DELETE /api/drafts/:id",
+        body: versionBody,
         title: "Discard a Play draft",
         description: "Body: {baseVersion}.",
         confirm: "This discards the draft and its uploaded files for good.",
@@ -40,6 +49,7 @@ const drafts = [
     {
         name: "review_draft",
         route: "POST /api/drafts/:id/review",
+        body: versionBody,
         title: "Review a Play draft",
         description: "Play's Review step: readiness, warnings and the cost estimate the person sees before Start. Body: {baseVersion}. start_draft needs this review's id.",
         unrecorded: true,
@@ -47,6 +57,7 @@ const drafts = [
     {
         name: "start_draft",
         route: "POST /api/drafts/:id/start",
+        body: startBody,
         title: "Start a Play draft",
         description: "Start in Play: starts the reviewed draft's runs, which spend what the review estimated. Body: {baseVersion, reviewId: the id review_draft returned}.",
     },
@@ -83,6 +94,8 @@ const drafts = [
         description: "Removes an uploaded file no edit used.",
     },
 ];
+// Which version a schedule runs after a save (`template-studio/gate.ts`).
+const templateGateRule = "Schedules use a new version from their next run unless a version of this template was marked ready in its Template studio (mark_template_ready); from then on a new version waits until it is marked ready.";
 const templates = [
     {
         name: "list_templates",
@@ -93,20 +106,23 @@ const templates = [
     {
         name: "create_template",
         route: "POST /api/project-templates",
+        body: templateCreateSchema,
         title: "Create a template",
-        description: formBody("the template editor"),
+        description: `${formBody("the template editor")} ${templateGateRule}`,
     },
     {
         name: "template_from_project",
         route: "POST /api/project-templates/from-project/:projectId",
+        body: templateFromProjectBody,
         title: "Save a project as a template",
-        description: formBody("Save as template on the project page"),
+        description: `${formBody("Save as template on the project page")} ${templateGateRule}`,
     },
     {
         name: "next_chapter_template",
         route: "POST /api/project-templates/next-chapter/:projectId",
+        body: nextChapterBody,
         title: "Template for the next chapter",
-        description: formBody("Next chapter on the project page"),
+        description: `${formBody("Next chapter on the project page")} ${templateGateRule}`,
     },
     {
         name: "get_template",
@@ -117,12 +133,14 @@ const templates = [
     {
         name: "update_template",
         route: "PUT /api/project-templates/:id",
+        body: templateUpdateBody,
         title: "Save a template",
-        description: `${formBody("the template editor")} Saving adds a version.`,
+        description: `${formBody("the template editor")} Saving adds a version. ${templateGateRule}`,
     },
     {
         name: "delete_template",
         route: "DELETE /api/project-templates/:id",
+        body: templateDeleteBody,
         title: "Delete a template",
         description: formBody("Delete in Library → Templates"),
         confirm: "Moves it to the trash for 30 days (Settings → Trash). Existing projects and drafts keep their setup.",
@@ -130,6 +148,7 @@ const templates = [
     {
         name: "instantiate_template",
         route: "POST /api/project-templates/:id/instantiate",
+        body: templateInstantiateBody,
         title: "Use a template",
         description: "Opens a new Play draft from the template, like Use template.",
     },

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.
@@ -55,7 +59,7 @@ const projects = [
         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}.',
     },
@@ -130,12 +154,14 @@ const decisions = [
     {
         name: "approve_checkpoint",
         route: "POST /api/projects/:id/checkpoints/:checkpointId/approve",
+        body: approvalBody,
         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}.",
     },
     {
         name: "change_checkpoints",
         route: "PATCH /api/projects/:id/checkpoints",
+        body: checkpointChangeSchema,
         title: "Change checkpoints",
         description: 'Sets the stages that stop for approval, like the Checkpoints tab. Body: {revisionId, stages: ["audio" | "images" | "video"]}.',
     },
@@ -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-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,6 +43,7 @@ const runs = [
     {
         name: "rerun_stage",
         route: "POST /api/projects/:id/stages/:kind/rerun",
+        body: revisionControlSchema,
         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.",
@@ -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,18 +77,21 @@ 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.",
     },
     {
         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}.",
     },
     {
         name: "preview_rebuild",
         route: "POST /api/projects/:id/rebuild/preview",
+        body: previewRebuildSchema,
         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.',
         unrecorded: true,
@@ -87,6 +99,7 @@ const revisions = [
     {
         name: "start_rebuild",
         route: "POST /api/projects/:id/rebuild",
+        body: startRebuildSchema,
         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}.",
     },

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 marked ready.`,
     },
     {
         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.",
@@ -65,8 +73,9 @@ export const scheduleTools = [
     {
         name: "prepare_topic",
         route: "POST /api/schedules/:id/topics/prepare",
+        body: prepareTopicBody,
         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}.",
+        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 and while the schedule is paused. Body: {topic: the topic's title}.",
     },
     {
         name: "generate_topics",
@@ -74,6 +83,13 @@ export const scheduleTools = [
         title: "Suggest topics",
         description: "Asks the schedule's text 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",
         route: "POST /api/schedules/:id/topics/held/approve-all",
@@ -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"),
     },