@tangle-network/agent-app 0.45.53 → 0.45.55

package/dist/agent-session-controls-CmlXwp_H.d.ts

@@ -1,384 +0,0 @@
-import * as react from 'react';
-import { ReactNode, RefObject } from 'react';
-import { F as FileMention } from './wire-DOZ-O6hD.js';
-import { Harness } from './harness/index.js';
-import { CatalogModel } from './catalog/index.js';
-
-/**
- * `useFileMentions` — the glue a host passes straight into `AgentComposer`'s
- * `mention` prop (`@tangle-network/sandbox-ui#184`) to wire up `@`-file
- * mentions against `createSandboxFileIndexRoute` (`/chat-routes`).
- *
- * Fetches the index once per session from `indexUrl`, refreshes it in the
- * background whenever the popover opens (a `fetchItems` call) if the cached
- * copy has aged past `refreshAfterMs`, and answers every keystroke from an
- * in-memory fuzzy filter — no per-keystroke network round trip. The returned
- * `refresh()` lets a caller force a re-fetch immediately instead of waiting
- * on `refreshAfterMs` — e.g. right after the agent creates a file mid-session.
- *
- * `MentionItem`/the `mention` prop shape mirror the FROZEN contract from
- * sandbox-ui#184 structurally (no import: `/web-react` stays dependency-free
- * beyond React, and `@tangle-network/sandbox-ui` is an optional peer).
- */
-
-/** Mirrors sandbox-ui#184's `MentionItem` — the atomic pill's payload. For a
- *  file mention, `id` is the workspace-relative path (the pill's stable
- *  identity and the `@<id>` serialization sandbox-ui uses to round-trip
- *  `value`), `label` is the display name, and `detail` carries the full path
- *  for the popover row's secondary line. */
-interface MentionItem {
-    id: string;
-    label: string;
-    detail?: string;
-    kind?: string;
-}
-/** Mirrors sandbox-ui#184's `AgentComposerProps['mention']` shape — plug the
- *  hook's `mention` return value straight into that prop. */
-interface ComposerMentionProp {
-    trigger?: string;
-    fetchItems(query: string): Promise<MentionItem[]>;
-    onMentionsChange?(mentions: MentionItem[]): void;
-    renderItem?(item: MentionItem): ReactNode;
-    emptyText?: string;
-}
-/**
- * Ranks `files` against `query` (case-insensitive), capped to `limit`:
- * name-prefix matches first, then name-substring, then path-substring.
- * Within a tier, shorter names sort first (the more specific match), then
- * alphabetically by path for a stable order. An empty query returns the
- * first `limit` entries unranked — the popover's default list before typing.
- * Pure and dependency-free (no fuzzy-match library) so it's cheap enough to
- * re-run on every keystroke against a 10k-entry index.
- */
-declare function rankFileMentions(files: readonly FileMention[], query: string, limit: number): FileMention[];
-/** Max popover results per query — enough to show a useful spread of matches
- *  without pushing the fuzzy-filtered list past what a popover can usefully
- *  render in one screen. */
-declare const DEFAULT_MENTION_LIMIT = 20;
-/** How long a `ready` index is served before a background refetch — long
- *  enough that a full session's worth of popover opens don't repeatedly hit
- *  the index endpoint, short enough that a stale listing doesn't linger too
- *  far past workspace file changes. Callers who need the index current right
- *  now (e.g. just after the agent creates a file) call `refresh()` instead of
- *  waiting on this window. */
-declare const INDEX_REFRESH_AFTER_MS: number;
-/** Popover empty-state copy for a `ready` index whose query matched nothing.
- *  Loading/warming/error states have their own copy — see `emptyTextFor`. */
-declare const DEFAULT_MENTION_EMPTY_TEXT = "No matching files";
-/** Define options for configuring file mention fetching, caching, and display behavior */
-interface UseFileMentionsOptions {
-    /** GET endpoint returning `FileIndexResponse` (a `createSandboxFileIndexRoute`). */
-    indexUrl: string;
-    /** Max popover results per query. Default {@link DEFAULT_MENTION_LIMIT}. */
-    limit?: number;
-    /** How long a `ready` index is served without a background refetch.
-     *  Default {@link INDEX_REFRESH_AFTER_MS}. */
-    refreshAfterMs?: number;
-    /** `fetch` override for tests / non-global-fetch hosts. Default `fetch`. */
-    fetchImpl?: typeof fetch;
-    /** Text shown in the popover's empty state once the index is loaded and
-     *  the query matched nothing. Default {@link DEFAULT_MENTION_EMPTY_TEXT}. */
-    emptyText?: string;
-}
-/** Provide properties and methods to manage and refresh file mentions in a composer interface */
-interface UseFileMentionsResult {
-    /** Spread straight into `AgentComposer`'s `mention` prop. */
-    mention: ComposerMentionProp;
-    /** The files currently referenced by mentions in the composer's value —
-     *  the send-body list (map through `fileMentionsToParts`). */
-    mentions: FileMention[];
-    /** Drop all currently-referenced mentions (e.g. after a successful send). */
-    clearMentions: () => void;
-    /** Force a re-fetch of the index right now, ignoring `refreshAfterMs` — for
-     *  example right after the agent creates a file mid-session, so the next
-     *  popover open sees it. Dedupes against an already-in-flight load rather
-     *  than firing a second request. */
-    refresh: () => Promise<void>;
-}
-/** Resolve and manage file mention data with configurable fetching and state handling */
-declare function useFileMentions(options: UseFileMentionsOptions): UseFileMentionsResult;
-
-/**
- * Keyboard + pointer model for a trigger-and-popover pair, dependency-free.
- * Outside-mousedown and Escape both close; Escape also returns focus to the
- * trigger so keyboard users aren't dropped at the top of the document. The
- * returned `triggerProps` carry the ARIA contract (`aria-haspopup`/
- * `aria-expanded`); spread them onto the trigger button.
- *
- * `panelRef` belongs to the popover panel and MUST be wired when the panel is
- * rendered through {@link PopoverSurface}: a portaled panel is not inside
- * `containerRef`, so a container-only outside test reads every click on the
- * menu's own rows as an outside click and closes before the row's handler runs.
- */
-declare function usePopover(open: boolean, setOpen: (open: boolean) => void): {
-    containerRef: RefObject<HTMLDivElement | null>;
-    triggerRef: RefObject<HTMLButtonElement | null>;
-    panelRef: RefObject<HTMLDivElement | null>;
-    triggerProps: {
-        ref: RefObject<HTMLButtonElement | null>;
-        'aria-haspopup': true;
-        'aria-expanded': boolean;
-    };
-};
-/**
- * Marks the portaled panel in the DOM. Products and audits (see
- * `playground/scripts/popover-hit-test.mjs`) select on this rather than on a
- * Tailwind class, which is presentation and free to change.
- *
- * Its VALUE is the surface's ancestor path (`outer/inner`), which is what
- * restores "is this click inside my popover" after the portal flattens two
- * nested panels into two siblings of `<body>`.
- */
-declare const POPOVER_SURFACE_ATTR = "data-agent-app-popover";
-interface PopoverSurfaceProps {
-    open: boolean;
-    /** The trigger the panel anchors to — `usePopover`'s `triggerRef`. */
-    triggerRef: RefObject<HTMLElement | null>;
-    /** `usePopover`'s `panelRef`; also what the outside-click test consults. */
-    panelRef: RefObject<HTMLDivElement | null>;
-    /** Presentation classes. Placement and elevation are owned here — a caller
-     *  must not pass `absolute`/`fixed`/`top-*`/`bottom-*`/`z-*`. */
-    className?: string;
-    role?: string;
-    id?: string;
-    /** Make the panel at least as wide as its trigger. A portaled panel has no
-     *  `w-full` to inherit — the trigger is no longer its offset parent — so a
-     *  menu that used to stretch to a full-width trigger declares it here. */
-    matchTriggerWidth?: boolean;
-    children: ReactNode;
-}
-/**
- * The floating panel every canonical picker opens.
- *
- * It renders through a PORTAL to `document.body` and anchors itself to the
- * trigger in viewport coordinates, because an in-place `absolute` panel's
- * visibility is decided by markup this package does not own. Measured in
- * production: the shipped chat composer docks these controls inside a
- * horizontally scrolling rail (`overflow-x-auto`), and a scroll container
- * clips every positioned descendant whose containing block sits inside it —
- * so a correct 420x457 menu with correct coordinates painted zero pixels and
- * could not be clicked. An ancestor `transform`/`filter`/`contain` would trap
- * it the same way through the stacking context instead of the clip. Leaving
- * the DOM subtree is the only placement a host cannot re-break.
- *
- * Placement prefers ABOVE the trigger (these controls dock at the bottom of a
- * composer), flips below when there is more room there, clamps horizontally
- * into the viewport, and caps its own height to the space on the chosen side.
- * The panel is `visibility: hidden` for the measure pass so it never paints at
- * the pre-placement origin.
- */
-declare function PopoverSurface({ open, triggerRef, panelRef, className, role, id, matchTriggerWidth, children, }: PopoverSurfaceProps): react.ReactPortal | null;
-/**
- * The one overlay elevation for floating surfaces — picker menus, popovers,
- * drawers, modals. Reads the theme's `--shadow-overlay` token, so every overlay
- * lifts with the same shadow and re-themes from one source. The floating
- * composer uses the quieter `shadow-raised` rung instead.
- *
- * Written as an arbitrary value rather than the preset's `shadow-overlay`
- * utility, because that utility only exists where the preset is part of the
- * Tailwind build. A host that gets its tokens through a precompiled bundle —
- * `@tangle-network/sandbox-ui` ships brand's tokens inlined, with no `@theme`
- * block surviving the compile — receives `--shadow-overlay` as a plain custom
- * property, from which no `shadow-overlay` utility can be generated, and these
- * surfaces render flat. The arbitrary form emits from the class alone and works
- * either way.
- */
-declare const OVERLAY_SHADOW = "shadow-[var(--shadow-overlay)]";
-/**
- * Guard an async action against double-submit. `run` ignores re-entrant calls
- * while a promise is in flight and flips `pending` so the caller can disable
- * the control — the fix for double-charge / double-approve on a slow network.
- * Settles (success or throw) before clearing, and no-ops state updates after
- * unmount.
- */
-declare function usePending(): {
-    pending: boolean;
-    run: (action: () => void | Promise<void>) => void;
-};
-interface ModelPickerProps {
-    value: string;
-    onChange: (id: string) => void;
-    /** Catalogue models — from `GET`ing the app's catalogue route (see
-     *  `runtime/model-catalog`), plus any product-specific entries appended. */
-    models: CatalogModel[];
-    loading?: boolean;
-    /** Render a provider logo/badge; default is a generic sparkle. */
-    renderProviderBadge?: (provider: string) => ReactNode;
-    /** Section label for `featured` models. */
-    recommendedLabel?: string;
-    /** Pin a labeled section to the TOP of the list (above Recommended) for the
-     *  models a product wants surfaced first — e.g. a tuner app's own fine-tuned
-     *  models (`{ label: 'Your Fine-Tuned Models', match: (m) => m.provider === 'tuner' }`).
-     *  Matching models are shown only in this section, not duplicated below. */
-    priorityGroup?: {
-        label: string;
-        match: (model: CatalogModel) => boolean;
-    };
-}
-/**
- * Searchable model picker pill + popover: a featured/recommended section
- * first, then per-provider groups in catalogue order (the server already
- * sorts providers by tier).
- *
- * This is the CANONICAL ecosystem model picker (see "UI chrome ownership
- * (picker canon)" in AGENTS.md). sandbox-ui's `dashboard/ModelPicker` is
- * legacy — deprecated, frozen, removed at sandbox-ui's next major; new code
- * belongs here.
- */
-declare function ModelPicker({ value, onChange, models, loading, renderProviderBadge, recommendedLabel, priorityGroup }: ModelPickerProps): react.JSX.Element;
-/** One reasoning-budget level: the engine `id` is unchanged (the value the
- *  product sends to the loop); only the user-facing `label` is renamed to the
- *  plainer "how hard should it think" vocabulary from docs/product-surfaces.md.
- *  `low`→Quick, `medium`→Standard, `high`→Extended. The mapping is overridable
- *  via `EffortPickerProps.levels`, so a product can relabel without losing the
- *  ids the runtime expects. */
-interface EffortLevel {
-    id: string;
-    label: string;
-}
-declare const DEFAULT_EFFORT_LEVELS: readonly EffortLevel[];
-/**
- * The user-facing label for an engine level id: the canonical vocabulary when
- * the id is one this package names, otherwise the id itself made readable
- * (`auto` -> "Auto", `ultra-code` -> "Ultra code"). Never invents a depth word,
- * so an id nobody declared a label for still reads as ITSELF and never as some
- * other level.
- */
-declare function effortLevelLabel(id: string): string;
-/**
- * Build a levels list from the engine ids a backend applies — the shape the
- * removed `ComposerAgentControls` took as `reasoning.available`, so a product
- * migrating that list has one call to make instead of a hand-written label map
- * per product (which is how "Quick" and "Low" drift apart across surfaces).
- */
-declare function effortLevelsFromIds(ids: readonly string[]): readonly EffortLevel[];
-/**
- * The list {@link EffortPicker} RENDERS for `value` — the declared levels, plus
- * `value` itself when the declaration omits it.
- *
- * A picker cannot honestly resolve a selected value it was not given, and the
- * failure it used to take instead — fall back to the middle entry — renders the
- * session's real depth as a DIFFERENT level's name. That is exactly the defect
- * `levels` was added to prevent: the legacy adapter's `available` list excluded
- * the `auto` sentinel because the old picker injected it, so a product mapping
- * that list straight across ships a session running on `auto` labelled
- * "Extended". Admitting the value is not offering a new choice — it is
- * reporting the state the session is already in, and it disappears from the
- * list as soon as the user picks a declared level.
- *
- * A blank value is not admitted (there is no honest label for it); the picker
- * renders no selection instead.
- */
-declare function reconcileEffortLevels(value: string, levels?: readonly EffortLevel[]): readonly EffortLevel[];
-/** Segments the meter draws — fixed geometry so the ladder stays tabular
- *  across levels (and across the trigger and its menu rows). */
-declare const EFFORT_METER_SEGMENTS = 4;
-/**
- * Filled-segment count for a level: 0 for off/none (or an id the levels list
- * does not carry); otherwise the level's position among the non-off choices
- * scaled onto the meter, so the ladder reads low < medium < high and the top
- * level fills the whole scale. The canonical four levels land 0 / 1 / 2 / 4.
- */
-declare function effortMeterFill(levelId: string, levels?: readonly EffortLevel[]): number;
-/**
- * The thinking-strength meter: four 12px bars, filled count = level, filled
- * opacity ramping 25→100% left to right (unfilled at a faint ghost). Purely
- * decorative — the level name is always rendered as text beside it, so the
- * meter is `aria-hidden` and adds no second accessible name.
- */
-declare function EffortMeter({ fill, className }: {
-    fill: number;
-    className?: string;
-}): react.JSX.Element;
-interface EffortPickerProps {
-    value: string;
-    onChange: (id: string) => void;
-    /** Selectable levels (engine id + user-facing label). Defaults to the plain
-     *  "Thinking" vocabulary; override to relabel without changing the ids the
-     *  runtime receives.
-     *
-     *  A list that omits the current `value` is not a rendering error the picker
-     *  papers over: `value` is reconciled INTO the rendered list under its own
-     *  name (see {@link reconcileEffortLevels}), because a control must report
-     *  the depth the session is running at and never some other list entry. */
-    levels?: readonly EffortLevel[];
-    /** Prefix shown before the active level on the pill — the "what is this"
-     *  context the bare value lacked. Default "Thinking". Pass '' to hide it. */
-    label?: string;
-    /** Fill the container instead of shrink-wrapping — opt-in, default `false`;
-     *  see {@link pickerRootClass} for when and why. */
-    fullWidth?: boolean;
-}
-/** Thinking-budget selector pill, styled to match {@link ModelPicker}. Show
- *  it only when the selected model `supportsReasoning`. "Thinking" is the
- *  plain-English name for what was internally called "effort".
- *
- *  The CANONICAL ecosystem effort picker — sandbox-ui's reasoning menu (inside
- *  its `chat/AgentSessionControls`) is legacy and frozen. */
-declare function EffortPicker({ value, onChange, levels, label, fullWidth }: EffortPickerProps): react.JSX.Element;
-
-interface AgentSessionControlsProps {
-    /** Catalog models — canonical provider-prefixed ids. */
-    models: CatalogModel[];
-    modelsLoading?: boolean;
-    /** Selected canonical model id. */
-    model: string;
-    onModelChange(modelId: string): void;
-    /** Current harness; harness↔model coherence is enforced on every change. */
-    harness: Harness;
-    onHarnessChange(harness: Harness): void;
-    /** Harnesses to offer; defaults to the labeled set. */
-    availableHarnesses?: ReadonlyArray<Harness>;
-    /** Reasoning-effort value + setter. Shown only when the selected model
-     *  `supportsReasoning`, matching `EffortPicker`'s guidance. */
-    effort: string;
-    onEffortChange(effort: string): void;
-    /**
-     * Levels to offer, forwarded verbatim to {@link EffortPicker}. Omit for the
-     * default vocabulary.
-     *
-     * A product whose backend applies only a SUBSET of the levels for the
-     * selected harness/model passes that subset here. Without it the strip
-     * offers every level and the backend silently ignores the ones it does not
-     * apply — a control that reports a choice the system never made.
-     *
-     * This is the COMPLETE renderable set, not an allow-list layered over a
-     * default one — the removed `ComposerAgentControls`' `available` list was the
-     * latter, and its picker injected the `auto` sentinel itself. A list that
-     * omits the current {@link effort} is still safe: `EffortPicker` reconciles
-     * the selected value into the rendered list under its own name rather than
-     * resolving it to a different entry (`reconcileEffortLevels`). Build the list
-     * from engine ids with `effortLevelsFromIds`; the migration is in
-     * `docs/ui-picker-canon.md`.
-     */
-    effortLevels?: readonly EffortLevel[];
-    /**
-     * `inline` (default): model, harness, effort side by side — the prior
-     * behavior. `compact`: model inline, harness + effort behind a gear popover.
-     */
-    layout?: 'inline' | 'compact';
-    /** Hide the harness control entirely (single-harness products). */
-    showHarness?: boolean;
-    /**
-     * PIN the harness and say why, in the user's words ("This thread already has
-     * messages — start a new chat to switch backend"). Presence IS the lock:
-     * there is no separate boolean, because a lock a user cannot read is the
-     * thing this prop exists to replace.
-     *
-     * The control stays VISIBLE and reports the harness the thread is on — the
-     * shape a locked selector has to keep, since a thread whose backend is fixed
-     * is exactly when a user wants to know what it is. Hiding it (`showHarness:
-     * false`) is what pushed products into rendering their own lock label
-     * outside the panel.
-     *
-     * While locked, `onHarnessChange` is never called — not from the picker, and
-     * not from the model↔harness coherence policy either. See
-     * {@link useCoherentHandlers}.
-     */
-    harnessLockReason?: string;
-    renderProviderBadge?: (provider: string) => ReactNode;
-    className?: string;
-}
-declare function AgentSessionControls(props: AgentSessionControlsProps): react.JSX.Element;
-
-export { type AgentSessionControlsProps as A, type ComposerMentionProp as C, DEFAULT_EFFORT_LEVELS as D, EFFORT_METER_SEGMENTS as E, INDEX_REFRESH_AFTER_MS as I, type MentionItem as M, OVERLAY_SHADOW as O, POPOVER_SURFACE_ATTR as P, type UseFileMentionsResult as U, AgentSessionControls as a, DEFAULT_MENTION_EMPTY_TEXT as b, DEFAULT_MENTION_LIMIT as c, type EffortLevel as d, EffortMeter as e, EffortPicker as f, type EffortPickerProps as g, ModelPicker as h, type ModelPickerProps as i, PopoverSurface as j, type PopoverSurfaceProps as k, type UseFileMentionsOptions as l, effortLevelLabel as m, effortLevelsFromIds as n, effortMeterFill as o, reconcileEffortLevels as p, usePending as q, rankFileMentions as r, usePopover as s, useFileMentions as u };

