@gentbajko/slopify 3.16.0 → 3.18.0

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

@@ -0,0 +1,148 @@
+import { formBody } from "./route-tool.js";
+const description = [
+    {
+        name: "get_description_edits",
+        route: "GET /api/projects/:id/youtube-edits",
+        title: "Read description edits",
+        description: "The YouTube description, tags, pinned comment and titles as written, with the person's hand edits.",
+    },
+    {
+        name: "get_project_channel_links",
+        route: "GET /api/projects/:id/channel-links",
+        title: "Read the project's channel links",
+        description: "The links the description's {{Name}} placeholders fill from for this project.",
+    },
+    {
+        name: "edit_description_field",
+        route: "PUT /api/projects/:id/youtube-edits/fields/:field",
+        title: "Edit a description field",
+        description: "Hand-edits one field (field: a name get_description_edits lists). Body: {text: the new text, base: the text you edited from}.",
+    },
+    {
+        name: "reset_description_field",
+        route: "DELETE /api/projects/:id/youtube-edits/fields/:field",
+        title: "Drop a description edit",
+        description: "Drops the hand edit of one field; the written text comes back.",
+        confirm: "This drops your hand edit of this field for good; the text Slopify wrote comes back.",
+    },
+    {
+        name: "set_description_links",
+        route: "PUT /api/projects/:id/youtube-edits/links",
+        title: "Set the description's links",
+        description: "The links this project's description fills its {{Name}} placeholders from. Body: {links: [{name, url}]}.",
+    },
+];
+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.",
+    },
+    {
+        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}.",
+    },
+    {
+        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}.",
+    },
+    {
+        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}.",
+    },
+    {
+        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}.",
+    },
+    {
+        name: "get_fill_queue",
+        route: "GET /api/studio/queue",
+        title: "Read the Studio fill queue",
+        description: "What waits for the person's Slopify Studio extension, oldest first.",
+    },
+    {
+        name: "remove_from_fill_queue",
+        route: "POST /api/studio/queue/remove",
+        title: "Remove from the fill queue",
+        description: "Takes an upload off the extension's queue (agents never add one). Body: {projectId, short: a short's number or null for the video}.",
+    },
+];
+const releases = [
+    {
+        name: "get_releases",
+        route: "GET /api/studio/releases",
+        title: "Read Calendar → Releases",
+        description: "The coming weeks' long videos and shorts with their release time, upload-by time and state (not-ready, ready, late = \"Late · upload now\", filled, scheduled), the posting plan's free times and the finished projects that could fill them. Query: {weeks?: 1-8}.",
+    },
+    {
+        name: "get_project_releases",
+        route: "GET /api/studio/releases/:projectId",
+        title: "Read a project's release times",
+        description: "The project page's Release block: the release time and upload-by time of the video and each short, and the plan's free times for its series.",
+    },
+    {
+        name: "swap_releases",
+        route: "POST /api/studio/releases/:projectId/swap",
+        title: "Swap with…",
+        description: "Swap with…: two videos trade their release times; their shorts follow each. Body: {with: the other project's id}.",
+    },
+    {
+        name: "set_release",
+        route: "PUT /api/studio/releases/:projectId",
+        title: "Set a release time",
+        description: "Moves one release (short 0 is the long video), sets it to Not scheduled (at: null), or Take this time: puts the project into a free time of the plan (short 0 with that time's line). Body: {short, at: an ISO time | null, line?}.",
+    },
+    {
+        name: "get_posting_plan",
+        route: "GET /api/studio/plan",
+        title: "Read the posting plan",
+        description: "The posting plan's lines, its lead time and the series the projects use.",
+    },
+    {
+        name: "set_posting_plan",
+        route: "PUT /api/studio/plan",
+        title: "Save the posting plan",
+        description: formBody("Calendar → Releases' posting plan"),
+    },
+    {
+        name: "set_lead_time",
+        route: "PUT /api/studio/settings/lead-hours",
+        title: "Set the lead time",
+        description: "How many hours before its release a video must be uploaded. Body: {hours}.",
+    },
+];
+const youtube = [
+    {
+        name: "get_youtube_videos",
+        route: "GET /api/studio/videos/:projectId",
+        title: "Read On YouTube",
+        description: "The YouTube videos a project's uploads became: upload state, checks, the A/B test and the finishing touches (end screen, captions, related video, pinned comment) with any failure message.",
+    },
+    {
+        name: "set_youtube_link",
+        route: "PUT /api/studio/videos/:projectId",
+        title: "Set or forget a YouTube link",
+        description: "Records the YouTube link of an upload made without the extension, or with an empty link is Deleted on YouTube: Slopify forgets the video so it can be uploaded again. Body: {short: a short's number or null for the video, link}.",
+    },
+    {
+        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.",
+    },
+];
+export const publishingTools = [
+    ...description,
+    ...uploadPrep,
+    ...releases,
+    ...youtube,
+];

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

