@mengine/medeo-tool 1.0.1-alpha.0 → 1.2.1-alpha.0

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { JournalEntry, MengineDocSession, PartIdFactory, SemanticOpName, VideoDocument, fromVideoDocument } from "@mengine/medeo-client";
-import { AddSpeechesInput, AddVideoClipsInput, AdjustBgmVolumeInput, AdjustSpeechVolumeInput, AdjustVideoClipDurationInput, AdjustVideoClipVolumeInput, ChangeSpeechScriptInput, ChangeSpeechVoiceInput, DeleteBgmInput, DeleteSpeechesInput, DeleteVideoClipsInput, MoveSpeechesInput, MoveVideoClipsInput, ReplaceVideoClipContentInput, SetBgmInput, SetCaptionStyleInput, SetCaptionVisibilityInput, SetVideoClipSpeedShiftInput } from "@mengine/medeo-client/schemas";
+import { JournalEntry, MengineDocSession, PartIdFactory, SemanticOpName, VideoDocument, VideoDraft, fromVideoDocument } from "@mengine/medeo-client";
+import { AddSpeechesInput, AddVideoClipsInput, AdjustBgmVolumeInput, AdjustSpeechVolumeInput, AdjustVideoClipDurationInput, AdjustVideoClipVolumeInput, ChangeSpeechScriptInput, ChangeSpeechVoiceInput, DeleteBgmInput, DeleteSpeechesInput, DeleteVideoClipsInput, MoveSpeechesInput, MoveVideoClipsByAnchorInput, MoveVideoClipsInput, ReplaceVideoClipContentInput, ReplaceVideoClipSequenceInput, SetBgmInput, SetCaptionStyleInput, SetCaptionVisibilityInput, SetVideoClipSpeedShiftInput } from "@mengine/medeo-client/schemas";
 
 //#region src/document/compact-projection.d.ts
 /**
@@ -123,8 +123,10 @@ interface EditFacade {
   deleteSpeeches: (input: DeleteSpeechesInput) => Promise<void>;
   deleteVideoClips: (input: DeleteVideoClipsInput) => Promise<void>;
   moveSpeeches: (input: MoveSpeechesInput) => Promise<void>;
+  moveVideoClipsByAnchor: (input: MoveVideoClipsByAnchorInput) => Promise<void>;
   moveVideoClips: (input: MoveVideoClipsInput) => Promise<void>;
   replaceVideoClipContent: (input: ReplaceVideoClipContentInput) => Promise<void>;
+  replaceVideoClipSequence: (input: ReplaceVideoClipSequenceInput) => Promise<void>;
   setBgm: (input: SetBgmInput) => Promise<void>;
   setCaptionStyle: (input: SetCaptionStyleInput) => Promise<void>;
   setCaptionVisibility: (input: SetCaptionVisibilityInput) => Promise<void>;
@@ -365,6 +367,13 @@ interface CreateMedeoToolOptions {
   userId?: ContextualValue<string>;
   /** Stable agent peer id. Supply a host-scoped value so audit provenance is durable. */
   peerId?: ContextualValue<string>;
+  /**
+   * Load the authoritative legacy draft used to create a missing Mengine
+   * document. The tool owns the get-or-create flow: it first probes Mengine,
+   * converts this draft into a VideoDocument only on a 404, bootstraps the
+   * snapshot, and tolerates a concurrent creator winning the race.
+   */
+  loadInitialDraft?: (docId: string) => Promise<VideoDraft>;
   fetchImpl?: typeof fetch;
   sseReconnectDelayMs?: number;
   /** Defaults passed to runEditScript; each call may override them. */
@@ -374,6 +383,20 @@ interface CreateMedeoToolOptions {
   };
   /** Maximum cached plans; oldest plans are evicted (default 16). */
   maxPlans?: number;
+  /** Maximum model-call version baselines retained across host contexts (default 128). */
+  maxModelContexts?: number;
+}
+interface MedeoModelContextInput {
+  /** Internal MEngine document id. This is host-supplied and never model-facing. */
+  doc_id: string;
+  /** Stable host conversation/session key used to compare consecutive model calls. */
+  context_id: string;
+}
+interface MedeoModelContext {
+  /** Complete MEngine-owned prompt: workflow, runtime state, and sandbox TypeScript interface. */
+  prompt: string;
+  document_version: string;
+  updated_since_previous_model_call: boolean | null;
 }
 type MedeoToolInput = {
   op: 'snapshot';
@@ -441,17 +464,20 @@ interface MedeoTool {
   name: typeof MEDEO_TOOL_NAME;
   description: typeof MEDEO_TOOL_DESCRIPTION;
   parameters: typeof MEDEO_TOOL_PARAMETERS;
+  getModelContext(input: MedeoModelContextInput): Promise<MedeoModelContext>;
   handle(input: unknown): Promise<MedeoToolResult>;
   close(): Promise<void>;
 }
+type MedeoInitialDraft = VideoDraft;
 /**
  * Create the self-contained Medeo LLM tool.
  *
  * The package owns session construction, compact projection, sandbox execution,
- * plan caching, commit, and shutdown. The host supplies only environment facts:
- * HTTP origin, credentials, fetch implementation, and a stable peer id.
+ * plan caching, commit, document get-or-create, and shutdown. The host supplies
+ * environment facts plus the authoritative legacy draft loader used only when
+ * Mengine has no document yet.
  */
 declare function createMedeoTool(options: CreateMedeoToolOptions): MedeoTool;
 //#endregion
-export { type ChangePlan, type CommitPlan, type CommitPlanOptions, type CommitPlanResult, type CompactProjectionOptions, type ConsoleShim, type CreateMedeoToolOptions, type EditFacade, EditSandboxSession, type EditSandboxSessionOptions, type EditScriptResult, MEDEO_TOOL_DESCRIPTION, MEDEO_TOOL_NAME, MEDEO_TOOL_PARAMETERS, type MedeoTool, type MedeoToolInput, type MedeoToolOp, type MedeoToolResult, type RunEditScriptOptions, type SandboxCheckpoint, type TimelineClipDescriptor, type TimelineFacade, type TimelinePartDescriptor, collectAffectedPartIds, commitPlan, createMedeoTool, renderCompactProjection, renderPreview, runEditScript };
+export { type ChangePlan, type CommitPlan, type CommitPlanOptions, type CommitPlanResult, type CompactProjectionOptions, type ConsoleShim, type CreateMedeoToolOptions, type EditFacade, EditSandboxSession, type EditSandboxSessionOptions, type EditScriptResult, MEDEO_TOOL_DESCRIPTION, MEDEO_TOOL_NAME, MEDEO_TOOL_PARAMETERS, type MedeoInitialDraft, type MedeoModelContext, type MedeoModelContextInput, type MedeoTool, type MedeoToolInput, type MedeoToolOp, type MedeoToolResult, type RunEditScriptOptions, type SandboxCheckpoint, type TimelineClipDescriptor, type TimelineFacade, type TimelinePartDescriptor, collectAffectedPartIds, commitPlan, createMedeoTool, renderCompactProjection, renderPreview, runEditScript };
 //# sourceMappingURL=index.d.mts.map