@nodetool-ai/cli-timeline 0.0.0-stage → 0.8.9-beta.2

package/dist/timeline-debug/harness.js

@@ -0,0 +1,100 @@
+import { runInteractionSteps } from "@nodetool-ai/cli-common/interaction-script";
+import { writeDebugBundle } from "@nodetool-ai/cli-common/debug-bundle";
+import { resolveTimelineTarget } from "./target.js";
+async function loadCore() {
+    const core = await import("@nodetool-ai/execution/timeline-debug");
+    return {
+        validateTimelineSequence: (raw, meta) => core.validateTimelineSequence(raw, meta),
+        buildTimelineDebugReport: (input) => core.buildTimelineDebugReport(input),
+        renderTimelineReportMarkdown: (report) => core.renderTimelineReportMarkdown(report)
+    };
+}
+async function loadBridgeFactory() {
+    const { createTimelineToolBridge } = await import("@nodetool-ai/agents");
+    return (initial) => 
+    // SAFETY: the eval-surface bridge in @nodetool-ai/agents implements this
+    // exact tool list and snapshot — it is the bridge this type describes. The
+    // two packages declare the timeline document types independently, and that
+    // duplication is the only reason the structures do not line up.
+    createTimelineToolBridge(initial);
+}
+/** Load a timeline and validate it — no bridge, no bundle. */
+export async function runTimelineValidate(ref, deps) {
+    const resolved = await resolveTimelineTarget(ref, deps);
+    const core = deps.core ?? (await loadCore());
+    const validation = await core.validateTimelineSequence(resolved.raw, resolved.meta);
+    return { target: resolved.target, validation };
+}
+/**
+ * Replay `--interact` against the headless bridge and write the bundle.
+ *
+ * A failing step is recorded and the script continues: a run that stops at the
+ * first error hides every problem behind it, and the report is what the caller
+ * came for.
+ */
+export async function runTimelineDebug(ref, options, deps) {
+    const resolved = await resolveTimelineTarget(ref, deps);
+    const core = deps.core ?? (await loadCore());
+    const steps = options.interact ?? [];
+    const interactions = [];
+    let snapshot;
+    if (steps.length > 0) {
+        const createBridge = deps.createBridge ?? (await loadBridgeFactory());
+        const sequence = {
+            ...resolved.meta,
+            tracks: resolved.document.tracks,
+            clips: resolved.document.clips,
+            markers: resolved.document.markers,
+            // Ticks are read against it, so a session that never sees the stored
+            // tempo rescales the midi clips off the 120 BPM default.
+            tempo: resolved.document.tempo
+        };
+        if (resolved.document.camera2d !== undefined) {
+            sequence.camera2d = resolved.document.camera2d;
+        }
+        const bridge = createBridge({ sequence });
+        interactions.push(...(await runInteractionSteps(steps, bridge.tools, "timeline", deps.onLog)));
+        snapshot = bridge.finalState();
+    }
+    // The bridge hands back its full tracks, clips and markers, so the document
+    // the session ended with is a real document. Markers fall back to the ones
+    // the target carried, for a bridge that does not report them.
+    const finalCamera2d = snapshot?.camera2d !== undefined
+        ? snapshot.camera2d
+        : resolved.document.camera2d;
+    let finalDocument;
+    if (snapshot?.documentTracks && snapshot.documentClips) {
+        finalDocument = {
+            tracks: snapshot.documentTracks,
+            clips: snapshot.documentClips,
+            markers: snapshot.markers ?? resolved.document.markers,
+            tempo: snapshot.tempo ?? resolved.document.tempo
+        };
+        if (finalCamera2d !== undefined) {
+            finalDocument.camera2d = finalCamera2d;
+        }
+    }
+    const reportInput = {
+        target: resolved.target,
+        document: resolved.raw,
+        meta: resolved.meta,
+        interactions
+    };
+    if (snapshot) {
+        reportInput.finalState = snapshot;
+    }
+    if (finalDocument) {
+        reportInput.finalDocument = finalDocument;
+    }
+    const report = await core.buildTimelineDebugReport(reportInput);
+    const bundleDir = await writeDebugBundle({
+        kind: "timeline",
+        ref,
+        outDir: options.outDir,
+        raw: resolved.raw,
+        report,
+        reportMarkdown: core.renderTimelineReportMarkdown(report),
+    });
+    return { report, bundleDir };
+}
+//# sourceMappingURL=harness.js.map

