@gentbajko/slopify 3.17.0 → 3.18.0

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];

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

@@ -0,0 +1,99 @@
+import { formBody } from "./route-tool.js";
+const storage = [
+    {
+        name: "get_files_folder",
+        route: "GET /api/storage/files",
+        title: "Read the files folder",
+        description: "Where projects, backups and exports are kept.",
+    },
+    {
+        name: "move_files_folder",
+        route: "POST /api/storage/files/move",
+        title: "Move the files folder",
+        description: "Body: {target: the new folder's full path; it must be empty or new}.",
+        confirm: "This moves every project and backup file to the new folder; Slopify refuses a folder that is not empty.",
+    },
+    {
+        name: "get_storage_usage",
+        route: "GET /api/storage",
+        title: "Read disk use",
+        description: "Settings → Backup & storage: disk used by projects (each with its outputs, working files and what can be freed), staged files and the trash.",
+    },
+    {
+        name: "list_trash",
+        route: "GET /api/trash",
+        title: "Read the trash",
+        description: "Deleted projects, prompts, intros and outros, templates and schedules, kept 30 days.",
+    },
+    {
+        name: "restore_from_trash",
+        route: "POST /api/trash/:kind/:id/restore",
+        title: "Restore from the trash",
+        description: "Puts the item back; a restored project picks up where it was.",
+    },
+    {
+        name: "restore_from_trash_many",
+        route: "POST /api/trash/bulk/restore",
+        title: "Restore several from the trash",
+        description: "Restore for the ticked rows. Body: {items: [{kind, id}]}.",
+    },
+    {
+        name: "delete_from_trash",
+        route: "DELETE /api/trash/:kind/:id",
+        title: "Delete for good",
+        description: "Deletes one trashed item for good, like Delete now in the trash.",
+        confirm: "The project and every file it produced are removed from disk (a deleted schedule keeps its run history on Schedules). Nothing removed here can be restored. This cannot be undone.",
+    },
+    {
+        name: "delete_from_trash_many",
+        route: "POST /api/trash/bulk/delete",
+        title: "Delete several for good",
+        description: "Delete now for the ticked rows. Body: {items: [{kind, id}]}.",
+        confirm: "The projects and every file they produced are removed from disk (deleted schedules keep their run history on Schedules). Nothing removed here can be restored. This cannot be undone.",
+    },
+];
+const onboarding = [
+    {
+        name: "get_onboarding",
+        route: "GET /api/onboarding",
+        title: "Read the welcome state",
+        description: "Starter packs and what the welcome offers.",
+    },
+    {
+        name: "install_starter_pack",
+        route: "POST /api/onboarding/packs/:id",
+        title: "Install a starter pack",
+        description: "Adds a starter pack's prompts and templates.",
+    },
+    {
+        name: "make_quick_short",
+        route: "POST /api/onboarding/short",
+        title: "Make a quick short",
+        description: `${formBody("the welcome's Make a short")} It starts a paid run.`,
+    },
+    {
+        name: "make_full_video_draft",
+        route: "POST /api/onboarding/full-video",
+        title: "Draft a full video",
+        description: formBody("the welcome's Make a full video"),
+    },
+    {
+        name: "get_samples",
+        route: "GET /api/onboarding/sample",
+        title: "Read the sample projects",
+        description: "Which bundled sample projects are in the projects list.",
+    },
+    {
+        name: "restore_samples",
+        route: "POST /api/onboarding/sample/restore",
+        title: "Restore the samples",
+        description: "Puts the bundled samples back as they shipped.",
+    },
+    {
+        name: "copy_sample",
+        route: "POST /api/onboarding/sample/copy",
+        title: "Copy a sample",
+        description: "Makes an editable copy of a sample, like Make my own copy.",
+    },
+];
+export const storageTools = [...storage, ...onboarding];

package/dist/edge/mcp/tools.js

