@gentbajko/slopify 3.16.0 → 3.18.0

package/dist/edge/mcp/state-shapes.js

@@ -0,0 +1,60 @@
+import { z } from "zod";
+import { projectStates, stageKinds, stageStates } from "../../kernel/pipeline.js";
+import { progressOf } from "../../kernel/runner/graph.js";
+import { projectStateWord, stageStateWords } from "../../slices/admission/state-words.js";
+const flags = {
+    setAside: z.boolean().optional(),
+    prepared: z.boolean().optional(),
+    waitingForAgent: z.boolean().optional(),
+    stopped: z.boolean().optional(),
+    stepFailed: z.boolean().optional(),
+};
+const listSchema = z
+    .object({
+    projects: z.array(z.object({ status: z.enum(projectStates), progress: z.number(), ...flags }).loose()),
+})
+    .loose();
+const bodySchema = z
+    .object({
+    project: z.object({ status: z.enum(projectStates), ...flags }).loose(),
+    stages: z.array(z
+        .object({
+        kind: z.enum(stageKinds),
+        state: z.enum(stageStates),
+        progressCurrent: z.number().nullable().optional(),
+        progressTotal: z.number().nullable().optional(),
+    })
+        .loose()),
+})
+    .loose();
+// The Projects list with each project's state in the words Slopify's pages use.
+export function listWithStateWords(value) {
+    const parsed = listSchema.safeParse(value);
+    if (!parsed.success)
+        return value;
+    return {
+        ...parsed.data,
+        projects: parsed.data.projects.map((project) => ({
+            ...project,
+            stateWord: projectStateWord(project),
+        })),
+    };
+}
+// A project's page: the project's and each step's state in words.
+export function projectWithStateWords(value) {
+    const parsed = bodySchema.safeParse(value);
+    if (!parsed.success)
+        return value;
+    const { project, stages } = parsed.data;
+    const progress = progressOf(stages.map((stage) => ({
+        kind: stage.kind,
+        state: stage.state,
+        progressCurrent: stage.progressCurrent ?? null,
+        progressTotal: stage.progressTotal ?? null,
+    })));
+    return {
+        ...parsed.data,
+        project: { ...project, stateWord: projectStateWord({ ...project, progress }) },
+        stages: stages.map((stage) => ({ ...stage, stateWord: stageStateWords[stage.state] })),
+    };
+}

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