package/dist/timeline-debug/harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.js","sourceRoot":"","sources":["../../src/timeline-debug/harness.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,EACL,qBAAqB,EAItB,MAAM,aAAa,CAAC;AA8ErB,KAAK,UAAU,QAAQ;IACrB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,uCAAuC,CAAC,CAAC;IACnE,OAAO;QACL,wBAAwB,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CACtC,IAAI,CAAC,wBAAwB,CAAC,GAAG,EAAE,IAAI,CAAC;QAC1C,wBAAwB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC;QACzE,4BAA4B,EAAE,CAAC,MAAM,EAAE,EAAE,CACvC,IAAI,CAAC,4BAA4B,CAAC,MAAM,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,iBAAiB;IAC9B,MAAM,EAAE,wBAAwB,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACzE,OAAO,CAAC,OAAO,EAAE,EAAE;IACjB,yEAAyE;IACzE,2EAA2E;IAC3E,2EAA2E;IAC3E,gEAAgE;IAChE,wBAAwB,CACtB,OAAyD,CACxC,CAAC;AACxB,CAAC;AAED,8DAA8D;AAC9D,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,GAAW,EACX,IAAuB;IAEvB,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,QAAQ,EAAE,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,wBAAwB,CACpD,QAAQ,CAAC,GAAG,EACZ,QAAQ,CAAC,IAAI,CACd,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;AACjD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAW,EACX,OAA6B,EAC7B,IAAuB;IAEvB,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,QAAQ,EAAE,CAAC,CAAC;IAE7C,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;IACrC,MAAM,YAAY,GAAgC,EAAE,CAAC;IACrD,IAAI,QAA4C,CAAC;IAEjD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,CAAC,MAAM,iBAAiB,EAAE,CAAC,CAAC;QACtE,MAAM,QAAQ,GAAoD;YAChE,GAAG,QAAQ,CAAC,IAAI;YAChB,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM;YAChC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,KAAK;YAC9B,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO;YAClC,qEAAqE;YACrE,yDAAyD;YACzD,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,KAAK;SAC/B,CAAC;QACF,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC7C,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACjD,CAAC;QACD,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC1C,YAAY,CAAC,IAAI,CACf,GAAG,CAAC,MAAM,mBAAmB,CAC3B,KAAK,EACL,MAAM,CAAC,KAAK,EACZ,UAAU,EACV,IAAI,CAAC,KAAK,CACX,CAAC,CACH,CAAC;QACF,QAAQ,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IACjC,CAAC;IAED,4EAA4E;IAC5E,2EAA2E;IAC3E,8DAA8D;IAC9D,MAAM,aAAa,GACjB,QAAQ,EAAE,QAAQ,KAAK,SAAS;QAC9B,CAAC,CAAC,QAAQ,CAAC,QAAQ;QACnB,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;IACjC,IAAI,aAA2C,CAAC;IAChD,IAAI,QAAQ,EAAE,cAAc,IAAI,QAAQ,CAAC,aAAa,EAAE,CAAC;QACvD,aAAa,GAAG;YACd,MAAM,EAAE,QAAQ,CAAC,cAAc;YAC/B,KAAK,EAAE,QAAQ,CAAC,aAAa;YAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO;YACtD,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK;SACjD,CAAC;QACF,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,aAAa,CAAC,QAAQ,GAAG,aAAa,CAAC;QACzC,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAwD;QACvE,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,QAAQ,EAAE,QAAQ,CAAC,GAAG;QACtB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,YAAY;KACb,CAAC;IACF,IAAI,QAAQ,EAAE,CAAC;QACb,WAAW,CAAC,UAAU,GAAG,QAAQ,CAAC;IACpC,CAAC;IACD,IAAI,aAAa,EAAE,CAAC;QAClB,WAAW,CAAC,aAAa,GAAG,aAAa,CAAC;IAC5C,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,wBAAwB,CAAC,WAAW,CAAC,CAAC;IAEhE,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC;QACvC,IAAI,EAAE,UAAU;QAChB,GAAG;QACH,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,GAAG,EAAE,QAAQ,CAAC,GAAG;QACjB,MAAM;QACN,cAAc,EAAE,IAAI,CAAC,4BAA4B,CAAC,MAAM,CAAC;KAC1D,CAAC,CAAC;IAEH,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC/B,CAAC"}

