@nodetool-ai/agents 0.8.1 → 0.8.2

package/dist/capabilities/timelines.d.ts

@@ -17,9 +17,13 @@
  *
  * Design: docs/tool-class-retirement-design.md § "Migration".
  */
-import type { TimelineDocument } from "@nodetool-ai/models";
-import type { TimelineBridgeFinalState } from "../evals/surfaces/timeline.js";
-import type { CapabilityExport, CapabilityModule } from "./types.js";
+import type { TimelineDocument, TimelineSequence } from "@nodetool-ai/models";
+import type { TimelineBridgeFinalState } from "./timeline-bridge.js";
+import type { CapabilityExport, CapabilityModule, CapabilityRun } from "./types.js";
+import { type MediaEditRequest } from "@nodetool-ai/timeline";
+type ToolError = {
+    error: string;
+};
 declare const listTimelines: CapabilityExport;
 /**
  * A new, empty sequence.
@@ -38,6 +42,39 @@ declare const getTimelineVersion: CapabilityExport;
 declare const createTimelineVersion: CapabilityExport;
 declare const restoreTimelineVersion: CapabilityExport;
 declare const deleteTimelineVersion: CapabilityExport;
+export interface ParsedOp {
+    op: string;
+    input: Record<string, unknown>;
+}
+/** An op is `{op, ...args}` — the arguments sit alongside the verb. */
+export declare function parseOps(raw: unknown): ParsedOp[] | ToolError;
+export interface OpRecord {
+    op: string;
+    ok: boolean;
+    result?: unknown;
+    error?: string;
+}
+export interface ApplyOutcome {
+    records: OpRecord[];
+    state: TimelineBridgeFinalState;
+}
+/**
+ * Run `ops` against a bridge seeded from `document`.
+ *
+ * A failing op is recorded and the script continues: stopping at the first
+ * error hides every problem behind it, and the caller wants the whole picture.
+ *
+ * `hermetic` leaves out the hooks that write outside the document: the 3D
+ * render and the new sequence a retarget creates. A code bake sets it. The
+ * bridge then uses its in-memory fallbacks for those ops.
+ */
+export declare function applyOps(run: CapabilityRun, sequence: TimelineSequence, document: TimelineDocument, ops: ParsedOp[], options?: {
+    hermetic?: boolean;
+    generateMediaEdit?: (request: MediaEditRequest, operationIndex: number) => Promise<{
+        generationId: string;
+        assetId: string;
+    }>;
+}): Promise<ApplyOutcome>;
 /**
  * The unit ids one op's result names.
  *
@@ -183,8 +220,31 @@ declare const isolateSubject: CapabilityExport;
  * about: the sequence row, provider selection and the CAS save.
  */
 declare const trackObject: CapabilityExport;
+/**
+ * Validate, snapshot, and CAS-write a document the way `set_timeline_document`
+ * does (see its own docstring for why each step is there): validate first so
+ * a document that would not render never reaches the database, snapshot the
+ * state being replaced so the write is undoable, then a CAS write so a
+ * concurrent edit is reported rather than clobbered.
+ */
+export declare function writeTimelineCodeDocument(sequence: TimelineSequence, document: Record<string, unknown>, snapshotName: string): Promise<{
+    written: true;
+    timeline_id: string;
+    errors: string[];
+    warnings: string[];
+} | {
+    written: false;
+    error: string;
+    errors: string[];
+    warnings: string[];
+}>;
+declare const getTimelineCode: CapabilityExport;
+declare const setTimelineCode: CapabilityExport;
+declare const editTimelineCode: CapabilityExport;
+declare const rebakeTimelineCode: CapabilityExport;
+declare const detachTimelineCode: CapabilityExport;
 declare const deleteTimeline: CapabilityExport;
 export declare const TIMELINE_CAPABILITIES: readonly CapabilityExport[];
 export declare const module: CapabilityModule;
-export { listTimelines, createTimeline, getTimeline, listTimelineVersions, getTimelineVersion, createTimelineVersion, restoreTimelineVersion, deleteTimelineVersion, editTimeline, validateTimeline, setTimelineDocument, previewTimelineFrame, compareTimelineFrames, renderTimeline, bakeAudioAnimation, isolateSubject, trackObject, deleteTimeline };
+export { listTimelines, createTimeline, getTimeline, listTimelineVersions, getTimelineVersion, createTimelineVersion, restoreTimelineVersion, deleteTimelineVersion, editTimeline, validateTimeline, setTimelineDocument, previewTimelineFrame, compareTimelineFrames, renderTimeline, bakeAudioAnimation, isolateSubject, trackObject, getTimelineCode, setTimelineCode, editTimelineCode, rebakeTimelineCode, detachTimelineCode, deleteTimeline };
 //# sourceMappingURL=timelines.d.ts.map

package/dist/capabilities/timelines.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timelines.d.ts","sourceRoot":"","sources":["../../src/capabilities/timelines.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"timelines.d.ts","sourceRoot":"","sources":["../../src/capabilities/timelines.ts"],"names":[],"mappings":"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"}