@@ -0,0 +1,94 @@
+import { control } from "./route-tool.js";
+const runs = [
+    {
+        name: "pause_project",
+        route: "POST /api/projects/:id/pause",
+        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",
+        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",
+        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.",
+    },
+    {
+        name: "retry_stage",
+        route: "POST /api/projects/:id/stages/:kind/retry",
+        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",
+        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.",
+    },
+    {
+        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.",
+    },
+];
+const revisions = [
+    {
+        name: "prepare_revision",
+        route: "POST /api/projects/:id/revisions/prepare",
+        title: "Prepare an older project for editing",
+        description: "Saves the first version of a project made before versions existed; nothing is generated.",
+    },
+    {
+        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.",
+    },
+    {
+        name: "get_revision",
+        route: "GET /api/projects/:id/revisions/:revisionId",
+        title: "Read a version",
+        description: "One version in full: revision.config and revision.content (send them back as save_revision's edit.config and edit.content), its outputs, pieces and text parts.",
+    },
+    {
+        name: "read_narration_chunks",
+        route: "GET /api/projects/:id/revisions/:revisionId/narration-chunks",
+        title: "Read narration chunk keys",
+        description: 'The narration chunk keys in spoken order, per segment: {chunks: {intro?, body?, outro?}}. "Narration chunk 5 of 10" in an error is chunks.body[4] (an intro or outro chunk is named after its segment); the key is what save_revision\'s edit.regenerate and content.narrationOverrides take.',
+    },
+    {
+        name: "save_revision",
+        route: "POST /api/projects/:id/revisions",
+        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",
+        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",
+        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,
+    },
+    {
+        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}.",
+    },
+];
+export const runTools = [...runs, ...revisions];

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

@@ -0,0 +1,143 @@
+import { formBody } from "./route-tool.js";
+export const scheduleTools = [
+    {
+        name: "list_schedules",
+        route: "GET /api/schedules",
+        title: "List schedules",
+        description: "Schedules with their next runs, release lines and topic queues.",
+    },
+    {
+        name: "create_schedule",
+        route: "POST /api/schedules",
+        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.`,
+    },
+    {
+        name: "get_schedule",
+        route: "GET /api/schedules/:id",
+        title: "Read a schedule",
+        description: "One schedule with its topic queue and release lines.",
+    },
+    {
+        name: "update_schedule",
+        route: "PUT /api/schedules/:id",
+        title: "Save a schedule",
+        description: `${formBody("the schedule editor")} Its release lines set when each run's videos are released.`,
+    },
+    {
+        name: "pause_schedule",
+        route: "POST /api/schedules/:id/pause",
+        title: "Pause a schedule",
+        description: "No run starts from it until resume_schedule.",
+    },
+    {
+        name: "resume_schedule",
+        route: "POST /api/schedules/:id/resume",
+        title: "Resume a schedule",
+        description: "Runs start from it again at its times.",
+    },
+    {
+        name: "cancel_schedule",
+        route: "POST /api/schedules/:id/cancel",
+        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.",
+    },
+    {
+        name: "delete_schedule",
+        route: "DELETE /api/schedules/:id",
+        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.",
+    },
+    {
+        name: "list_held_topics",
+        route: "GET /api/schedules/:id/topics/held",
+        title: "Read suggested topics",
+        description: "Topics the schedule generated and holds for approval, as Calendar → Suggested topics lists them.",
+    },
+    {
+        name: "list_prepared_topics",
+        route: "GET /api/schedules/:id/prepared",
+        title: "Read prepared topics",
+        description: "Which queued topics are Prepared 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}.",
+    },
+    {
+        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.",
+    },
+    {
+        name: "approve_all_topics",
+        route: "POST /api/schedules/:id/topics/held/approve-all",
+        title: "Approve every suggested topic",
+        description: "Moves every held topic into the queue.",
+    },
+    {
+        name: "approve_topics",
+        route: "POST /api/schedules/:id/topics/held/approve",
+        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",
+        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",
+        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",
+        title: "Approve a topic",
+        description: formBody("Approve in Calendar → Suggested topics"),
+    },
+    {
+        name: "reject_topic",
+        route: "POST /api/schedules/:id/topics/held/:topicId/reject",
+        title: "Reject a topic",
+        description: "Turns down one suggested topic.",
+    },
+    {
+        name: "edit_held_topic",
+        route: "PUT /api/schedules/:id/topics/held/:topicId",
+        title: "Edit a suggested topic",
+        description: formBody("the suggested topic's editor"),
+    },
+    {
+        name: "set_topic_queue",
+        route: "PUT /api/schedules/:id/topics",
+        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",
+        title: "Move a topic",
+        description: `Reorders the queue. ${formBody("the topic queue's move")}`,
+    },
+    {
+        name: "transfer_topic",
+        route: "POST /api/schedules/:id/topics/transfer",
+        title: "Move a topic to another schedule",
+        description: formBody("the topic queue's move to another schedule"),
+    },
+    {
+        name: "get_calendar",
+        route: "GET /api/calendar",
+        title: "Read the calendar",
+        description: "Upcoming scheduled runs (each with its prepared project, if any) and projects, each with needs (failed, paused, stopped, review) and readyToUpload. Query: {from, to: ISO times at most 92 days apart}.",
+    },
+];

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