package/dist/timeline-debug/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The CLI host for the timeline debug harness: target resolution, the
+ * `--interact` script, and the bundle writer. The rules themselves live in
+ * `@nodetool-ai/execution/timeline-debug`.
+ */
+export { runTimelineDebug, runTimelineValidate, type CreateTimelineBridge, type TimelineBridge, type TimelineBridgeSnapshot, type TimelineBridgeTool, type TimelineDebugCore, type TimelineDebugDeps, type TimelineDebugOptions, type TimelineDebugResult, type TimelineValidateResult } from "./harness.js";
+export { normalizeToolName, parseInteractionScript, type TimelineInteractionStep } from "./interactions.js";
+export { resolveTimelineTarget, type ResolvedTimelineTarget, type TimelineSequenceRecord, type TimelineSequenceSettings, type TimelineTargetDeps } from "./target.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/timeline-debug/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/timeline-debug/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC5B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,uBAAuB,EAC7B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,qBAAqB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC"}

package/dist/timeline-debug/index.js

@@ -0,0 +1,9 @@
+/**
+ * The CLI host for the timeline debug harness: target resolution, the
+ * `--interact` script, and the bundle writer. The rules themselves live in
+ * `@nodetool-ai/execution/timeline-debug`.
+ */
+export { runTimelineDebug, runTimelineValidate } from "./harness.js";
+export { normalizeToolName, parseInteractionScript } from "./interactions.js";
+export { resolveTimelineTarget } from "./target.js";
+//# sourceMappingURL=index.js.map

package/dist/timeline-debug/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/timeline-debug/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EAUpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EAEvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,qBAAqB,EAKtB,MAAM,aAAa,CAAC"}

package/dist/timeline-debug/interactions.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The `--interact` script for `nodetool timeline debug`.
+ *
+ * A step names one timeline tool and the input to call it with:
+ *
+ * ```json
+ * [{"tool": "add_track", "input": {"type": "audio"}},
+ *  {"tool": "ui_timeline_animate_clip",
+ *   "input": {"target": "Title", "animations": [{"role": "in", "preset": "fade"}]}}]
+ * ```
+ *
+ * Both spellings resolve to the same tool: the `ui_timeline_` prefix is what
+ * the bridge and the browser call it, and typing it for every step is noise.
+ */
+import { type InteractionStep } from "@nodetool-ai/cli-common/interaction-script";
+/** One parsed step, with the tool name in its canonical `ui_timeline_*` form. */
+export type TimelineInteractionStep = InteractionStep;
+export declare const normalizeToolName: (name: string) => string, parseInteractionScript: (json: string) => InteractionStep[];
+//# sourceMappingURL=interactions.d.ts.map

package/dist/timeline-debug/interactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactions.d.ts","sourceRoot":"","sources":["../../src/timeline-debug/interactions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,4CAA4C,CAAC;AAEpD,iFAAiF;AACjF,MAAM,MAAM,uBAAuB,GAAG,eAAe,CAAC;AAEtD,eAAO,MAAQ,iBAAiB,4BAAE,sBAAsB,qCAIrD,CAAC"}

package/dist/timeline-debug/interactions.js

@@ -0,0 +1,17 @@
+/**
+ * The `--interact` script for `nodetool timeline debug`.
+ *
+ * A step names one timeline tool and the input to call it with:
+ *
+ * ```json
+ * [{"tool": "add_track", "input": {"type": "audio"}},
+ *  {"tool": "ui_timeline_animate_clip",
+ *   "input": {"target": "Title", "animations": [{"role": "in", "preset": "fade"}]}}]
+ * ```
+ *
+ * Both spellings resolve to the same tool: the `ui_timeline_` prefix is what
+ * the bridge and the browser call it, and typing it for every step is noise.
+ */
+import { createInteractionScript } from "@nodetool-ai/cli-common/interaction-script";
+export const { normalizeToolName, parseInteractionScript } = createInteractionScript("ui_timeline_", '{"tool":"add_track","input":{"type":"audio"}}');
+//# sourceMappingURL=interactions.js.map