@@ -0,0 +1,21 @@
+import { channelTools } from "./tools-channels.js";
+import { libraryTools } from "./tools-library.js";
+import { planningTools } from "./tools-planning.js";
+import { projectTools } from "./tools-projects.js";
+import { publishingTools } from "./tools-publishing.js";
+import { runTools } from "./tools-runs.js";
+import { scheduleTools } from "./tools-schedules.js";
+import { setupTools } from "./tools-setup.js";
+import { storageTools } from "./tools-storage.js";
+// Every API route an agent may call, as a tool; `excluded-routes.ts` names the rest and why.
+export const routeTools = [
+    ...projectTools,
+    ...publishingTools,
+    ...runTools,
+    ...planningTools,
+    ...scheduleTools,
+    ...channelTools,
+    ...libraryTools,
+    ...setupTools,
+    ...storageTools,
+];

package/dist/kernel/db/migrations/0055-external-reviews.sql

@@ -0,0 +1,56 @@
+-- A review an external agent answers through MCP: what the built-in reviewer would be shown,
+-- kept while it waits (picture files by their stored path, found again where they are when
+-- read); the agent's verdict, or its passing at the deadline. One row per review step
+-- fingerprint, like review_verdicts.
+CREATE TABLE external_reviews (
+ id TEXT PRIMARY KEY,
+ project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+ revision_id TEXT NOT NULL,
+ work_id TEXT NOT NULL,
+ piece_id TEXT NOT NULL,
+ work_key TEXT NOT NULL,
+ item_key TEXT NOT NULL,
+ stage TEXT NOT NULL CHECK(stage IN ('article','images','narration','thumbnail','shorts')),
+ item_fingerprint TEXT NOT NULL,
+ review_fingerprint TEXT NOT NULL,
+ material TEXT NOT NULL CHECK(json_valid(material)),
+ state TEXT NOT NULL CHECK(state IN ('waiting','answered','auto-passed','superseded')),
+ waiting_since TEXT NOT NULL,
+ deadline_at TEXT NOT NULL,
+ verdict TEXT CHECK(verdict IS NULL OR json_valid(verdict)),
+ answered_by TEXT CHECK(answered_by IN ('person','agent')),
+ answered_at TEXT,
+ UNIQUE(project_id,review_fingerprint)
+);
+CREATE INDEX external_reviews_waiting ON external_reviews(state, deadline_at);
+-- Verdicts say who gave them and who acted on them, and a review nobody answered in time is
+-- its own outcome. SQLite cannot change a CHECK in place, so the table is copied, as 0025 did.
+CREATE TABLE review_verdicts_agent_upgrade (
+ id TEXT PRIMARY KEY,
+ project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+ revision_id TEXT NOT NULL,
+ item_key TEXT NOT NULL,
+ stage TEXT NOT NULL CHECK(stage IN ('article','images','narration','thumbnail','shorts')),
+ item_fingerprint TEXT NOT NULL,
+ review_fingerprint TEXT NOT NULL,
+ passed INTEGER NOT NULL CHECK(passed IN (0,1)),
+ reasons TEXT NOT NULL,
+ outcome TEXT NOT NULL CHECK(outcome IN ('passed','flagged','redo','auto-passed')),
+ attempt INTEGER NOT NULL CHECK(attempt >= 1),
+ action TEXT CHECK(action IN ('overruled','redone')),
+ action_at TEXT,
+ action_by TEXT CHECK(action_by IN ('person','agent')),
+ redo_state TEXT CHECK(redo_state IN ('pending','started','failed')),
+ redo_error TEXT,
+ answered_by TEXT NOT NULL DEFAULT 'model' CHECK(answered_by IN ('model','agent','person','nobody')),
+ created_at TEXT NOT NULL,
+ UNIQUE(project_id,review_fingerprint)
+);
+INSERT INTO review_verdicts_agent_upgrade (id,project_id,revision_id,item_key,stage,item_fingerprint,review_fingerprint,passed,reasons,outcome,attempt,action,action_at,action_by,redo_state,redo_error,answered_by,created_at)
+  SELECT id,project_id,revision_id,item_key,stage,item_fingerprint,review_fingerprint,passed,reasons,outcome,attempt,action,action_at,
+    CASE WHEN action IS NULL THEN NULL ELSE 'person' END,redo_state,redo_error,'model',created_at
+  FROM review_verdicts ORDER BY rowid;
+DROP TABLE review_verdicts;
+ALTER TABLE review_verdicts_agent_upgrade RENAME TO review_verdicts;
+CREATE INDEX review_verdicts_item ON review_verdicts(project_id,item_key);
+CREATE INDEX review_verdicts_redo ON review_verdicts(redo_state);