davinci-resolve-mcp 2.104.9 → 2.105.0

package/CHANGELOG.md

@@ -2,6 +2,84 @@
 
 Release history for the DaVinci Resolve MCP Server. The latest release is summarized in the root README; older entries live here to keep the README focused.
 
+## What's New in v2.105.0
+
+**Native-schema DRT authoring — the parked "project, not a lap" — shipped.**
+Tool-authored .drt files that Resolve's ImportTimelineFromFile actually
+accepts, live-verified end to end on Studio 19.1.3.7.
+
+The door was already half-open: the repo's template-splice engine
+(assembleTimeline + the real Resolve-21 empty-project capture) authors
+native-schema .drp archives, and the final bisection showed a .drt IS a .drp
+that ImportTimelineFromFile accepts. What stood between them was the version
+gate (the template stamps DbPrjVer 17; a 19.1.3 host wants 14) and a set of
+extraction traps nobody had mapped.
+
+### Added
+
+- **`drt.assemble`** — spec → importable native-schema .drt (titles,
+  generators, transitions), with `targetAppVersion` stamping for pre-21
+  hosts. Live-verified: assembled archives import with every element intact.
+- **`drt.extract_from_drp` rebuilt on the measured recipe**: keep
+  project.xml + MediaPool + the SeqContainer at its ORIGINAL uuid path, drop
+  Gallery, and remove other timelines' Sm2MpTimelineClip blocks (matched via
+  the kept container's track Sequence DbIds) so they don't arrive as ghost
+  empty timelines. The Python extractor behind `timeline.import_from_drp`
+  implements the same recipe. Live-verified: single-timeline extracts from a
+  two-timeline project import cleanly, one timeline, clips intact.
+
+### The .drt import contract, fully mapped (api_truth rewritten)
+
+A whole saved-project export renamed .drt imports, clips intact.
+Requirements: project.xml; MpFolder.xml (it holds the Sm2Sequence/Sm2Timeline
+objects); the SeqContainer's ORIGINAL uuid path — renaming it "succeeds"
+with an EMPTY timeline, no error, the nastiest variant; version stamps at or
+below the host; native blob schema; and a SAVED source project —
+ExportProject snapshots the saved DB state, so an unsaved timeline exports
+empty tracks (the trap that produced v2.104.7's "necessary but not
+sufficient" verdict, now corrected). Every Sm2MpTimelineClip block imports
+as a timeline; extras arrive as ghosts unless removed.
+
+### Fixed in passing
+
+- **project_db lookups can no longer hang on an unresponsive library root.**
+  Mid-session, macOS rendered the Lite sandbox container path unresponsive at
+  the filesystem level (`ls` itself hung) — which froze the Node test suite
+  and would have frozen every projectName lookup. Roots are now probed with a
+  deadline (`responsiveRoots`); unresponsive ones are skipped and NAMED in
+  the not-found error. The root-walking tests are hermetic now — suites must
+  not depend on machine paths that an OS can wedge.
+- The flat-authored-shape refusal in import_timeline_checked now points at
+  `drt.assemble` as the importable authoring route.
+
+## What's New in v2.104.10
+
+Stones turned on the live-validation backlog, on Studio 19.1.3.7.
+
+**AAF live import, validated at last** (marked "NOT live-validated" since
+2026-07-06): an EXPORT_AAF/EXPORT_AAF_NEW round trip imports cleanly with
+importSourceClips=false, lands fully offline (the documented turnover shape),
+and preserves the start timecode. The naming matrix across import formats is
+now complete and in api_truth — FCP7 XML ignores timelineName (internal name
+wins, the #171 trap); AAF honours timelineName when given, else its internal
+name; OTIO honours timelineName; .drt names the timeline after the file. Only
+FCP7 exhibits the returned-existing trap. The AAF post-import relink leg was
+exercised too: under importSourceClips=false it correctly reports "no Media
+Pool Items to relink" — the API relinks pool items, and none exist on that
+path — so its precondition is now stated instead of assumed.
+
+**safe_quick_export verifies its output.** RenderWithQuickExport's status
+dict was the last render surface trusted without a file check: a success
+status that wrote nothing read as an export. The files that actually landed
+in TargetDir are now listed with size and ffprobe duration, and a success
+status with no new file flips to an error.
+
+**Housekeeping:** the delete-locked scratch project from the v2.104.7 session
+is gone — the pre-restart DeleteProject had returned False while actually
+succeeding, the documented DeleteProject lie caught in the wild. A clean
+Resolve quit/relaunch verified the wedge entry's other half: Quit() works
+when no orphaned render holds the pipeline.
+
 ## What's New in v2.104.9
 
 **The NTSC coverage gap, closed.** The conform fixtures were integer-rate

package/README.md

@@ -2,7 +2,7 @@
 
 English | [简体中文](README.zh-CN.md)
 
-[![Version](https://img.shields.io/badge/version-2.104.9-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.105.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
 [![npm](https://img.shields.io/npm/v/davinci-resolve-mcp.svg?label=npm&color=CB3837)](https://www.npmjs.com/package/davinci-resolve-mcp)
 [![API Coverage](https://img.shields.io/badge/API%20Coverage-100%25-brightgreen.svg)](docs/reference/api-coverage.md)
 [![Tools](https://img.shields.io/badge/MCP%20Tools-36%20(353%20full)-blue.svg)](#server-modes)

package/README.zh-CN.md

@@ -2,7 +2,7 @@
 
 [English](README.md) | 简体中文
 
-[![Version](https://img.shields.io/badge/version-2.104.9-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.105.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
 [![npm](https://img.shields.io/npm/v/davinci-resolve-mcp.svg?label=npm&color=CB3837)](https://www.npmjs.com/package/davinci-resolve-mcp)
 [![API Coverage](https://img.shields.io/badge/API%20Coverage-100%25-brightgreen.svg)](docs/reference/api-coverage.md)
 [![Tools](https://img.shields.io/badge/MCP%20Tools-36%20(353%20full)-blue.svg)](#服务器模式)
@@ -12,7 +12,7 @@
 [![Python](https://img.shields.io/badge/python-3.10+-green.svg)](https://www.python.org/downloads/)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
-> 本翻译对应 v2.104.9 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
+> 本翻译对应 v2.105.0 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
 
 一个 Model Context Protocol (MCP) 服务器，让 AI 助手通过官方脚本 API 控制 DaVinci Resolve Studio（达芬奇）。它提供完整的 API 覆盖，外加带护栏的工作流助手，涵盖剪辑、媒体池整理、渲染设置、审阅标记、调色、Fusion、Fairlight、项目生命周期任务、扩展开发，以及不碰源媒体的媒体分析。
 

package/docs/reference/api-limitations.md

@@ -521,7 +521,7 @@ values, or automation-hostile modal prompts.
 
 - **Object:** `MediaPool`
 - **Signature:** `(filePath, {timelineName, importSourceClips, ...}) -> Timeline`
-- **Behavior:** For FCP7 XML, the sequence name INSIDE the file wins over the timelineName import option. When the internal name matches an existing timeline, the call returns that EXISTING timeline — no error, no new timeline — so an export→edit→re-import loop keying uniqueness on the option 'succeeds' while operating on one timeline forever (issue #171, Studio 21.0.4.5; wrapper behavior verified on 19.1.3.7). Distinct from the documented repeated-timelineName None return: here the option is fresh and the file's name is stale.
+- **Behavior:** For FCP7 XML, the sequence name INSIDE the file wins over the timelineName import option. When the internal name matches an existing timeline, the call returns that EXISTING timeline — no error, no new timeline — so an export→edit→re-import loop keying uniqueness on the option 'succeeds' while operating on one timeline forever (issue #171, Studio 21.0.4.5; wrapper behavior verified on 19.1.3.7). Distinct from the documented repeated-timelineName None return: here the option is fresh and the file's name is stale. THE NAMING AUTHORITY DIFFERS PER FORMAT (all measured on 19.1.3.7): FCP7 XML ignores timelineName entirely (internal <name> wins); AAF honours timelineName when given and falls back to its internal name; OTIO honours timelineName; and .drt names the timeline after the FILE (see the .drt entry below). Only FCP7 exhibits the returned-existing trap.
 - **Workaround / current handling:** Rewrite the <sequence><name> inside the file to the intended name before importing — timeline.import_timeline_checked does this automatically for FCP7 XML and errors when a non-rewritable format still returns an existing timeline. Never treat a truthy return as proof of creation; check the returned timeline's id against the pre-import set.
 - **Reference:** [issue #171](https://github.com/samuelgursky/davinci-resolve-mcp/issues/171)
 - **Tags:** timeline, import, silent-failure, unreliable-return
@@ -530,8 +530,8 @@ values, or automation-hostile modal prompts.
 
 - **Object:** `MediaPool`
 - **Signature:** `(drtPath, {importSourceClips, ...}) -> Timeline`
-- **Behavior:** Measured by bisection on Studio 19.1.3.7 against a real .drt export: (1) the archive MUST contain project.xml — the same archive minus only that entry is refused, while removing MediaPool/MpFolder.xml or renaming the SeqContainer path changes nothing; (2) the container XML must be Resolve's native blob-based schema — a syntactic SeqContainer with flat template elements is refused even beside a genuine project.xml; (3) the imported timeline is named after the FILE (real_2997.drt -> 'real_2997'), not the container's internal name — a third naming authority beside FCP7 (internal name wins) and OTIO (timelineName option wins); and (4) a refused import can raise a modal error dialog that BLOCKS the scripting call until a human dismisses it — the call neither returns nor times out.
-- **Workaround / current handling:** Import only .drt files Resolve itself exported — the sufficient set is unmapped beyond that: even a .drp-sourced native container repacked WITH its project.xml was refused (measured 19.1.3.7), so extraction-based .drt import cannot be relied on either. Name the timeline by naming the FILE. Never batch speculative .drt imports unattended — one refusal can hold the whole session hostage behind its dialog. timeline.import_timeline_checked detects the authored template shape up front and refuses with this diagnosis instead of importing; for a reliable programmatic import use OTIO or FCP7 XML.
+- **Behavior:** Fully mapped by bisection on Studio 19.1.3.7: a .drt IS a .drp that ImportTimelineFromFile accepts — a whole saved-project export renamed .drt imports, clips intact. Requirements: (1) project.xml present; (2) MediaPool/MpFolder.xml present — it holds the Sm2Sequence/Sm2Timeline objects; (3) the SeqContainer keeps its ORIGINAL uuid path — renaming it 'succeeds' with an EMPTY timeline (items=0, no error), the nastiest variant; (4) version stamps at or below the host's ProjectVersion; (5) native blob schema — flat template containers are refused; (6) the source must be a SAVED export (ExportProject snapshots the saved DB state, so an unsaved timeline exports EMPTY tracks). Every Sm2MpTimelineClip block in MpFolder imports as a timeline: extra blocks arrive as ghost empty timelines unless removed (match blocks via the kept container's track <Sequence> DbIds). The imported timeline is named after the FILE, and a refused import can raise a modal dialog that BLOCKS the scripting call until a human dismisses it.
+- **Workaround / current handling:** Follow the recipe: drt.extract_from_drp implements it (original container path, MpFolder carried, ghost blocks removed, Gallery dropped), and drt.assemble authors importable native-schema archives from scratch (template-spliced; pass targetAppVersion on pre-21 hosts). Save the project before ExportProject. Name the timeline by naming the FILE. Never batch speculative .drt imports unattended — one refusal can hold the session hostage behind its dialog; timeline.import_timeline_checked refuses the flat authored shape up front for exactly that reason.
 - **Tags:** timeline, import, silent-failure, headless
 
 ### Timeline.DeleteClips (requires the Edit page; flaky first attempt)

package/install.py

@@ -37,7 +37,7 @@ from src.utils.update_check import (
 
 # ─── Version ──────────────────────────────────────────────────────────────────
 
-VERSION = "2.104.9"
+VERSION = "2.105.0"
 # Only hard floor: mcp[cli] requires Python 3.10+. There is no upper bound —
 # Resolve's scripting bridge loads into newer interpreters on recent builds
 # (Python 3.14 verified against Resolve Studio 20.3.2). Older Resolve builds

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "davinci-resolve-mcp",
-  "version": "2.104.9",
+  "version": "2.105.0",
   "description": "NPM bootstrapper for the DaVinci Resolve MCP Server.",
   "license": "MIT",
   "author": "Samuel Gursky <samgursky@gmail.com>",

package/resolve-advanced/server/db-patch.mjs

@@ -52,6 +52,44 @@ export const LITE_DB_ROOT = path.join(
 /** Every root searched when resolving a project by name, Studio first. */
 export const DB_ROOTS = [DISK_DB_ROOT, PROJECT_LIBRARY_ROOT, LITE_DB_ROOT];
 
+/**
+ * Filter roots to the ones that answer a readdir within `deadlineMs`.
+ *
+ * macOS can render a path UNRESPONSIVE at the filesystem level — measured
+ * live 2026-08-30: `ls` on the Lite sandbox container hung indefinitely
+ * (File-Provider/container materialization), which made every projectName
+ * lookup and the test suite hang with it. A hung readdir cannot be
+ * cancelled; the race abandons it (one leaked threadpool op) and reports the
+ * root as skipped so the caller can say WHERE it could not look.
+ * Returns { roots, skipped: [{root, reason}] }.
+ */
+export async function responsiveRoots(roots = DB_ROOTS, deadlineMs = 3000) {
+  const fsp = require('node:fs/promises');
+  const results = await Promise.all(
+    roots.map(async (root) => {
+      try {
+        const answer = fsp
+          .readdir(root)
+          .then(() => 'ok', (err) => (err && err.code === 'ENOENT' ? 'absent' : 'error'));
+        const timer = new Promise((resolve) => {
+          const t = setTimeout(() => resolve('timeout'), deadlineMs);
+          if (t.unref) t.unref();
+        });
+        const outcome = await Promise.race([answer, timer]);
+        return { root, outcome };
+      } catch {
+        return { root, outcome: 'error' };
+      }
+    }),
+  );
+  return {
+    roots: results.filter((r) => r.outcome === 'ok' || r.outcome === 'absent').map((r) => r.root),
+    skipped: results
+      .filter((r) => r.outcome === 'timeout')
+      .map((r) => ({ root: r.root, reason: `unresponsive after ${deadlineMs}ms (hung filesystem path — skipped)` })),
+  };
+}
+
 export function loadSqlite() {
   try {
     return require('better-sqlite3');
@@ -85,17 +123,22 @@ export function findProjectDb(projectName, root = DISK_DB_ROOT) {
   return hits;
 }
 
-export function resolveDbPath({ projectDb, projectName }) {
+export function resolveDbPath({ projectDb, projectName, roots, skippedRoots = [] }) {
   if (projectDb) return projectDb;
   if (!projectName) throw new Error('provide projectDb (path) or projectName');
+  const searchRoots = roots || DB_ROOTS;
   // Deduplicate: a project present under both roots must not read as ambiguous
   // just because the same file was found twice.
-  const hits = [...new Set(DB_ROOTS.flatMap((root) => findProjectDb(projectName, root)))];
+  const hits = [...new Set(searchRoots.flatMap((root) => findProjectDb(projectName, root)))];
   if (!hits.length) {
     throw new Error(
-      `no Project.db found for project "${projectName}". Searched the Studio libraries ` +
-      `(${DISK_DB_ROOT} and ${PROJECT_LIBRARY_ROOT}) and the sandboxed free-edition ` +
-      `library (${LITE_DB_ROOT}). ` +
+      `no Project.db found for project "${projectName}". Searched: ` +
+      `${searchRoots.join(', ')}. ` +
+      (skippedRoots.length
+        ? `SKIPPED unresponsive root(s): ${skippedRoots.map((r) => r.root).join(', ')} — ` +
+          'a hung filesystem path (File Provider / sandbox container); its projects ' +
+          'are invisible until macOS unwedges it. '
+        : '') +
       'If Resolve keeps its projects elsewhere — a relocated library, a network/Postgres ' +
       'database, or the free edition on Windows/Linux — pass projectDb with the full path.',
     );

package/resolve-advanced/server/tools/drt.mjs

@@ -19,7 +19,7 @@
 import fs from 'node:fs/promises';
 import { z } from 'zod';
 import JSZip from 'jszip';
-import { drt } from '../libs.mjs';
+import { drt, drp } from '../libs.mjs';
 import { summarizeDrtTimelines } from '../sequences.mjs';
 
 const parseSchema = z.object({ drtPath: z.string().describe('Absolute path to a .drt (or .drp) file') });
@@ -29,6 +29,48 @@ const authorSchema = z.object({
   outputPath: z.string().describe('Absolute path where the .drt will be written'),
 });
 const validateSchema = z.object({ drtPath: z.string().describe('Absolute path to a .drt file') });
+const assembleSchema = z.object({
+  spec: z
+    .object({})
+    .passthrough()
+    .describe("assembleTimeline spec: { timelineName?, elements: [{type:'title'|'generator', track, startFrame, durationFrames?, text?, ...}], transitions? }. startFrame is timeline-absolute (origin 86400)."),
+  outputPath: z.string().describe('Absolute path where the importable .drt will be written'),
+  targetAppVersion: z
+    .union([z.string(), z.number()])
+    .optional()
+    .describe("Resolve version that must import it, e.g. '19.1' — stamps ProjectVersion down from the template's Resolve-21 capture. Omit for 21+ hosts."),
+});
+
+/** Rewrite version stamps across every XML entry of a JSZip; returns patch counts. */
+async function applyVersionStamps(zip, targetPV, appVer) {
+  const out = new JSZip();
+  let elementPatches = 0;
+  let stampPatches = 0;
+  const jobs = [];
+  zip.forEach((path, e) => {
+    if (e.dir) return;
+    jobs.push(
+      (async () => {
+        if (!path.endsWith('.xml')) {
+          out.file(path, await e.async('nodebuffer'));
+          return;
+        }
+        let xml = await e.async('string');
+        xml = xml.replace(/<ProjectVersion>\d+<\/ProjectVersion>/g, () => {
+          elementPatches += 1;
+          return `<ProjectVersion>${targetPV}</ProjectVersion>`;
+        });
+        xml = xml.replace(/DbAppVer="[^"]*" DbPrjVer="[^"]*"/g, () => {
+          stampPatches += 1;
+          return `DbAppVer="${appVer}" DbPrjVer="${targetPV}"`;
+        });
+        out.file(path, xml);
+      })(),
+    );
+  });
+  await Promise.all(jobs);
+  return { out, elementPatches, stampPatches };
+}
 const injectIntoDrpSchema = z.object({
   drtPath: z.string().describe('Source .drt'),
   drpPath: z.string().describe('Target.drp to inject into'),
@@ -93,7 +135,7 @@ function requirePathArg(args, key, action) {
 export const drtTool = {
   name: 'drt',
   description:
-    'DaVinci Resolve Timeline (.drt) operations — offline, no Resolve required. Actions: parse, list_sequences (enumerate the timelines inside a .drp/.drt → [{id,name,eventCount,index}] to drive a "which sequence?" picker), author, validate, inject_into_drp, extract_from_drp (pull one SeqContainer out as a .drt — feed the .drt to the Python davinci-resolve MCP timeline.import_timeline_checked, or use timeline.import_from_drp to do both), downgrade (stamp <ProjectVersion> down so an OLDER Resolve will import a .drt/.drp from a newer one — pass targetAppVersion like "19.1.3" or targetProjectVersion).',
+    'DaVinci Resolve Timeline (.drt) operations — offline, no Resolve required. Actions: assemble (spec → IMPORTABLE native-schema .drt via template-spliced real structures; pass targetAppVersion e.g. \'19.1\' for pre-21 hosts), parse, list_sequences (enumerate the timelines inside a .drp/.drt → [{id,name,eventCount,index}] to drive a "which sequence?" picker), author, validate, inject_into_drp, extract_from_drp (pull one SeqContainer out as a .drt — feed the .drt to the Python davinci-resolve MCP timeline.import_timeline_checked, or use timeline.import_from_drp to do both), downgrade (stamp <ProjectVersion> down so an OLDER Resolve will import a .drt/.drp from a newer one — pass targetAppVersion like "19.1.3" or targetProjectVersion).',
   async handler({ action, args }) {
     if (action === 'parse') {
       const p = parseSchema.parse(requirePathArg(args, 'drtPath', 'parse'));
@@ -148,6 +190,37 @@ export const drtTool = {
       await fs.writeFile(p.outputPath, outBuf);
       return { outputPath: p.outputPath, bytes: outBuf.length, seqContainersInjected: injected, projectFolder };
     }
+    if (action === 'assemble') {
+      const p = assembleSchema.parse(args);
+      // Native-schema authoring: template-spliced real Resolve structures
+      // (drp-format assembleTimeline), which ImportTimelineFromFile accepts —
+      // unlike drt.author's flat template. Measured live on Studio 19.1.3.7:
+      // assembled + stamped to the host's ProjectVersion imports with every
+      // element intact.
+      const { assembleTimeline } = drp();
+      const { buffer, timelineName, startFrame } = await assembleTimeline(p.spec);
+      let outBuf = buffer;
+      let stamped = null;
+      if (p.targetAppVersion !== undefined) {
+        const targetPV = resolveTargetProjectVersion({ targetAppVersion: p.targetAppVersion });
+        const appVer = `${p.targetAppVersion}${'.0'.repeat(Math.max(0, 4 - String(p.targetAppVersion).split('.').length))}`;
+        const zip = await JSZip.loadAsync(buffer);
+        const { out, elementPatches, stampPatches } = await applyVersionStamps(zip, targetPV, appVer);
+        outBuf = await out.generateAsync({ type: 'nodebuffer', compression: 'DEFLATE' });
+        stamped = { targetProjectVersion: targetPV, elementPatches, stampPatches };
+      }
+      await fs.writeFile(p.outputPath, outBuf);
+      return {
+        outputPath: p.outputPath,
+        bytes: outBuf.length,
+        timelineName,
+        startFrame,
+        stamped,
+        note:
+          'Import with timeline.import_timeline_checked — the imported timeline is named after the FILE. ' +
+          'On a host older than Resolve 21, pass targetAppVersion or the version gate refuses the archive.',
+      };
+    }
     if (action === 'extract_from_drp') {
       const p = extractFromDrpSchema.parse(args);
       const drpZip = await JSZip.loadAsync(await fs.readFile(p.drpPath));
@@ -156,16 +229,37 @@ export const drtTool = {
       if (idx >= seqEntries.length) {
         return { error: `timelineIndex ${idx} out of range (${seqEntries.length} SeqContainers)` };
       }
-      const xml = await drpZip.file(seqEntries[idx]).async('string');
+      // The importable-.drt recipe, measured by bisection on Studio 19.1.3.7:
+      // a .drt IS a .drp that ImportTimelineFromFile accepts. project.xml and
+      // MediaPool/ are REQUIRED (the Sm2Sequence/Sm2Timeline objects live in
+      // MpFolder.xml); the SeqContainer must keep its ORIGINAL uuid path —
+      // renaming it imports an EMPTY timeline with no error; Gallery.xml is
+      // droppable. Other timelines' MpFolder blocks must go too, or each
+      // arrives as a ghost empty timeline (matched via the container tracks'
+      // <Sequence> DbId, which appears inside exactly one Sm2MpTimelineClip).
+      const keepEntry = seqEntries[idx];
+      const keepXml = await drpZip.file(keepEntry).async('string');
+      const keepSeqIds = [...keepXml.matchAll(/<Sequence>([0-9a-f-]{36})<\/Sequence>/g)].map((m) => m[1]);
       const out = new JSZip();
-      out.file('Primary1/SeqContainer1.xml', xml);
-      // ImportTimelineFromFile refuses a .drt without project.xml (measured
-      // by bisection on Studio 19.1.3.7), so carry the source's over.
-      const projectEntry = Object.keys(drpZip.files).find(
-        (n) => n === 'project.xml' || n.endsWith('/project.xml'),
-      );
-      if (projectEntry) {
-        out.file('project.xml', await drpZip.file(projectEntry).async('string'));
+      let droppedTimelines = 0;
+      for (const name of Object.keys(drpZip.files)) {
+        const entry = drpZip.files[name];
+        if (entry.dir) continue;
+        if (name === 'Gallery.xml') continue;
+        const isSeq = seqEntries.includes(name);
+        if (isSeq && name !== keepEntry) continue;
+        let content = await entry.async(name.endsWith('.xml') ? 'string' : 'nodebuffer');
+        if (name.endsWith('MpFolder.xml') && seqEntries.length > 1) {
+          content = content.replace(
+            /<Element>\s*<Sm2MpTimelineClip DbId="[^"]+">(?:(?!<\/Sm2MpTimelineClip>)[\s\S])*?<\/Sm2MpTimelineClip>\s*<\/Element>/g,
+            (block) => {
+              if (keepSeqIds.some((id) => block.includes(id))) return block;
+              droppedTimelines += 1;
+              return '';
+            },
+          );
+        }
+        out.file(name, content);
       }
       out.file(
         'metadata.json',
@@ -173,7 +267,8 @@ export const drtTool = {
           {
             source: 'extract_from_drp',
             sourceDrp: p.drpPath,
-            sourceSeqContainer: seqEntries[idx],
+            sourceSeqContainer: keepEntry,
+            droppedTimelines,
             exportedFrom: 'davinci-resolve-advanced-mcp drt.extract_from_drp',
           },
           null,
@@ -182,7 +277,13 @@ export const drtTool = {
       );
       const outBuf = await out.generateAsync({ type: 'nodebuffer', compression: 'DEFLATE' });
       await fs.writeFile(p.outputPath, outBuf);
-      return { outputPath: p.outputPath, bytes: outBuf.length, sourceSeqContainer: seqEntries[idx] };
+      return {
+        outputPath: p.outputPath,
+        bytes: outBuf.length,
+        sourceSeqContainer: keepEntry,
+        droppedTimelines,
+        note: 'The imported timeline is named after the FILE. Source must be a SAVED project export — ExportProject snapshots the saved DB state, so unsaved edits are absent.',
+      };
     }
     if (action === 'downgrade') {
       const p = downgradeSchema.parse(args);

package/resolve-advanced/server/tools/project_db.mjs

@@ -19,7 +19,17 @@
 
 import { z } from 'zod';
 import { createRequire } from 'node:module';
-import { resolveDbPath, openGuarded, backup, requireClosed } from '../db-patch.mjs';
+import { resolveDbPath as _resolveDbPathRaw, responsiveRoots, openGuarded, backup, requireClosed } from '../db-patch.mjs';
+
+// projectName discovery walks library roots that macOS can render UNRESPONSIVE
+// (measured: a hung Lite sandbox container froze every lookup). Probe the
+// roots with a deadline first and search only the ones that answer; the
+// not-found error then names any skipped root.
+async function resolveDbPath(p) {
+  if (p.projectDb || !p.projectName) return _resolveDbPathRaw(p);
+  const { roots, skipped } = await responsiveRoots();
+  return _resolveDbPathRaw({ ...p, roots, skippedRoots: skipped });
+}
 
 const require = createRequire(import.meta.url);
 
@@ -96,7 +106,7 @@ export const projectDbTool = {
   async handler({ action, args }) {
     if (action === 'list_folders') {
       const p = listFoldersSchema.parse(args);
-      const db = openGuarded(resolveDbPath(p), { table: 'Sm2MpFolder', column: 'Name' });
+      const db = openGuarded(await resolveDbPath(p), { table: 'Sm2MpFolder', column: 'Name' });
       try {
         return { folders: db.prepare('SELECT Name, ColorTag FROM Sm2MpFolder ORDER BY Name').all() };
       } finally {
@@ -106,7 +116,7 @@ export const projectDbTool = {
     if (action === 'rename_folder') {
       const p = renameFolderSchema.parse(args);
       requireClosed(p);
-      const dbPath = resolveDbPath(p);
+      const dbPath = await resolveDbPath(p);
       const bak = backup(dbPath);
       const db = openGuarded(dbPath, { writable: true, table: 'Sm2MpFolder', column: 'Name' });
       try {
@@ -121,7 +131,7 @@ export const projectDbTool = {
     if (action === 'set_folder_color') {
       const p = folderColorSchema.parse(args);
       requireClosed(p);
-      const dbPath = resolveDbPath(p);
+      const dbPath = await resolveDbPath(p);
       const bak = backup(dbPath);
       const db = openGuarded(dbPath, { writable: true, table: 'Sm2MpFolder', column: 'ColorTag' });
       try {
@@ -135,7 +145,7 @@ export const projectDbTool = {
     }
     if (action === 'list_clips') {
       const p = listClipsSchema.parse(args);
-      const db = openGuarded(resolveDbPath(p), { table: 'Sm2MpMedia', column: 'MarkIn' });
+      const db = openGuarded(await resolveDbPath(p), { table: 'Sm2MpMedia', column: 'MarkIn' });
       try {
         return { clips: db.prepare('SELECT Name, MarkIn, MarkOut FROM Sm2MpMedia ORDER BY Name LIMIT 500').all() };
       } finally {
@@ -146,7 +156,7 @@ export const projectDbTool = {
       const p = clipMarksSchema.parse(args);
       requireClosed(p);
       if (p.markIn == null && p.markOut == null) throw new Error('provide markIn and/or markOut');
-      const dbPath = resolveDbPath(p);
+      const dbPath = await resolveDbPath(p);
       const bak = backup(dbPath);
       const db = openGuarded(dbPath, { writable: true, table: 'Sm2MpMedia', column: 'MarkIn' });
       try {
@@ -163,7 +173,7 @@ export const projectDbTool = {
       const p = relayoutSchema.parse(args);
       const layout = require('../../vendor/drx-codec/node-layout.js');
       const layoutOpts = { originX: p.originX, originY: p.originY, spacingX: p.spacingX };
-      const dbPath = resolveDbPath(p);
+      const dbPath = await resolveDbPath(p);
       const write = !p.dryRun;
       if (write) requireClosed(p);
       const bak = write ? backup(dbPath) : null;
@@ -228,7 +238,7 @@ export const projectDbTool = {
     if (action === 'list_subtitle_styles') {
       const p = listSubtitleStylesSchema.parse(args);
       const style = require('../../vendor/drp-format/subtitle-style.js');
-      const db = openGuarded(resolveDbPath(p), { table: 'Sm2TiTrack', column: 'FieldsBlob' });
+      const db = openGuarded(await resolveDbPath(p), { table: 'Sm2TiTrack', column: 'FieldsBlob' });
       try {
         const counts = new Map();
         const tracks = [];
@@ -281,7 +291,7 @@ export const projectDbTool = {
 
       const write = !p.dryRun;
       if (write) requireClosed(p);
-      const dbPath = resolveDbPath(p);
+      const dbPath = await resolveDbPath(p);
       const bak = write ? backup(dbPath) : null;
       const db = openGuarded(dbPath, { writable: write, table: 'Sm2TiTrack', column: 'FieldsBlob' });
       try {

package/src/granular/common.py

@@ -87,7 +87,7 @@ if not logging.getLogger().handlers:
         handlers=[logging.StreamHandler()],
     )
 
-VERSION = "2.104.9"
+VERSION = "2.105.0"
 logger = logging.getLogger("davinci-resolve-mcp")
 logger.info(f"Starting DaVinci Resolve MCP Server v{VERSION}")
 logger.info(f"Detected platform: {get_platform()}")

package/src/server.py

@@ -11,7 +11,7 @@ Usage:
     python src/server.py --full       # Start the 353-tool granular server instead
 """
 
-VERSION = "2.104.9"
+VERSION = "2.105.0"
 
 import base64
 import os
@@ -7158,12 +7158,12 @@ def _import_timeline_checked(proj, mp, p: Dict[str, Any]):
                 "dismisses it, so this import is not attempted at all.",
                 category="invalid_input",
                 remediation=(
-                    "Authored DRTs serve offline/DB workflows, not live import. "
-                    "For a live import, author OTIO instead "
-                    "(editorial.convert_to_interchange target 'otio' imports "
-                    "cleanly), or import a REAL Resolve .drt — one Resolve "
-                    "exported, or one pulled from a .drp with "
-                    "drt.extract_from_drp."
+                    "Flat-authored DRTs serve offline/DB workflows, not live "
+                    "import. For an importable .drt, use drt.assemble "
+                    "(native-schema authoring from a spec; pass "
+                    "targetAppVersion e.g. '19.1' on pre-21 hosts), "
+                    "drt.extract_from_drp on a SAVED .drp export, or author "
+                    "OTIO (editorial.convert_to_interchange target 'otio')."
                 ),
             )
     # ImportTimelineFromFile silently no-ops on the never-saved default project: it returns
@@ -7465,38 +7465,62 @@ def _drp_seq_containers(zf) -> List[Dict[str, Any]]:
 
 
 def _extract_seqcontainer_from_drp(drp_path: str, seq_entry: str, out_path: str) -> None:
-    """Write a .drt (zip) holding one SeqContainer plus the source's project.xml.
-
-    ImportTimelineFromFile refuses a .drt without project.xml (measured by
-    bisection on Studio 19.1.3.7: a real export minus only project.xml is
-    refused; project.xml + container with no MpFolder imports). The source
-    .drp/.drt carries one — copy it, or the extract cannot import.
+    """Write an IMPORTABLE .drt holding one timeline from a .drp/.drt archive.
+
+    The recipe, measured by bisection on Studio 19.1.3.7: a .drt IS a .drp
+    that ImportTimelineFromFile accepts. project.xml and MediaPool/ are
+    REQUIRED (the Sm2Sequence/Sm2Timeline objects live in MpFolder.xml); the
+    SeqContainer must keep its ORIGINAL uuid path — renaming it imports an
+    EMPTY timeline with no error; Gallery.xml is droppable; and other
+    timelines' Sm2MpTimelineClip blocks must be removed from MpFolder.xml or
+    each arrives as a ghost empty timeline (matched via the kept container's
+    track <Sequence> DbIds, which appear inside exactly one block). Source
+    must be a SAVED export — ExportProject snapshots the saved DB state.
     """
     import zipfile
 
     with zipfile.ZipFile(drp_path, "r") as zf:
-        xml = zf.read(seq_entry)
-        project_xml = None
-        for candidate in zf.namelist():
-            if candidate == "project.xml" or candidate.endswith("/project.xml"):
-                project_xml = zf.read(candidate)
-                break
-    with zipfile.ZipFile(out_path, "w", zipfile.ZIP_DEFLATED) as out:
-        out.writestr("Primary1/SeqContainer1.xml", xml)
-        if project_xml is not None:
-            out.writestr("project.xml", project_xml)
-        out.writestr(
-            "metadata.json",
-            json.dumps(
-                {
-                    "source": "import_from_drp",
-                    "sourceDrp": drp_path,
-                    "sourceSeqContainer": seq_entry,
-                    "exportedFrom": "davinci-resolve-mcp timeline.import_from_drp",
-                },
-                indent=2,
-            ),
-        )
+        names = [n for n in zf.namelist() if not n.endswith("/")]
+        seq_entries = [n for n in names if _SEQ_CONTAINER_RE.search(n)]
+        keep_xml = zf.read(seq_entry).decode("utf-8", "replace")
+        keep_seq_ids = re.findall(r"<Sequence>([0-9a-f-]{36})</Sequence>", keep_xml)
+        with zipfile.ZipFile(out_path, "w", zipfile.ZIP_DEFLATED) as out:
+            for name in names:
+                if name == "Gallery.xml":
+                    continue
+                if name in seq_entries and name != seq_entry:
+                    continue
+                data = zf.read(name)
+                if name.endswith("MpFolder.xml") and len(seq_entries) > 1:
+                    text = data.decode("utf-8", "replace")
+
+                    def _keep_block(match):
+                        block = match.group(0)
+                        if any(sid in block for sid in keep_seq_ids):
+                            return block
+                        return ""
+
+                    text = re.sub(
+                        r"<Element>\s*<Sm2MpTimelineClip DbId=\"[^\"]+\">"
+                        r"(?:(?!</Sm2MpTimelineClip>)[\s\S])*?"
+                        r"</Sm2MpTimelineClip>\s*</Element>",
+                        _keep_block,
+                        text,
+                    )
+                    data = text.encode("utf-8")
+                out.writestr(name, data)
+            out.writestr(
+                "metadata.json",
+                json.dumps(
+                    {
+                        "source": "import_from_drp",
+                        "sourceDrp": drp_path,
+                        "sourceSeqContainer": seq_entry,
+                        "exportedFrom": "davinci-resolve-mcp timeline.import_from_drp",
+                    },
+                    indent=2,
+                ),
+            )
 
 
 def _import_from_drp(proj, mp, p: Dict[str, Any]):
@@ -18975,8 +18999,40 @@ def _safe_quick_export(proj, p: Dict[str, Any]):
         return {"success": False, "validation": validation}
     if p.get("dry_run") or not p.get("allow_render", False):
         return _ok(would_render=False, preset=preset, params=params, validation=validation)
+    before = set()
+    if target_dir and os.path.isdir(target_dir):
+        before = set(os.listdir(target_dir))
     status = _ser(proj.RenderWithQuickExport(preset, params))
-    return {"success": not (isinstance(status, dict) and status.get("error")), "status": status, "params": params}
+    out: Dict[str, Any] = {
+        "success": not (isinstance(status, dict) and status.get("error")),
+        "status": status,
+        "params": params,
+    }
+    # RenderWithQuickExport's status dict is trusted nowhere else in this
+    # repo's render surface anymore (issue #164 taught that lesson) — check
+    # what actually landed on disk. Best-effort: TargetDir is known, so a
+    # successful export must have produced at least one new file there.
+    if out["success"] and target_dir and os.path.isdir(target_dir):
+        new_files = sorted(set(os.listdir(target_dir)) - before)
+        outputs = []
+        for name in new_files:
+            path = os.path.join(target_dir, name)
+            if not os.path.isfile(path):
+                continue
+            rec: Dict[str, Any] = {"path": path, "size_bytes": os.path.getsize(path)}
+            probe = _ffprobe_media_summary(path)
+            if probe:
+                rec["duration_seconds"] = probe.get("duration_seconds")
+            outputs.append(rec)
+        out["outputs"] = outputs
+        if not outputs:
+            out["success"] = False
+            out["error"] = (
+                "RenderWithQuickExport reported success but wrote no file to "
+                f"{target_dir} — treat the status dict as unreliable and check "
+                "the Deliver page's render queue."
+            )
+    return out
 
 
 def _export_render_boundary_report(proj, p: Dict[str, Any]):
@@ -19049,7 +19105,10 @@ def render(action: str, params: Optional[Dict[str, Any]] = None) -> Dict[str, An
         way to read back — see the SetRenderSettings api_truth entry.
       render_job_lifecycle_probe(target_dir, settings?, format?, codec?, custom_name?) -> {success, job_id, status_before_delete}
       quick_export_capabilities() -> {presets, safe_params, guards}
-      safe_quick_export(preset, target_dir?|params?, custom_name?, dry_run?, allow_render?) -> {success, status}
+      safe_quick_export(preset, target_dir?|params?, custom_name?, dry_run?, allow_render?) -> {success, status, outputs}
+        After a live export, the files that actually landed in TargetDir are
+        listed with size and ffprobe duration; a success status that wrote no
+        file flips success to false (the issue #164 trust lesson).
       export_render_boundary_report(include_matrix?, max_pairs?, include_quick_export?) -> {capabilities, settings, matrix?}
       list_delivery_targets(tier?, check_availability?) -> {targets, tiers, schema_version}
       resolve_delivery_target(target, overrides?) -> {format_id, codec_id, settings, qc_spec}

package/src/utils/api_truth.py

@@ -1866,7 +1866,13 @@ API_TRUTH: List[Dict[str, Any]] = [
                    "(issue #171, Studio 21.0.4.5; wrapper behavior verified on "
                    "19.1.3.7). Distinct from the documented repeated-"
                    "timelineName None return: here the option is fresh and the "
-                   "file's name is stale.",
+                   "file's name is stale. THE NAMING AUTHORITY DIFFERS PER "
+                   "FORMAT (all measured on 19.1.3.7): FCP7 XML ignores "
+                   "timelineName entirely (internal <name> wins); AAF honours "
+                   "timelineName when given and falls back to its internal "
+                   "name; OTIO honours timelineName; and .drt names the "
+                   "timeline after the FILE (see the .drt entry below). Only "
+                   "FCP7 exhibits the returned-existing trap.",
         "recommended": "Rewrite the <sequence><name> inside the file to the "
                        "intended name before importing — "
                        "timeline.import_timeline_checked does this "
@@ -1883,32 +1889,37 @@ API_TRUTH: List[Dict[str, Any]] = [
         "symbol": "MediaPool.ImportTimelineFromFile (.drt requirements and filename naming)",
         "object": "MediaPool",
         "signature": "(drtPath, {importSourceClips, ...}) -> Timeline",
-        "reality": "Measured by bisection on Studio 19.1.3.7 against a real "
-                   ".drt export: (1) the archive MUST contain project.xml — "
-                   "the same archive minus only that entry is refused, while "
-                   "removing MediaPool/MpFolder.xml or renaming the "
-                   "SeqContainer path changes nothing; (2) the container XML "
-                   "must be Resolve's native blob-based schema — a syntactic "
-                   "SeqContainer with flat template elements is refused even "
-                   "beside a genuine project.xml; (3) the imported timeline is "
-                   "named after the FILE (real_2997.drt -> 'real_2997'), not "
-                   "the container's internal name — a third naming authority "
-                   "beside FCP7 (internal name wins) and OTIO (timelineName "
-                   "option wins); and (4) a refused import can raise a modal "
-                   "error dialog that BLOCKS the scripting call until a human "
-                   "dismisses it — the call neither returns nor times out.",
-        "recommended": "Import only .drt files Resolve itself exported — "
-                       "the sufficient set is unmapped beyond that: even a "
-                       ".drp-sourced native container repacked WITH its "
-                       "project.xml was refused (measured 19.1.3.7), so "
-                       "extraction-based .drt import cannot be relied on "
-                       "either. Name the timeline by naming the FILE. Never "
-                       "batch speculative .drt imports unattended — one "
-                       "refusal can hold the whole session hostage behind "
-                       "its dialog. timeline.import_timeline_checked detects "
-                       "the authored template shape up front and refuses "
-                       "with this diagnosis instead of importing; for a "
-                       "reliable programmatic import use OTIO or FCP7 XML.",
+        "reality": "Fully mapped by bisection on Studio 19.1.3.7: a .drt IS "
+                   "a .drp that ImportTimelineFromFile accepts — a whole "
+                   "saved-project export renamed .drt imports, clips intact. "
+                   "Requirements: (1) project.xml present; (2) MediaPool/"
+                   "MpFolder.xml present — it holds the Sm2Sequence/"
+                   "Sm2Timeline objects; (3) the SeqContainer keeps its "
+                   "ORIGINAL uuid path — renaming it 'succeeds' with an "
+                   "EMPTY timeline (items=0, no error), the nastiest variant; "
+                   "(4) version stamps at or below the host's ProjectVersion; "
+                   "(5) native blob schema — flat template containers are "
+                   "refused; (6) the source must be a SAVED export "
+                   "(ExportProject snapshots the saved DB state, so an "
+                   "unsaved timeline exports EMPTY tracks). Every "
+                   "Sm2MpTimelineClip block in MpFolder imports as a "
+                   "timeline: extra blocks arrive as ghost empty timelines "
+                   "unless removed (match blocks via the kept container's "
+                   "track <Sequence> DbIds). The imported timeline is named "
+                   "after the FILE, and a refused import can raise a modal "
+                   "dialog that BLOCKS the scripting call until a human "
+                   "dismisses it.",
+        "recommended": "Follow the recipe: drt.extract_from_drp implements "
+                       "it (original container path, MpFolder carried, ghost "
+                       "blocks removed, Gallery dropped), and drt.assemble "
+                       "authors importable native-schema archives from "
+                       "scratch (template-spliced; pass targetAppVersion on "
+                       "pre-21 hosts). Save the project before ExportProject. "
+                       "Name the timeline by naming the FILE. Never batch "
+                       "speculative .drt imports unattended — one refusal "
+                       "can hold the session hostage behind its dialog; "
+                       "timeline.import_timeline_checked refuses the flat "
+                       "authored shape up front for exactly that reason.",
         "tags": ["timeline", "import", "silent-failure", "headless"],
         "submit": "bug",
     },