@@ -0,0 +1,153 @@
+import { formBody } from "./route-tool.js";
+export const channelTools = [
+    {
+        name: "list_channels",
+        route: "GET /api/channels",
+        title: "List channels",
+        description: "Channels with their brand kits.",
+    },
+    {
+        name: "create_channel",
+        route: "POST /api/channels",
+        title: "Create a channel",
+        description: formBody("New channel"),
+    },
+    {
+        name: "get_channel",
+        route: "GET /api/channels/:id",
+        title: "Read a channel",
+        description: "One channel with its cast in order, brand kit and settings.",
+    },
+    {
+        name: "update_channel",
+        route: "PUT /api/channels/:id",
+        title: "Save a channel",
+        description: formBody("the channel's tabs"),
+    },
+    {
+        name: "set_ai_disclosure",
+        route: "PUT /api/channels/:id/ai-disclosure",
+        title: "Set the AI disclosure",
+        description: formBody("the channel's AI disclosure"),
+    },
+    {
+        name: "delete_channel",
+        route: "DELETE /api/channels/:id",
+        title: "Delete a channel",
+        description: "Deletes the channel.",
+        confirm: "It is deleted permanently: channels do not go to Settings → Trash, so it cannot be restored. Its cast and their reference pictures, its episode summaries, its video memory and its brand settings go with it. Its projects move to the default channel and keep what they were made with.",
+    },
+    {
+        name: "add_cast_member",
+        route: "POST /api/channels/:id/cast",
+        title: "Add a cast member",
+        description: formBody("the Cast tab's Add"),
+    },
+    {
+        name: "move_cast_member",
+        route: "POST /api/channels/:id/cast/move",
+        title: "Move a cast member",
+        description: `Cast order, or moving a cast member to another channel, like the Cast tab's move. ${formBody("the Cast tab's move")}`,
+    },
+    {
+        name: "update_cast_member",
+        route: "PUT /api/channels/cast/:memberId",
+        title: "Save a cast member",
+        description: formBody("the cast editor"),
+    },
+    {
+        name: "delete_cast_member",
+        route: "DELETE /api/channels/cast/:memberId",
+        title: "Delete a cast member",
+        description: "Deletes the cast member.",
+        confirm: "It is deleted permanently: cast members do not go to Settings → Trash, so it cannot be restored. Its reference pictures go with it, and new videos stop using them. Videos already made keep the pictures they were started with.",
+    },
+    {
+        name: "upload_cast_picture",
+        route: "POST /api/channels/cast/:memberId/images",
+        title: "Upload a cast picture",
+        description: "Adds a picture of the cast member from an image file.",
+        upload: "raw",
+    },
+    {
+        name: "generate_cast_picture",
+        route: "POST /api/channels/cast/:memberId/generate",
+        title: "Generate a cast picture",
+        description: "Draws a cast picture with the image provider, a paid call, like Generate on the Cast tab.",
+    },
+    {
+        name: "delete_cast_picture",
+        route: "DELETE /api/channels/cast/:memberId/images/:imageId",
+        title: "Delete a cast picture",
+        description: "Removes one picture of the cast member.",
+    },
+    {
+        name: "get_cast_picture",
+        route: "GET /api/channels/pictures/:sha256",
+        title: "Read a cast picture",
+        description: "A cast or brand picture by its sha256, as an image.",
+    },
+    {
+        name: "set_channel_template",
+        route: "PUT /api/channels/templates/:templateId",
+        title: "Set a template's channel",
+        description: formBody("the template's channel choice"),
+    },
+    {
+        name: "list_episode_memories",
+        route: "GET /api/channels/:id/episodes",
+        title: "Read episode memory",
+        description: "The channel's summaries of finished episodes that later scripts may refer to.",
+    },
+    {
+        name: "set_episode_memory",
+        route: "PUT /api/channels/:id/episodes/setting",
+        title: "Set episode memory",
+        description: formBody("the channel's episode memory switch"),
+    },
+    {
+        name: "update_episode_memory",
+        route: "PUT /api/channels/:id/episodes/:memoryId",
+        title: "Edit an episode summary",
+        description: formBody("the episode summary editor"),
+    },
+    {
+        name: "delete_episode_memory",
+        route: "DELETE /api/channels/:id/episodes/:memoryId",
+        title: "Delete an episode summary",
+        description: "Deletes one summary.",
+        confirm: "It is deleted permanently: episode summaries do not go to Settings → Trash, so it cannot be restored. New episodes stop being reminded of it. The video itself is not changed.",
+    },
+    {
+        name: "list_channel_videos",
+        route: "GET /api/channels/:id/videos",
+        title: "Read existing videos",
+        description: "The channel's existing video titles imported from YouTube Studio.",
+    },
+    {
+        name: "preview_channel_videos",
+        route: "POST /api/channels/:id/videos/preview",
+        title: "Preview an existing-videos import",
+        description: formBody("the Existing videos import"),
+        unrecorded: true,
+    },
+    {
+        name: "import_channel_videos",
+        route: "POST /api/channels/:id/videos",
+        title: "Import existing videos",
+        description: formBody("the Existing videos import"),
+    },
+    {
+        name: "remove_channel_videos",
+        route: "DELETE /api/channels/:id/videos",
+        title: "Remove every existing video",
+        description: "Removes every imported title.",
+        confirm: "This removes every imported video title of the channel.",
+    },
+    {
+        name: "remove_channel_video",
+        route: "DELETE /api/channels/:id/videos/:videoId",
+        title: "Remove an existing video",
+        description: "Removes one imported title.",
+    },
+];

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