package/dist/apply-6wlMOLf8.d.ts

@@ -1,280 +0,0 @@
-import { c as SequenceTrackKind, d as SequenceExportFormat, e as SequenceTrack, f as SequenceTimeline, T as TimelineClipBounds, g as SequenceClip, h as SequenceExportRecord, i as SequenceMeta, b as SequenceStore } from './store-B7LLlk9p.js';
-
-/**
- * The sequence operation union — the ONE mutation vocabulary shared by every
- * writer of a timeline: the MCP tool dispatcher (agent edits), the React
- * editor's command stack (human edits, undo/redo), and batch agent plans.
- * Positions are integer frames; the seconds→frames conversion happens at the
- * tool-argument edge (./mcp), never here.
- *
- * Validation lives in ./validate (`validateSequenceOperations`) and runs
- * against a `SequenceTimeline` BEFORE any store write; application lives in
- * ./apply (`applySequenceOperation`) which maps one validated operation to
- * `SequenceStore` calls. Keeping the union closed and frame-typed is what lets
- * undo work: every operation has a computable inverse given the pre-state.
- */
-
-/** Define an operation to place a media clip with timing, track, and playback options */
-interface PlaceClipOperation {
-    type: 'place_clip';
-    /** Omitted → first unlocked track matching the media kind. */
-    trackId?: string;
-    label: string;
-    startFrame: number;
-    durationFrames: number;
-    sourceInFrame?: number;
-    /** Explicit source out-point; null/omitted → natural end of the source.
-     *  Carried so the durable inverse of a delete can restore a split clip's
-     *  exact playable window. */
-    sourceOutFrame?: number | null;
-    /** Create the clip disabled; omitted → enabled. Carried so the durable
-     *  inverse of deleting a disabled clip does not resurrect it visible. */
-    disabled?: boolean;
-    media?: {
-        url: string;
-        kind: 'video' | 'image' | 'audio';
-    };
-    generationId?: string;
-    assetId?: string;
-    metadata?: Record<string, unknown>;
-}
-/** Add a caption with optional language, timing, and track placement details */
-interface AddCaptionOperation {
-    type: 'add_caption';
-    text: string;
-    /** BCP-47 tag; omitted → sequence default language. */
-    language?: string;
-    /** Omitted → placed near the playhead via `chooseCaptionPlacement`. */
-    startFrame?: number;
-    durationFrames?: number;
-    /** Target caption track; omitted → first unlocked caption track, creating
-     *  a per-language track when `language` names one that has none. */
-    trackId?: string;
-}
-/** Resolve an operation to move a clip to a new start frame and optional track */
-interface MoveClipOperation {
-    type: 'move_clip';
-    clipId: string;
-    startFrame: number;
-    trackId?: string;
-}
-/** Define an operation to trim a clip by adjusting its start, duration, and optional source in/out points */
-interface TrimClipOperation {
-    type: 'trim_clip';
-    clipId: string;
-    startFrame: number;
-    durationFrames: number;
-    /** New source in-point when trimming the head; omitted → unchanged. */
-    sourceInFrame?: number;
-    /** New source out-point; null releases it to the source's natural end;
-     *  omitted → unchanged. Required when extending a clip whose stored window
-     *  (e.g. a split head's cut point) is too short for the new duration, and
-     *  by the durable inverse of `split_clip` to restore the original window. */
-    sourceOutFrame?: number | null;
-}
-/** Split a clip at a specified frame inside the clip to create two separate segments */
-interface SplitClipOperation {
-    type: 'split_clip';
-    clipId: string;
-    /** Sequence-frame to cut at; must fall strictly inside the clip. */
-    atFrame: number;
-}
-/** Resolve an operation to set clipboard text with optional language and clip identifier */
-interface SetClipTextOperation {
-    type: 'set_clip_text';
-    clipId: string;
-    text: string;
-    language?: string;
-}
-/** Define an operation to enable or disable a clip by its identifier */
-interface SetClipDisabledOperation {
-    type: 'set_clip_disabled';
-    clipId: string;
-    disabled: boolean;
-}
-/** Represent a delete clip operation with a specified clip identifier */
-interface DeleteClipOperation {
-    type: 'delete_clip';
-    clipId: string;
-}
-/** Define an operation to create a new sequence track with a specified kind and name */
-interface CreateTrackOperation {
-    type: 'create_track';
-    kind: SequenceTrackKind;
-    name: string;
-}
-/** Define an operation to extend a sequence by a specified number of frames */
-interface ExtendSequenceOperation {
-    type: 'extend_sequence';
-    durationFrames: number;
-}
-/** Define the structure for a queue export operation with format and optional metadata */
-interface QueueExportOperation {
-    type: 'queue_export';
-    format: SequenceExportFormat;
-    metadata?: Record<string, unknown>;
-}
-/** Represent sequence editing actions for manipulating clips, tracks, captions, and exports */
-type SequenceOperation = PlaceClipOperation | AddCaptionOperation | MoveClipOperation | TrimClipOperation | SplitClipOperation | SetClipTextOperation | SetClipDisabledOperation | DeleteClipOperation | CreateTrackOperation | ExtendSequenceOperation | QueueExportOperation;
-/** A batch of operations with the agent's stated intent — the decision-log
- *  unit for agent edits. */
-interface SequencePlan {
-    summary: string;
-    operations: SequenceOperation[];
-}
-/** Extract the type of operation from a sequence operation object */
-type SequenceOperationType = SequenceOperation['type'];
-/** List all valid sequence operation types used in editing workflows */
-declare const SEQUENCE_OPERATION_TYPES: readonly SequenceOperationType[];
-
-/**
- * Pre-write validation for sequence operations. Every rule runs against a
- * `SequenceTimeline` snapshot BEFORE any `SequenceStore` write, so a rejected
- * plan leaves no partial state. Batch errors carry the shape
- * `operation N (type): reason` — precise enough for an LLM planner to repair
- * the offending operation and resubmit.
- *
- * The resolution helpers (`resolvePlaceClipTrack`, `resolveCaptionTarget`,
- * `resolveCaptionPlacement`) are shared with ./apply so validation and
- * application cannot disagree about which track or bounds an operation lands
- * on.
- *
- * Validation is static: a batch is checked against the timeline as given, so
- * an operation may not reference entities created by an earlier operation in
- * the same batch. Dispatchers that chain operations must refresh the timeline
- * between applications and validate per-operation.
- */
-
-/** Editor/agent context an operation is resolved against. `playheadFrame` is
- *  the implicit position for omitted caption placement; never persisted. */
-interface SequenceOperationContext {
-    playheadFrame: number;
-}
-/** Validate each operation in a sequence against the timeline and context, throwing detailed errors on failure */
-declare function validateSequenceOperations(timeline: SequenceTimeline, operations: SequenceOperation[], ctx: SequenceOperationContext): void;
-/** Validate a sequence operation against the timeline and context to ensure correctness */
-declare function validateSequenceOperation(timeline: SequenceTimeline, operation: SequenceOperation, ctx: SequenceOperationContext): void;
-/** Validate the properties and constraints of a PlaceClipOperation within a SequenceTimeline */
-declare function validatePlaceClip(timeline: SequenceTimeline, operation: PlaceClipOperation): void;
-/** Validate the parameters and context of an AddCaptionOperation within a sequence timeline */
-declare function validateAddCaption(timeline: SequenceTimeline, operation: AddCaptionOperation, ctx: SequenceOperationContext): void;
-/** Validate that a clip move operation is within bounds and targets a compatible unlocked track */
-declare function validateMoveClip(timeline: SequenceTimeline, operation: MoveClipOperation): void;
-/** Validate that a trim clip operation respects timeline bounds and source frame constraints */
-declare function validateTrimClip(timeline: SequenceTimeline, operation: TrimClipOperation): void;
-/** Validate that a split operation on a clip is within valid frame boundaries and conditions */
-declare function validateSplitClip(timeline: SequenceTimeline, operation: SplitClipOperation): void;
-/** Validate that a SetClipTextOperation targets a caption clip with non-empty text and valid language tag */
-declare function validateSetClipText(timeline: SequenceTimeline, operation: SetClipTextOperation): void;
-/** Validate that the clip can be disabled within the given timeline and operation constraints */
-declare function validateSetClipDisabled(timeline: SequenceTimeline, operation: SetClipDisabledOperation): void;
-/** Validate that the clip to delete exists and is mutable in the given timeline */
-declare function validateDeleteClip(timeline: SequenceTimeline, operation: DeleteClipOperation): void;
-/** Validate that a CreateTrackOperation has a supported kind and a non-empty name */
-declare function validateCreateTrack(operation: CreateTrackOperation): void;
-/** Validate that the extend sequence operation has a positive duration and exceeds the last clip end frame */
-declare function validateExtendSequence(timeline: SequenceTimeline, operation: ExtendSequenceOperation): void;
-/** Validate that the queue export operation uses a supported export format */
-declare function validateQueueExport(operation: QueueExportOperation): void;
-/**
- * Shape-gate untrusted JSON (a product's `onApplyOperations` route body) into
- * `SequenceOperation[]` BEFORE `validateSequenceOperations` sees it. The
- * validator assumes well-typed fields (`label.trim()` on a number is a raw
- * TypeError → 500); this parser turns junk into a thrown Error naming the
- * operation index and field so the route can answer 400 with an actionable
- * reason. Unknown fields are dropped — only vocabulary fields reach the
- * validator and store.
- */
-declare function parseSequenceOperations(input: unknown): SequenceOperation[];
-/** Resolve caption target by specifying an existing track or creating a new one with language and name */
-type CaptionTargetResolution = {
-    kind: 'existing';
-    track: SequenceTrack;
-} | {
-    kind: 'create';
-    language: string;
-    name: string;
-};
-/** Naming convention for auto-created per-language caption tracks. The name
- *  doubles as the recognition rule because `SequenceStore.createTrack` cannot
- *  persist track metadata — matching by `metadata.language` alone would never
- *  find tracks this module created. */
-declare function captionTrackNameForLanguage(language: string): string;
-/** Target track for a `place_clip`. Video and image media land on video
- *  tracks, audio media on audio tracks; a `reference` track is valid only when
- *  targeted explicitly. Media-less clips (placeholders, agent markers) need an
- *  explicit trackId because no kind can be inferred. */
-declare function resolvePlaceClipTrack(timeline: SequenceTimeline, operation: PlaceClipOperation): SequenceTrack;
-/** Target caption track for an `add_caption`. With `language` set and no
- *  matching caption track, resolution returns a `create` instruction the apply
- *  layer turns into a real track — a locked matching track is an error, never
- *  a silent duplicate. */
-declare function resolveCaptionTarget(timeline: SequenceTimeline, operation: AddCaptionOperation): CaptionTargetResolution;
-/** Caption bounds. Fully omitted placement slides past occupied intervals via
- *  `chooseCaptionPlacement`; a partially explicit placement fills the missing
- *  half deterministically (startFrame ← playhead, durationFrames ← fps*3) and
- *  must pass the caller's bounds check — no collision slide. */
-declare function resolveCaptionPlacement(timeline: SequenceTimeline, operation: AddCaptionOperation, ctx: SequenceOperationContext, targetTrackId: string | null): TimelineClipBounds;
-/** Last occupied frame across all clips — the floor for `extend_sequence`. */
-declare function lastClipEndFrame(timeline: SequenceTimeline): number;
-/** Media references must be provider URLs or app-served paths. Local sandbox
- *  artifacts (file:, data:, /tmp/, /home/) are rejected because they are
- *  unreachable from the product and signal an agent substituting local ffmpeg
- *  output for real provider generation. Delegates to the canonical
- *  `assertMediaUrl` boundary in `../web` — sequences and design-canvas share ONE
- *  rule so the two surfaces cannot drift on what counts as a reachable url. */
-declare function assertSequenceMediaUrl(url: string): void;
-
-/**
- * Maps one validated `SequenceOperation` to `SequenceStore` calls and reports
- * what changed. Each call re-validates its single operation against the
- * provided timeline — a dispatcher that skips batch validation still cannot
- * reach the store with an invalid write. The timeline must be the CURRENT
- * state: dispatchers applying a batch refresh it between operations so later
- * operations can reference entities earlier ones created.
- *
- * Split assumes source frames advance 1:1 with sequence frames (the model
- * addresses source in/out points at sequence fps); time-remapped clips are
- * outside this operation vocabulary.
- */
-
-/**
- * The entity an operation changed, for the MCP layer to serialize back to the
- * agent. Conventions for multi-entity operations:
- * - `split_clip` returns the newly created second half (the first half is the
- *   original clip id with a shortened duration).
- * - `delete_clip` returns the pre-delete clip snapshot.
- */
-type SequenceApplyResult = {
-    kind: 'clip';
-    clip: SequenceClip;
-} | {
-    kind: 'track';
-    track: SequenceTrack;
-} | {
-    kind: 'export';
-    record: SequenceExportRecord;
-} | {
-    kind: 'sequence';
-    sequence: SequenceMeta;
-};
-/**
- * The batch path every dispatcher (the MCP tools, a product's editor
- * persistence route) funnels through: fetch the timeline, validate the WHOLE
- * batch against pre-state, then apply in order with a timeline refresh between
- * operations — later operations must see earlier writes (the static-validation
- * boundary in ./validate).
- *
- * Atomicity contract: validation throws (before the first store write) leave
- * the sequence untouched. Store-layer throws after at least one successful
- * write leave a prefix-committed state — operations 1..N-1 are persisted,
- * operations N..end are not. The store is non-transactional (SQLite D1);
- * callers that receive a partial-commit throw must treat the result as partial
- * success, not a full rollback. Decision-log rows are the caller's job: the
- * MCP layer records `agent_edit`, an editor route records `human_edit`.
- */
-declare function applySequenceOperations(store: SequenceStore, operations: SequenceOperation[], ctx: SequenceOperationContext): Promise<SequenceApplyResult[]>;
-/** Apply a sequence operation to update the store and timeline asynchronously */
-declare function applySequenceOperation(store: SequenceStore, timeline: SequenceTimeline, op: SequenceOperation, ctx: SequenceOperationContext): Promise<SequenceApplyResult>;
-
-export { type AddCaptionOperation as A, validateSequenceOperations as B, type CaptionTargetResolution as C, type DeleteClipOperation as D, type ExtendSequenceOperation as E, validateSetClipDisabled as F, validateSetClipText as G, validateSplitClip as H, validateTrimClip as I, type MoveClipOperation as M, type PlaceClipOperation as P, type QueueExportOperation as Q, SEQUENCE_OPERATION_TYPES as S, type TrimClipOperation as T, type CreateTrackOperation as a, type SequenceApplyResult as b, type SequenceOperation as c, type SequenceOperationContext as d, type SequenceOperationType as e, type SequencePlan as f, type SetClipDisabledOperation as g, type SetClipTextOperation as h, type SplitClipOperation as i, applySequenceOperation as j, applySequenceOperations as k, assertSequenceMediaUrl as l, captionTrackNameForLanguage as m, lastClipEndFrame as n, resolveCaptionTarget as o, parseSequenceOperations as p, resolvePlaceClipTrack as q, resolveCaptionPlacement as r, validateCreateTrack as s, validateDeleteClip as t, validateExtendSequence as u, validateAddCaption as v, validateMoveClip as w, validatePlaceClip as x, validateQueueExport as y, validateSequenceOperation as z };