package/dist/timeline-debug/interactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactions.js","sourceRoot":"","sources":["../../src/timeline-debug/interactions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EACL,uBAAuB,EAExB,MAAM,4CAA4C,CAAC;AAKpD,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,GACxD,uBAAuB,CACrB,cAAc,EACd,+CAA+C,CAChD,CAAC"}

package/dist/timeline-debug/target.d.ts

@@ -0,0 +1,34 @@
+import type { TimelineDocument } from "@nodetool-ai/protocol/api-schemas/timeline.js";
+import type { TimelineDebugTarget } from "@nodetool-ai/execution/timeline-debug";
+/** A `timeline_sequences` row as the harness needs it. */
+export interface TimelineSequenceRecord {
+    id: string;
+    name?: string;
+    fps?: number;
+    width?: number;
+    height?: number;
+    /** The stored document — a JSON string or an already-parsed object. */
+    document: unknown;
+}
+export interface TimelineTargetDeps {
+    /** Load a timeline sequence by DB id. */
+    loadSequence: (id: string) => Promise<TimelineSequenceRecord | null>;
+}
+/** The sequence settings a document does not carry itself. */
+export interface TimelineSequenceSettings {
+    fps?: number;
+    width?: number;
+    height?: number;
+    durationMs?: number;
+}
+export interface ResolvedTimelineTarget {
+    target: TimelineDebugTarget;
+    /** The document exactly as loaded — validation's input, unrepaired. */
+    raw: unknown;
+    /** The same document, read as tracks + clips + markers. */
+    document: TimelineDocument;
+    meta: TimelineSequenceSettings;
+}
+/** Resolve a timeline target: a JSON file path or a sequence row id. */
+export declare function resolveTimelineTarget(ref: string, deps: TimelineTargetDeps): Promise<ResolvedTimelineTarget>;
+//# sourceMappingURL=target.d.ts.map

package/dist/timeline-debug/target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../src/timeline-debug/target.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AASjF,0DAA0D;AAC1D,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;CACtE;AAED,8DAA8D;AAC9D,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,uEAAuE;IACvE,GAAG,EAAE,OAAO,CAAC;IACb,2DAA2D;IAC3D,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,IAAI,EAAE,wBAAwB,CAAC;CAChC;AAkDD,wEAAwE;AACxE,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,sBAAsB,CAAC,CA6CjC"}

package/dist/timeline-debug/target.js