@@ -0,0 +1,151 @@
+import { formBody } from "./route-tool.js";
+export const libraryTools = [
+    {
+        name: "list_prompts",
+        route: "GET /api/prompts",
+        title: "List prompts",
+        description: "Library prompts of every kind.",
+    },
+    {
+        name: "create_prompt",
+        route: "POST /api/prompts",
+        title: "Create a prompt",
+        description: "Body: {kind: article | image | thumbnail | narration | description | shorts | review | script, name, body}.",
+    },
+    {
+        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.",
+    },
+    {
+        name: "set_prompt_photorealistic",
+        route: "PUT /api/prompts/:id/photorealistic",
+        title: "Mark a prompt photorealistic",
+        description: "Body: {photorealistic: true | false}.",
+    },
+    {
+        name: "prompt_history",
+        route: "GET /api/prompts/:id/history",
+        title: "Read a prompt's history",
+        description: "Every saved version of the prompt.",
+    },
+    {
+        name: "restore_prompt_version",
+        route: "POST /api/prompts/:id/history/:version/restore",
+        title: "Restore a prompt version",
+        description: "Makes an earlier version the prompt's text again, as a new version.",
+    },
+    {
+        name: "prompt_used_by",
+        route: "GET /api/prompts/:id/used-by",
+        title: "Where a prompt is used",
+        description: "Templates, drafts and schedules that use the prompt.",
+    },
+    {
+        name: "delete_prompt",
+        route: "DELETE /api/prompts/:id",
+        title: "Delete a prompt",
+        description: "Moves the prompt to the trash.",
+        confirm: "Moves it to the trash for 30 days (Settings → Trash). Projects that used it keep their text.",
+    },
+    {
+        name: "list_entries",
+        route: "GET /api/entries",
+        title: "List intros and outros",
+        description: "Library intros and outros.",
+    },
+    {
+        name: "create_entry",
+        route: "POST /api/entries",
+        title: "Create an intro or outro",
+        description: "Body: {category: intro | outro, mode: text | llm, name, body}.",
+    },
+    {
+        name: "update_entry",
+        route: "PUT /api/entries/:id",
+        title: "Save an intro or outro",
+        description: "Body: {category, mode, name, body}. Saving adds a history version.",
+    },
+    {
+        name: "entry_history",
+        route: "GET /api/entries/:id/history",
+        title: "Read an entry's history",
+        description: "Every saved version of the intro or outro.",
+    },
+    {
+        name: "restore_entry_version",
+        route: "POST /api/entries/:id/history/:version/restore",
+        title: "Restore an entry version",
+        description: "Makes an earlier version current again, as a new version.",
+    },
+    {
+        name: "entry_used_by",
+        route: "GET /api/entries/:id/used-by",
+        title: "Where an entry is used",
+        description: "Templates and drafts that use the intro or outro.",
+    },
+    {
+        name: "delete_entry",
+        route: "DELETE /api/entries/:id",
+        title: "Delete an intro or outro",
+        description: "Moves it to the trash.",
+        confirm: "Moves it to the trash for 30 days (Settings → Trash). Projects that used it keep their text.",
+    },
+    {
+        name: "list_document_themes",
+        route: "GET /api/document-themes",
+        title: "List PDF themes",
+        description: "The built-in PDF themes and the ones saved in the Library.",
+    },
+    {
+        name: "create_document_theme",
+        route: "POST /api/document-themes",
+        title: "Create a PDF theme",
+        description: formBody("the PDF theme editor"),
+    },
+    {
+        name: "update_document_theme",
+        route: "PUT /api/document-themes/:id",
+        title: "Save a PDF theme",
+        description: formBody("the PDF theme editor"),
+    },
+    {
+        name: "delete_document_theme",
+        route: "DELETE /api/document-themes/:id",
+        title: "Delete a PDF theme",
+        description: "Deletes the theme.",
+        confirm: "It is deleted permanently: PDF themes do not go to Settings → Trash, so it cannot be restored. Projects that used it keep their own copy of the settings.",
+    },
+    {
+        name: "list_fonts",
+        route: "GET /api/fonts",
+        title: "List fonts",
+        description: "Caption and document fonts, bundled and uploaded.",
+    },
+    {
+        name: "upload_font",
+        route: "POST /api/fonts",
+        title: "Upload a font",
+        description: "Adds a TTF or OTF font file.",
+        upload: "multipart",
+    },
+    {
+        name: "get_shared_glossary",
+        route: "GET /api/pronunciations/shared",
+        title: "Read the shared glossary",
+        description: "The pronunciation glossary shared by every project.",
+    },
+    {
+        name: "get_narration_aliases",
+        route: "GET /api/pronunciations/aliases",
+        title: "Read narration aliases",
+        description: "Library → Narration aliases: words the narration says differently from how they are written.",
+    },
+    {
+        name: "set_narration_aliases",
+        route: "PUT /api/pronunciations/aliases",
+        title: "Save narration aliases",
+        description: "Saves the whole ordered list, like Save aliases. Body: {aliases: [{written, spoken, wholeWord, caseSensitive}]}.",
+    },
+];

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