@@ -0,0 +1,234 @@
+import { z } from "zod";
+import { readinessIsUsable } from "../../kernel/ports/model.js";
+import { formBody } from "./route-tool.js";
+const readinessShape = z.discriminatedUnion("kind", [
+    z.object({ kind: z.literal("keyed"), hasKey: z.boolean() }).loose(),
+    z
+        .object({ kind: z.literal("cli"), installed: z.boolean(), issue: z.string().optional() })
+        .loose(),
+    z
+        .object({ kind: z.literal("local"), available: z.boolean(), issue: z.string().optional() })
+        .loose(),
+]);
+const providerList = z.object({
+    providers: z.array(z.object({
+        id: z.string(),
+        family: z.string(),
+        displayName: z.string(),
+        readiness: z.custom((value) => readinessShape.safeParse(value).success),
+    })),
+});
+// Providers as agents see them: set up or not, never whether a key exists or where a CLI is.
+export function configuredOrMissing(value) {
+    const parsed = providerList.safeParse(value);
+    if (!parsed.success)
+        return { providers: [] };
+    return {
+        providers: parsed.data.providers.map((provider) => ({
+            id: provider.id,
+            family: provider.family,
+            displayName: provider.displayName,
+            state: readinessIsUsable(provider.readiness) ? "configured" : "missing",
+        })),
+    };
+}
+// The Studio settings without the extension's pairing token (a credential) and its unpacked
+// folder (host setup).
+export function withoutExtensionSecrets(value) {
+    const parsed = z.record(z.string(), z.unknown()).safeParse(value);
+    return parsed.success
+        ? Object.fromEntries(Object.entries(parsed.data).filter(([key]) => key !== "pairing" && key !== "unpacked"))
+        : {};
+}
+// The Notification URL can carry a secret (a webhook's token, a private ntfy topic): agents are
+// told only whether one is set, and change it with set_notification_url.
+export function notificationUrlState(value) {
+    const parsed = z.object({ url: z.string().nullable() }).loose().safeParse(value);
+    const url = parsed.success ? parsed.data.url : null;
+    return { notificationUrl: url === null || url.trim() === "" ? "missing" : "configured" };
+}
+const settings = [
+    {
+        name: "get_settings",
+        route: "GET /api/settings",
+        title: "Read production defaults",
+        description: "Settings → Production defaults: silence gap, appearance and loudness.",
+    },
+    {
+        name: "update_settings",
+        route: "PUT /api/settings",
+        title: "Save production defaults",
+        description: "Body: {silenceGapSeconds, appearance: system | light | dark, loudness?: {enabled, videoLufs, audioFilesLufs}}.",
+    },
+    {
+        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.",
+    },
+    {
+        name: "set_default_channel_links",
+        route: "PUT /api/settings/channel-links",
+        title: "Save the default channel links",
+        description: "Body: {links: [{name, url}]}.",
+    },
+    {
+        name: "get_notification_url",
+        route: "GET /api/settings/notifications",
+        title: "Check the Notification URL",
+        description: "Whether run notifications have somewhere to go: configured or missing. The address itself is never shown to agents.",
+        shape: notificationUrlState,
+    },
+    {
+        name: "set_notification_url",
+        route: "PUT /api/settings/notifications",
+        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,
+    },
+    {
+        name: "send_test_notification",
+        route: "POST /api/settings/notifications/test",
+        title: "Send a test notification",
+        description: "Body: {url}.",
+        unrecorded: true,
+        reachesOut: "sends",
+    },
+    {
+        name: "list_voices",
+        route: "GET /api/settings/voices",
+        title: "List voices",
+        description: "Settings → Voices.",
+    },
+    {
+        name: "add_voice",
+        route: "POST /api/settings/voices",
+        title: "Add a voice",
+        description: "Body: {provider, name, voiceId, languages?: [primary language codes]}.",
+    },
+    {
+        name: "set_voice_languages",
+        route: "PUT /api/settings/voices/:id/languages",
+        title: "Set a voice's languages",
+        description: formBody("Settings → Voices' languages"),
+    },
+    {
+        name: "set_voice_real_person",
+        route: "PUT /api/settings/voices/:id/real-person",
+        title: "Mark a voice as a real person's",
+        description: formBody("Settings → Voices' real-person box"),
+    },
+    {
+        name: "remove_voice",
+        route: "DELETE /api/settings/voices/:id",
+        title: "Remove a voice",
+        description: "Removes the voice from Settings → Voices.",
+        confirm: "Projects that used this voice keep the audio they made with it.",
+    },
+    {
+        name: "quote_voice_sample",
+        route: "POST /api/auditions/quote",
+        title: "Price a voice sample",
+        description: "Try a sample's price, as Play shows it before playing one. Body: {lines: [{speaker, provider, model, text}]}.",
+        unrecorded: true,
+    },
+    {
+        name: "get_usage",
+        route: "GET /api/usage",
+        title: "Read usage",
+        description: "Settings → Usage: this machine's usage counters.",
+    },
+    {
+        name: "get_diagnostics",
+        route: "GET /api/diagnostics",
+        title: "Download diagnostics",
+        description: "What Download diagnostics saves: versions, secret-free provider readiness, the project count and the model catalogue's state.",
+    },
+    {
+        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.",
+        shape: withoutExtensionSecrets,
+    },
+    {
+        name: "set_studio_playlists",
+        route: "PUT /api/studio/settings/playlists",
+        title: "Save playlist kinds",
+        description: "Playlist kinds: the playlists upload packs name (long videos, shorts or both), for every channel or one. Body: {playlists: [{name, byDefault, for?: long | shorts | both}], channelId?}.",
+    },
+    {
+        name: "get_agent_connection",
+        route: "GET /api/settings/agents",
+        title: "Read Settings → Connections → Agents (MCP)",
+        description: "When an agent last connected to Slopify's MCP endpoint, and the latest changes agents made, as Settings → Connections → Agents (MCP) lists them.",
+    },
+];
+const providers = [
+    {
+        name: "list_providers",
+        route: "GET /api/providers",
+        title: "List providers",
+        description: "Each provider 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.",
+    },
+    {
+        name: "list_system_voices",
+        route: "GET /api/providers/system-voice/voices",
+        title: "List the computer's voices",
+        description: "Voices of the computer's own speech program.",
+    },
+    {
+        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.",
+        unrecorded: true,
+        reachesOut: "asks",
+    },
+    {
+        name: "get_catalogue",
+        route: "GET /api/providers/catalogue",
+        title: "Read the model catalogue",
+        description: "When the model catalogue was updated and any warning.",
+    },
+    {
+        name: "check_catalogue",
+        route: "POST /api/providers/catalogue/check",
+        title: "Check the model catalogue",
+        description: "Checks the published model catalogue and merges what changed into models.yaml (Settings → Models, Check now).",
+        reachesOut: "asks",
+    },
+    {
+        name: "refresh_catalogue",
+        route: "POST /api/providers/catalogue/refresh",
+        title: "Refresh the model catalogue",
+        description: "Downloads the newest model catalogue.",
+        reachesOut: "asks",
+    },
+    {
+        name: "list_retired_models",
+        route: "GET /api/providers/catalogue/retired",
+        title: "List retired models in use",
+        description: "Templates, drafts and schedules that use a retired model.",
+    },
+    {
+        name: "switch_retired_model",
+        route: "POST /api/providers/catalogue/retired/switch",
+        title: "Switch a retired model",
+        description: formBody("Settings → Models' Switch"),
+    },
+    {
+        name: "switch_all_retired_models",
+        route: "POST /api/providers/catalogue/retired/switch-all",
+        title: "Switch every retired model",
+        description: "Switches every use of a retired model to its suggested replacement.",
+    },
+];
+export const setupTools = [...settings, ...providers];