@@ -0,0 +1,109 @@
+/**
+ * Resolves a timeline debug target into a document plus its sequence settings.
+ *
+ * A timeline is named two ways, and both end up in the same shape:
+ *
+ * - a **JSON file** — either a bare `TimelineDocument` (`tracks`/`clips`/
+ *   `markers`) or a wrapper carrying one under `document`, as the
+ *   `timeline_sequences` row and the `GET /api/timeline/:id` response do;
+ * - a **timeline_sequences row id**, read through an injected loader so this
+ *   module needs no database.
+ *
+ * A path that exists on disk wins over an id, so a file named like an id is
+ * still readable.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { isBoolean, isFiniteNumber, isRecord, isString } from "@nodetool-ai/cli-common/predicates";
+import { documentOf } from "@nodetool-ai/cli-common/document-json";
+const numberOr = (value) => isFiniteNumber(value) ? value : undefined;
+/** Read fps/width/height off whatever wrapper carried the document. */
+function settingsOf(raw) {
+    if (!isRecord(raw))
+        return {};
+    const settings = {};
+    const fps = numberOr(raw.fps);
+    const width = numberOr(raw.width);
+    const height = numberOr(raw.height);
+    const durationMs = numberOr(raw.durationMs);
+    if (fps !== undefined)
+        settings.fps = fps;
+    if (width !== undefined)
+        settings.width = width;
+    if (height !== undefined)
+        settings.height = height;
+    if (durationMs !== undefined)
+        settings.durationMs = durationMs;
+    return settings;
+}
+/** A document is anything with `tracks` and `clips` arrays. */
+const looksLikeDocument = (value) => isRecord(value) && Array.isArray(value.tracks) && Array.isArray(value.clips);
+/** Read a document as tracks + clips + markers, defaulting what is missing. */
+function asDocument(raw) {
+    const record = isRecord(raw) ? raw : {};
+    const document = {
+        tracks: Array.isArray(record.tracks)
+            ? record.tracks
+            : [],
+        clips: Array.isArray(record.clips)
+            ? record.clips
+            : [],
+        markers: Array.isArray(record.markers)
+            ? record.markers
+            : []
+    };
+    if (Array.isArray(record.transcript)) {
+        document.transcript = record.transcript;
+    }
+    if (isBoolean(record.scriptEnabled)) {
+        document.scriptEnabled = record.scriptEnabled;
+    }
+    if (record.camera2d !== undefined) {
+        document.camera2d = record.camera2d;
+    }
+    return document;
+}
+/** Resolve a timeline target: a JSON file path or a sequence row id. */
+export async function resolveTimelineTarget(ref, deps) {
+    if (existsSync(ref)) {
+        let parsed;
+        try {
+            parsed = JSON.parse(readFileSync(ref, "utf8"));
+        }
+        catch (e) {
+            throw new Error(`${ref} is not valid JSON: ${e.message}`);
+        }
+        const raw = documentOf(parsed);
+        if (!looksLikeDocument(raw)) {
+            throw new Error(`${ref} is not a timeline document (no \`tracks\`/\`clips\` arrays, and no \`document\` field carrying them).`);
+        }
+        const name = isRecord(parsed) && isString(parsed.name)
+            ? parsed.name
+            : undefined;
+        const target = { kind: "file", ref };
+        if (name) {
+            target.name = name;
+        }
+        return {
+            target,
+            raw,
+            document: asDocument(raw),
+            meta: { ...settingsOf(parsed), ...settingsOf(raw) }
+        };
+    }
+    const record = await deps.loadSequence(ref);
+    if (!record) {
+        throw new Error(`Timeline sequence not found: ${ref}`);
+    }
+    const raw = documentOf(record);
+    const target = { kind: "id", ref };
+    if (record.name) {
+        target.name = record.name;
+    }
+    return {
+        target,
+        raw,
+        document: asDocument(raw),
+        meta: settingsOf(record)
+    };
+}
+//# sourceMappingURL=target.js.map

package/dist/timeline-debug/target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.js","sourceRoot":"","sources":["../../src/timeline-debug/target.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,65 @@
 {
   "name": "@nodetool-ai/cli-timeline",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.8.9-beta.2",
+  "description": "Independent timeline command feature for NodeTool",
+  "type": "module",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "nodetool-timeline": "dist/nodetool.js"
+  },
+  "exports": {
+    ".": {
+      "nodetool-dev": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./*": {
+      "nodetool-dev": "./src/*.ts",
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
+    }
+  },
+  "scripts": {
+    "build": "node ../../scripts/build-typescript-workspace.mjs",
+    "test": "node ../../scripts/run-vitest.mjs run",
+    "lint": "node ../../scripts/run-tsc.mjs --noEmit"
+  },
+  "dependencies": {
+    "@nodetool-ai/agents": "0.8.9-beta.2",
+    "@nodetool-ai/cli-common": "0.8.9-beta.2",
+    "@nodetool-ai/config": "0.8.9-beta.2",
+    "@nodetool-ai/execution": "0.8.9-beta.2",
+    "@nodetool-ai/models": "0.8.9-beta.2",
+    "@nodetool-ai/node-catalog": "0.8.9-beta.2",
+    "@nodetool-ai/pack-manager": "0.8.9-beta.2",
+    "@nodetool-ai/protocol": "0.8.9-beta.2",
+    "@nodetool-ai/runtime": "0.8.9-beta.2",
+    "@nodetool-ai/storage": "0.8.9-beta.2",
+    "@nodetool-ai/video-nodes": "0.8.9-beta.2",
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "npm:@typescript/typescript6@6.0.2",
+    "vitest": "^5.0.1"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nodetool-ai/nodetool.git",
+    "directory": "packages/cli-timeline"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}