@@ -0,0 +1,137 @@
+import { formBody } from "./route-tool.js";
+const drafts = [
+    {
+        name: "list_drafts",
+        route: "GET /api/drafts",
+        title: "List Play drafts",
+        description: "Play drafts: saved setups for Create, not started yet.",
+    },
+    {
+        name: "create_draft",
+        route: "POST /api/drafts",
+        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.",
+    },
+    {
+        name: "get_draft",
+        route: "GET /api/drafts/:id",
+        title: "Read a Play draft",
+        description: "A Play draft: its document, version, attachments, latest review and start.",
+    },
+    {
+        name: "save_draft",
+        route: "PUT /api/drafts/:id",
+        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",
+        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",
+        title: "Discard a Play draft",
+        description: "Body: {baseVersion}.",
+        confirm: "This discards the draft and its uploaded files for good.",
+    },
+    {
+        name: "review_draft",
+        route: "POST /api/drafts/:id/review",
+        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,
+    },
+    {
+        name: "start_draft",
+        route: "POST /api/drafts/:id/start",
+        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}.",
+    },
+    {
+        name: "upload_draft_attachment",
+        route: "PUT /api/drafts/:id/attachments/:attachmentId/file",
+        title: "Upload a draft's file",
+        description: "Uploads a draft's file (audio, images, thumbnail or establishing image) under the attachment id its document names.",
+        upload: "multipart",
+    },
+    {
+        name: "get_draft_attachment",
+        route: "GET /api/drafts/:id/attachments/:attachmentId/file",
+        title: "Read a draft's picture",
+        description: "A draft's uploaded picture, as an image.",
+    },
+    {
+        name: "list_staged_files",
+        route: "GET /api/staging",
+        title: "List uploaded files",
+        description: "Files uploaded for edits and not used yet.",
+    },
+    {
+        name: "upload_staged_file",
+        route: "POST /api/staging/:kind",
+        title: "Upload a file for an edit",
+        description: "Uploads a file an edit uses (kind: the stage it is for); save_revision's edit.uploads names it by the id this returns.",
+        upload: "multipart",
+    },
+    {
+        name: "delete_staged_file",
+        route: "DELETE /api/staging/:id",
+        title: "Remove an uploaded file",
+        description: "Removes an uploaded file no edit used.",
+    },
+];
+const templates = [
+    {
+        name: "list_templates",
+        route: "GET /api/project-templates",
+        title: "List templates",
+        description: "Project templates with their versions.",
+    },
+    {
+        name: "create_template",
+        route: "POST /api/project-templates",
+        title: "Create a template",
+        description: formBody("the template editor"),
+    },
+    {
+        name: "template_from_project",
+        route: "POST /api/project-templates/from-project/:projectId",
+        title: "Save a project as a template",
+        description: formBody("Save as template on the project page"),
+    },
+    {
+        name: "next_chapter_template",
+        route: "POST /api/project-templates/next-chapter/:projectId",
+        title: "Template for the next chapter",
+        description: formBody("Next chapter on the project page"),
+    },
+    {
+        name: "get_template",
+        route: "GET /api/project-templates/:id",
+        title: "Read a template",
+        description: "One template with its current version and history.",
+    },
+    {
+        name: "update_template",
+        route: "PUT /api/project-templates/:id",
+        title: "Save a template",
+        description: `${formBody("the template editor")} Saving adds a version.`,
+    },
+    {
+        name: "delete_template",
+        route: "DELETE /api/project-templates/:id",
+        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.",
+    },
+    {
+        name: "instantiate_template",
+        route: "POST /api/project-templates/:id/instantiate",
+        title: "Use a template",
+        description: "Opens a new Play draft from the template, like Use template.",
+    },
+];
+export const planningTools = [...drafts, ...templates];

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

@@ -0,0 +1,167 @@
+import { z } from "zod";
+import { oldVersionsConsequence } from "../../slices/storage/consequences.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.
+const historySchema = z.object({ historyFiles: z.number(), historyBytes: z.number() });
+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.",
+        shape: listWithStateWords,
+    },
+    {
+        name: "get_project",
+        route: "GET /api/projects/:id",
+        title: "Read a project",
+        description: "One project as its page shows it: revisionId (the baseRevisionId every change needs), resumable, holding (the checkpoints holding the run now, each waiting for the person or, a schedule's own Before Video hold, for its day), the project with its stateWord, each step with its state, stateWord (Not started, Running, Done, Provided, Failed, Canceled, Off), failure reason and ETA, and its current output files.",
+        shape: projectWithStateWords,
+    },
+    {
+        name: "trash_project",
+        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.",
+    },
+    {
+        name: "move_projects_to_channel",
+        route: "POST /api/projects/move-channel",
+        title: "Move to a channel",
+        description: "Move to a channel, for one project or many at once, like Move on the Projects list. Body: {projectIds: [project ids], channelId}.",
+    },
+    {
+        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.",
+    },
+    {
+        name: "move_in_run_queue",
+        route: "POST /api/projects/queue/:projectId/move",
+        title: "Move in the run queue",
+        description: "Moves a queued project one place earlier or later. Body: {by: -1 | 1}.",
+    },
+    {
+        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.",
+        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.",
+    },
+    {
+        name: "get_week",
+        route: "GET /api/home/week",
+        title: "Read this week",
+        description: "Home's This week: videos made, calls, cost and CLI plan standings. Query: {since: an ISO time, channelId?}.",
+    },
+    {
+        name: "mark_uploaded",
+        route: "PUT /api/projects/:id/uploaded",
+        title: "Mark uploaded",
+        description: "Mark uploaded (or its Undo), like Home → Ready to upload: records that the person uploaded the video. Call it once per project to mark several. Slopify never uploads. Body: {uploaded: true | false}.",
+    },
+    {
+        name: "keep_as_is",
+        route: "PUT /api/projects/:id/set-aside",
+        title: "Keep as is",
+        description: "Keep as is on Home's Needs you: a run waiting only on held work leaves the list without running anything, until the project's next edit. Body: {setAside: true}, or {setAside: false} for its Undo.",
+    },
+    {
+        name: "get_project_storage",
+        route: "GET /api/storage/projects/:id",
+        title: "Read a project's disk use",
+        description: "How much disk the project's outputs, working files and old versions (History) use, and what Keep outputs only or Delete old versions would free.",
+    },
+    {
+        name: "keep_project_outputs",
+        route: "POST /api/storage/projects/:id/keep-outputs",
+        title: "Keep outputs only",
+        description: "Frees a finished project's working files and keeps its outputs, like Free space on the project page.",
+        confirm: "This removes the working files the project was made from (images, narration parts, subtitle timing, render settings) and keeps the video, shorts, thumbnail, article, description and document. Changing the project later makes those files again first, which takes time and uses provider credits.",
+    },
+    {
+        name: "delete_old_versions",
+        route: "POST /api/storage/projects/:id/old-versions/delete",
+        title: "Delete old versions",
+        description: "Delete old versions for this one project; answers how many files were deleted and the bytes freed. Delete all old versions and Clean up everything (every project) are the person's, in Settings → Backup & storage.",
+        confirm: `${oldVersionsConsequence(undefined, "project")} get_project_storage says how many files and how much space first.`,
+        confirmFrom: {
+            route: "/api/storage/projects/:id",
+            text: (value) => {
+                const storage = historySchema.safeParse(value);
+                return storage.success
+                    ? oldVersionsConsequence({ files: storage.data.historyFiles, bytes: storage.data.historyBytes }, "project")
+                    : undefined;
+            },
+        },
+    },
+];
+const outputs = [
+    {
+        name: "preview_added_output",
+        route: "POST /api/projects/:id/outputs/preview",
+        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,
+    },
+    {
+        name: "add_output",
+        route: "POST /api/projects/:id/outputs",
+        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}.',
+    },
+];
+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.",
+    },
+    {
+        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}.",
+    },
+    {
+        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"]}.',
+    },
+    {
+        name: "list_reviews",
+        route: "GET /api/projects/:id/reviews",
+        title: "Read review verdicts",
+        description: "Each reviewed item's latest verdict: passed, reasons, outcome, attempt, action and redo state, and whether it is about the output shown now (current).",
+    },
+    {
+        name: "overrule_review",
+        route: "POST /api/projects/:id/reviews/:verdictId/overrule",
+        title: "Overrule a verdict",
+        description: "Keeps a flagged item as it is, like Overrule; it also calls off a redo still waiting to start.",
+    },
+    {
+        name: "redo_review",
+        route: "POST /api/projects/:id/reviews/:verdictId/redo",
+        title: "Redo a flagged item",
+        description: `Makes a flagged item again, like Redo beside it. ${control}`,
+    },
+    {
+        name: "submit_review_verdict",
+        route: "POST /api/projects/:id/external-reviews/:reviewId/verdict",
+        title: "Answer an external review",
+        description: 'Your verdict on a review waiting for an agent (read it first with get_external_review). Body: {verdict: "pass" | "fail", reasons: [one short sentence per problem]}: a fail needs at least one reason, at most 10, each 1 to 500 characters. The first verdict saved is kept.',
+    },
+];
+export const projectTools = [...projects, ...outputs, ...decisions];