@mindstudio-ai/agent 0.1.138 → 0.1.140

package/dist/index.d.ts

@@ -1966,7 +1966,7 @@ interface JewelGradeContext<I> {
     proposed: I | null;
     actual: I;
 }
-type MaybePromise$1<T> = T | Promise<T>;
+type MaybePromise$2<T> = T | Promise<T>;
 /**
  * Authoring config. Declare `subject` before `propose` — the subject type
  * is inferred from the projection's return and flows into `propose`'s
@@ -1983,7 +1983,7 @@ interface JewelConfig<M extends JewelMethod, S> {
      * for context, model calls via runTask). Throwing never propagates — it
      * becomes an `error` on the pair record.
      */
-    propose: (subject: NoInfer<S>) => MaybePromise$1<JewelProposal<JewelMethodInput<M>>>;
+    propose: (subject: NoInfer<S>) => MaybePromise$2<JewelProposal<JewelMethodInput<M>>>;
     /**
      * The custom assertion. Omit for deep-equal on the method input. May be
      * async and call models. Throwing softens to verdict `'skip'`.
@@ -2000,7 +2000,7 @@ interface JewelConfig<M extends JewelMethod, S> {
      * }
      * ```
      */
-    grade?: (ctx: JewelGradeContext<JewelMethodInput<M>>) => MaybePromise$1<JewelVerdict>;
+    grade?: (ctx: JewelGradeContext<JewelMethodInput<M>>) => MaybePromise$2<JewelVerdict>;
 }
 /**
  * Executor params — constructed by the platform (or dev tooling), exactly
@@ -2077,8 +2077,8 @@ interface Jewel<M extends JewelMethod, S> {
     readonly kind: 'jewel';
     readonly method: M;
     readonly subject: (input: JewelMethodInput<M>) => S;
-    readonly propose: (subject: S) => MaybePromise$1<JewelProposal<JewelMethodInput<M>>>;
-    readonly grade: ((ctx: JewelGradeContext<JewelMethodInput<M>>) => MaybePromise$1<JewelVerdict>) | undefined;
+    readonly propose: (subject: S) => MaybePromise$2<JewelProposal<JewelMethodInput<M>>>;
+    readonly grade: ((ctx: JewelGradeContext<JewelMethodInput<M>>) => MaybePromise$2<JewelVerdict>) | undefined;
 }
 /**
  * What the platform did with a proposal, routed by the method's autonomy:
@@ -2297,6 +2297,14 @@ interface SearchFilter {
     filename?: string | string[];
     /** Restrict to specific documents (ids from {@link DataSource.documents}). */
     documentIds?: string[];
+    /**
+     * Passages about any of these entities: the ids their documents assert
+     * ({@link AddOptions.entities}) or their text mentions by a name in the
+     * source's dictionary ({@link DataSource.pushDictionary}). Up to 256; the
+     * usual shape is a neighbourhood your own tables walked out to, then
+     * searched.
+     */
+    entities?: string[];
     /** Page range, inclusive — for paged formats like PDF. */
     pages?: {
         min?: number;
@@ -2324,6 +2332,21 @@ interface SearchExplain {
     lexical: BranchPosition | null;
     matchedVia: 'dense' | 'lexical' | 'both';
 }
+/** One passage of a listing ({@link DataSource.passages}): a search hit without the ranking. */
+interface DataSourcePassage {
+    /** The chunk, prefixed with its heading path for context. */
+    text: string;
+    /** The ids the passage carries: its document's, and those its text names from the dictionary. */
+    entities: string[];
+    citation: Citation;
+}
+/** A page of {@link DataSource.passages}. */
+interface DataSourcePassagePage {
+    passages: DataSourcePassage[];
+    /** Pass back for the next page; null after the last. */
+    nextCursor: string | null;
+    latencyMs: number;
+}
 interface SearchHit {
     /**
      * Relevance of this hit. Comparable within a response, not across them —
@@ -2338,6 +2361,13 @@ interface SearchHit {
     score: number;
     /** The matched chunk, prefixed with its heading path for context. */
     text: string;
+    /**
+     * The entities this passage carries (its document's asserted ids, and the
+     * ids its text names from the source's dictionary), so you can widen from
+     * what you found: walk your own tables out from them, then search again
+     * with {@link SearchFilter.entities}. Empty when none.
+     */
+    entities: string[];
     citation: Citation;
     /**
      * Where retrieval put this hit BEFORE reranking, and what it scored.
@@ -2502,6 +2532,17 @@ interface AddOptions {
      * re-processing; supplying metadata replaces the whole object.
      */
     metadata?: DocumentMetadata;
+    /**
+     * The things this document is about, as your own ids (a tag number, a row
+     * id): up to 256, each 1–128 printable ASCII characters without whitespace
+     * or commas. Every passage of the document carries them, so
+     * {@link SearchFilter.entities} finds passages about an entity and
+     * {@link DataSource.entities} counts them. Metadata is facts about the
+     * document to filter by; entities are what its passages are about.
+     * Re-adding the same bytes with different entities updates them in place;
+     * supplying them replaces the whole set, and `[]` clears it.
+     */
+    entities?: string[];
 }
 /** What {@link DataSource.add} returns. */
 interface AddResult {
@@ -2531,6 +2572,8 @@ interface DataSourceDocument {
     pageCount: number | null;
     /** Tags set at add time. See {@link AddOptions.metadata}. */
     metadata: DocumentMetadata | null;
+    /** Entities the document asserts, sorted. See {@link AddOptions.entities}. */
+    entities: string[];
     createdAt: string;
     ingestedAt: string | null;
 }
@@ -2558,6 +2601,8 @@ interface DataSourceChunk {
         bottomRightX: number;
         bottomRightY: number;
     };
+    /** The entities this chunk carries, as search hits report them. */
+    entities: string[];
     /** base64 of a Float32Array. Only when `vectors: true` was passed. */
     vector?: string;
 }
@@ -2646,6 +2691,8 @@ interface DataSourceJobPlan {
         errorShare: number;
         deleteShare: number;
         secondsPerObject: number;
+        /** What the mapper's own model and step calls billed per sampled object. */
+        creditsPerObject?: number;
     } | null;
     projected: {
         documents: number;
@@ -2655,6 +2702,8 @@ interface DataSourceJobPlan {
             embedding: number;
             extraction: number;
             contextual: number;
+            /** Mapped sources: the mapper's own calls over every object, the sample's included. */
+            mapping?: number;
             total: number;
         };
     };
@@ -2671,7 +2720,8 @@ interface DataSourceJobPlan {
 }
 /**
  * A bulk ingestion job — a sync, a corpus load started from the CLI, a remap
- * of a mapped source's raw copies, or a replay of an earlier job's quarantine.
+ * of a mapped source's raw copies, a replay of an earlier job's quarantine, or
+ * a reread of the source's documents by its reader.
  */
 interface DataSourceJob {
     id: string;
@@ -2697,17 +2747,41 @@ interface DataSourceJob {
         type: 'replay';
         fromJobId: string;
         kind: 'skip' | 'error' | null;
+    } | {
+        type: 'reread';
+        unread: boolean;
     };
-    /** Objects the mapper skipped or failed on (mapped sources; zero otherwise). */
+    /**
+     * Objects the mapper skipped or failed on, and documents the reader failed
+     * on; null where the job was read from a list.
+     */
     quarantine: {
         skipped: number;
         errors: number;
-    };
+        readErrors: number;
+    } | null;
     plan: DataSourceJobPlan | null;
     /** The ceiling this job pauses at, in dollars; null when none was set. */
     budgetDollars: number | null;
-    /** Model spend so far at catalog rates — an estimate, not the ledger. */
+    /**
+     * Spend so far: embedding, extraction and contextual at catalog rates, plus
+     * what the mapper's own calls billed. An estimate, not the ledger; the
+     * budget pauses the job on it.
+     */
     estimatedDollars: number;
+    /**
+     * The mapper's and reader's own calls' part of `estimatedDollars`, the
+     * plan's sample included.
+     */
+    mapperDollars?: number;
+    /**
+     * A running job's read stage on a source with a reader: documents read of
+     * those its builds handed the reader. A reread counts its reads in `counts`.
+     */
+    reading?: {
+        documentsRead: number;
+        documentsTotal: number;
+    } | null;
     counts: {
         objectsSeen: number;
         documentsDone: number;
@@ -2724,14 +2798,81 @@ interface DataSourceJob {
     error: string | null;
     /**
      * Why a running job stopped: the owner, the budget, repeated batch
-     * failures, or (mapped sources) a skip share far above the plan's.
+     * failures, (mapped sources) a skip share far above the plan's, or
+     * (sources with a reader) a reader failing on far more documents than it
+     * did at first.
      */
-    pauseReason: 'user' | 'budget' | 'errors' | 'skips' | null;
+    pauseReason: 'user' | 'budget' | 'errors' | 'skips' | 'reader' | null;
     stalled: boolean;
     createdAt: string;
     startedAt: string | null;
     finishedAt: string | null;
 }
+/**
+ * One entry of a source's dictionary: your own id for a thing and the names
+ * it goes by, as your tables have them. A projection of your data, pushed
+ * whole after each load; the platform never reads your database.
+ */
+interface DictionaryEntry {
+    /** An entity id: 1–128 printable ASCII, no whitespace or commas. */
+    id: string;
+    /**
+     * 1–16 names, each up to 256 characters: a tag number, a model name, an
+     * alias. Matched however a tag's separators and case are written, as whole
+     * words; a name needs three letters or digits (two in Chinese, Japanese or
+     * Korean).
+     */
+    names: string[];
+}
+/** A committed dictionary version: what a push reports, and what a source reads back. */
+interface DictionaryReport {
+    version: number;
+    /** The matching rule its names were keyed under, carried from push to push. */
+    linkerVersion: number;
+    entries: number;
+    names: number;
+    /** Names more than one id claims: a passage naming one is tagged with every claimant. */
+    ambiguousNames: number;
+    /**
+     * The names the most ids claim: `name` as you pushed it (one of them, when
+     * several fold alike), `key` as the linker matches it (folded, separators
+     * dropped), and how many ids claim it.
+     */
+    mostClaimed: {
+        key: string;
+        name?: string;
+        ids: number;
+    }[];
+    /**
+     * Names that can't match their own text as written, since a gap in them
+     * doesn't join (`Line 3, Unit 2`): fix these in your source data.
+     */
+    unmatchable: {
+        count: number;
+        examples: string[];
+    };
+    committedAt: string;
+}
+/** What `pushDictionary` returns. */
+interface DictionaryPushResult extends DictionaryReport {
+    /** The dictionary was the one already committed: no new version, no relink. */
+    unchanged: boolean;
+}
+/**
+ * A relink in flight: the source's passages re-tagged against a newer
+ * dictionary version, in place, as a background walk. Searches keep working
+ * throughout; passages not yet reached carry the previous version's ids.
+ */
+interface DictionaryRelink {
+    version: number;
+    lap: number;
+    /** Documents walked this lap, of `total`. */
+    walked: number;
+    total: number;
+    /** Why it's holding, when it is (the source's dedicated capacity is off). */
+    waiting: string | null;
+    error: string | null;
+}
 /**
  * A typed handle to one data source. Lazy — nothing executes until a method is
  * awaited, so it's safe to `defineDataSource()` at module scope and import the
@@ -2830,6 +2971,68 @@ declare class DataSource {
         chunks: number;
         latencyMs: number;
     }>;
+    /**
+     * Which entities the passages matching a filter are about, most first.
+     *
+     * Filter on one entity (`{ entities: ['P-101A'] }`) and the answer is what
+     * appears beside it: a co-mention graph for free. Filter on a date range and
+     * it is who or what was written about then. No filter covers the corpus.
+     * `chunks` is how many matching passages carry each id, not documents: a
+     * long document's passages each count. Approximate counts, ordered most
+     * first; `limit` defaults to 20, at most 1,000. One document's entities:
+     * `{ filter: { documentIds: [id] } }`.
+     *
+     * Shares the search rate limit (300/minute per app), and shows the same
+     * `index_warming` / `index_building` as search while a corpus loads.
+     */
+    entities(options?: {
+        filter?: SearchFilter;
+        limit?: number;
+    }): Promise<{
+        entities: {
+            id: string;
+            chunks: number;
+        }[];
+        latencyMs: number;
+    }>;
+    /**
+     * Push this source's dictionary: every entity id you have and the names it
+     * goes by, replacing the dictionary it had. From then on every passage is
+     * tagged with the ids whose names its text mentions, beside the ones its
+     * document asserts, so `filter.entities` and {@link entities} find a tag
+     * wherever it's written. Passages indexed before are re-tagged in the
+     * background (a relink; see {@link dictionary}), and nothing is
+     * re-embedded.
+     *
+     * Push it whole after each load of the tables it comes from: an unchanged
+     * dictionary commits nothing (`unchanged: true`). Takes an array or any
+     * (async) iterable, and sends it in pages, so a register of a quarter of a
+     * million entries is fine. A repeated id merges its names.
+     */
+    pushDictionary(entries: Iterable<DictionaryEntry> | AsyncIterable<DictionaryEntry>, options?: {
+        linkerVersion?: number;
+    }): Promise<DictionaryPushResult>;
+    /**
+     * The source's current dictionary, or null when none was pushed, and the
+     * relink re-tagging its passages while one runs.
+     */
+    dictionary(): Promise<{
+        dictionary: DictionaryReport | null;
+        relink: DictionaryRelink | null;
+    }>;
+    /**
+     * What the current dictionary finds in a piece of text: each mention, in
+     * order, with the ids it tags. How to check a dictionary before relying on
+     * it. `version` is null when the source has none. Shares the search rate
+     * limit.
+     */
+    link(text: string): Promise<{
+        version: number | null;
+        mentions: {
+            ids: string[];
+            text: string;
+        }[];
+    }>;
     /**
      * Every chunk of one document, exactly as it was indexed.
      *
@@ -2893,6 +3096,38 @@ declare class DataSource {
         limit?: number;
         order?: 'oldest' | 'newest';
     }): Promise<DataSourceDocumentPage>;
+    /**
+     * One page of the passages matching a filter, unranked: every page that
+     * mentions an asset (`{ entities: ['P-1004A'] }`), every passage holding a
+     * phrase, every chunk of some documents. Where {@link search} ranks and
+     * stops at its top results and {@link count} gives a number, this lists
+     * them all. Passages come document by document, each document's in order;
+     * pass `nextCursor` back for the next page, which is null after the last.
+     * `limit` defaults to 50, at most 200.
+     *
+     * Shares the search rate limit (300/minute per app), and shows the same
+     * `index_warming` / `index_building` as search while a corpus loads.
+     */
+    passages(options?: {
+        filter?: SearchFilter;
+        cursor?: string | null;
+        limit?: number;
+    }): Promise<DataSourcePassagePage>;
+    /**
+     * Every passage matching a filter, a page at a time behind the scenes: the
+     * walk over {@link passages}. Each page counts against the search rate
+     * limit, so a large walk belongs in a background task.
+     *
+     * ```ts
+     * for await (const passage of Manuals.allPassages({ entities: ['P-1004A'] })) {
+     *   mentions.push({ asset: 'P-1004A', ...passage.citation });
+     * }
+     * ```
+     */
+    allPassages(filter?: SearchFilter, options?: {
+        /** Passages per page, at most 200 (the default). */
+        pageSize?: number;
+    }): AsyncGenerator<DataSourcePassage, void, undefined>;
     /**
      * Every document in the corpus, oldest first, a page at a time behind the
      * scenes. This is how an app builds its own view of a large corpus (a
@@ -11423,8 +11658,9 @@ declare function runWithContext<T>(ctx: RequestContext, fn: () => T | Promise<T>
  * One object in, one of four outcomes out:
  * - `documents([...])` — the object becomes these documents (an array is
  *   one object → many). Each is `{ externalId, title, markdown, metadata?,
- *   replaces? }`; `externalId` is the identity the platform replaces by.
- * - `passthrough({ metadata? })` — ingest the raw object itself through
+ *   entities?, replaces? }`; `externalId` is the identity the platform
+ *   replaces by.
+ * - `passthrough({ metadata?, entities? })` — ingest the raw object itself through
  *   built-in extraction, as an unmapped source would. What lets a mapped
  *   source still accept a PDF.
  * - `skip(reason)` — not a document. Quarantined on the job with the reason;
@@ -11466,6 +11702,8 @@ interface MapObject {
     lastModified: string | null;
     /** Metadata the origin supplied (a manifest line's `metadata`), or null. */
     metadata: DocumentMetadata | null;
+    /** Entities the origin supplied (a manifest line's, an `add()`'s), or null. */
+    entities: string[] | null;
     bytes(): Promise<Uint8Array>;
     text(): Promise<string>;
     json<T = unknown>(): Promise<T>;
@@ -11483,6 +11721,12 @@ interface MappedDocument {
     markdown: string;
     /** Scalars only, up to 16 keys — see `AddOptions.metadata`. */
     metadata?: DocumentMetadata;
+    /**
+     * What the document is about, as your own ids — see `AddOptions.entities`.
+     * A record that names its subject (a work order's asset, a story's people)
+     * says so here, whether or not its text does.
+     */
+    entities?: string[];
     /** External ids this document replaces (a writethru's original id). */
     replaces?: string | string[];
 }
@@ -11492,6 +11736,7 @@ type MapOutcome = {
 } | {
     kind: 'passthrough';
     metadata?: DocumentMetadata;
+    entities?: string[];
 } | {
     kind: 'skip';
     reason: string;
@@ -11499,10 +11744,10 @@ type MapOutcome = {
     kind: 'deletes';
     externalIds: string[];
 };
-type MaybePromise<T> = T | Promise<T>;
+type MaybePromise$1<T> = T | Promise<T>;
 interface MapperConfig {
     /** One raw object in; an outcome out. Throwing is the object's `error` outcome. */
-    map: (object: MapObject) => MaybePromise<MapOutcome>;
+    map: (object: MapObject) => MaybePromise$1<MapOutcome>;
 }
 /** One object as the platform hands it to the executor: metadata plus a read URL. */
 interface MapRunObject {
@@ -11512,6 +11757,8 @@ interface MapRunObject {
     etag: string | null;
     lastModified: string | null;
     metadata: DocumentMetadata | null;
+    /** Absent from a platform that predates entities. */
+    entities?: string[] | null;
     /** Short-lived read URL for the object's bytes. */
     url: string;
     /**
@@ -11560,9 +11807,13 @@ interface Mapper {
 }
 /** The object becomes these documents. One document may be passed bare. */
 declare function documents(list: MappedDocument | MappedDocument[]): MapOutcome;
-/** Ingest the raw object itself through built-in extraction. */
+/**
+ * Ingest the raw object itself through built-in extraction. `metadata` and
+ * `entities`, when given, replace what the origin supplied.
+ */
 declare function passthrough(options?: {
     metadata?: DocumentMetadata;
+    entities?: string[];
 }): MapOutcome;
 /** Not a document. Quarantined with the reason. */
 declare function skip(reason: string): MapOutcome;
@@ -11576,6 +11827,176 @@ declare function defineMapper(source: {
     readonly name: string;
 }, config: MapperConfig): Mapper;
 
+/**
+ * Readers — customer code run over every document a data source builds.
+ *
+ * A mapper is app code on the way in (a raw object becomes documents) and
+ * must be pure. A READER is app code on the way out: once a document is
+ * built, its reader reads it and writes what it found into the app's own
+ * tables. Writing is its purpose. It is how an app discovers what its
+ * documents say: which equipment a passage names, what relations it states,
+ * which people it quotes, as the app's own domain defines them.
+ *
+ * ```ts
+ * // datasources/manuals.reader.ts
+ * export default defineReader(Manuals, {
+ *   read: async (document) => {
+ *     const found = await extractRelations(await document.chunks());
+ *     await Evidence.removeAll((r, $) => r.documentId === $.id, { id: document.id });
+ *     await Evidence.push(found.map((f) => ({ ...f, documentId: document.id, sourceId: document.sourceId })));
+ *   },
+ *   removed: async (documentId) => {
+ *     await Evidence.removeAll((r, $) => r.documentId === $.id, { id: documentId });
+ *   },
+ *   cleared: async (sourceId) => {
+ *     await Evidence.removeAll((r, $) => r.sourceId === $.id, { id: sourceId });
+ *   },
+ * });
+ * ```
+ *
+ * The one rule: **a reader may be called more than once for the same
+ * document, so it replaces that document's rows as a set, and deletes them on
+ * `removed`.** Deliveries are level-triggered: the platform says only that a
+ * document changed and reads its state when it delivers, so a document built
+ * and removed before its delivery is one `removed`, and the app's rows always
+ * end on what the corpus holds.
+ *
+ * - `read(document)` — a document arrived: its first build on the source's
+ *   active version. Never for index maintenance (a rebuild, a relink, a
+ *   re-vectorize) or an in-place metadata change: the reader is about what the
+ *   text says, and the app already knows what it asserted.
+ * - `removed(documentId)` — the document is gone. Only the id: removal clears
+ *   what named the document.
+ * - `cleared(sourceId)` — the whole source was deleted, once, so the app can
+ *   drop that source's rows in one statement. Optional.
+ * - `relinked(document)` — a document already read was re-tagged by a new
+ *   dictionary: its passages carry different entities, its text is the same.
+ *   For rows derived from the tags. Optional.
+ * A throw fails that delivery; the platform retries it. `document.bytes()`
+ * reads the file the document came from, for a reader that needs the drawing
+ * itself rather than its text.
+ *
+ * A reader runs against the app's LIVE release (or the dev session under
+ * `reader test --dev`), never a pinned one: app databases are per release, so
+ * a reader bound to a superseded release would write where nobody reads. It
+ * is whatever live declares, and activates by publishing.
+ *
+ * Declared in `mindstudio.json`, beside or instead of a mapper:
+ * ```json
+ * "dataSources": [{ "slug": "manuals", "reader": { "path": "dist/datasources/manuals.reader.ts" } }]
+ * ```
+ */
+
+/** A built document, as `read` receives it. */
+interface ReaderDocument {
+    id: string;
+    /** The data source it belongs to: key your rows by it for `cleared`. */
+    sourceId: string;
+    filename: string | null;
+    contentType: string | null;
+    /** The identity a mapped source replaces by; null on unmapped sources. */
+    externalId: string | null;
+    metadata: DocumentMetadata | null;
+    /** The entities the document asserts, sorted. */
+    entities: string[];
+    pageCount: number | null;
+    chunkCount: number | null;
+    createdAt: string;
+    /**
+     * A short-lived link to the file the document came from: the uploaded
+     * file, or on a mapped source the raw object the mapper read. Valid for the
+     * delivery; null when the file is no longer kept.
+     */
+    url: string | null;
+    /**
+     * The document's passages as indexed: text, page, heading path, and each
+     * passage's entities (its document's asserted ones and those its text
+     * names from the source's dictionary). Read once, then held.
+     */
+    chunks(): Promise<DataSourceChunk[]>;
+    /** The bytes behind {@link url}: a drawing's image, a PDF's pages. Read once, then held. */
+    bytes(): Promise<Uint8Array>;
+}
+type MaybePromise<T> = T | Promise<T>;
+interface ReaderConfig {
+    read: (document: ReaderDocument) => MaybePromise<void>;
+    removed: (documentId: string) => MaybePromise<void>;
+    cleared?: (sourceId: string) => MaybePromise<void>;
+    /**
+     * A document already read was re-tagged: the source's dictionary changed,
+     * and its passages' entities with it. The document arrives as `read` gets
+     * it, chunks and all, carrying the new entities, so rows derived from the
+     * tags (links from assets to documents) can follow. Nothing about the text
+     * changed, so this is no reason to extract again. Optional: without it a
+     * relink delivers nothing.
+     */
+    relinked?: (document: ReaderDocument) => MaybePromise<void>;
+}
+type DocumentDelivery = {
+    document: Omit<ReaderDocument, 'chunks' | 'bytes'>;
+    /** The passages, when the platform carried them inline. */
+    chunks?: DataSourceChunk[];
+};
+/** One delivery as the platform hands it to the executor. */
+type ReadDelivery = ({
+    kind: 'read';
+} & DocumentDelivery) | ({
+    kind: 'relinked';
+} & DocumentDelivery) | {
+    kind: 'removed';
+    documentId: string;
+} | {
+    kind: 'cleared';
+    sourceId: string;
+};
+interface ReadRunParams {
+    v: 1;
+    deliveries: ReadDelivery[];
+    /** Per-delivery budget, in milliseconds. */
+    timeoutMs?: number;
+    /** Deliveries run at once inside the frame. */
+    concurrency?: number;
+}
+interface ReadRunResult {
+    /** The document id, or the source id for `cleared`. */
+    ref: string;
+    kind: ReadDelivery['kind'];
+    ok: boolean;
+    error?: {
+        message: string;
+        stack?: string;
+    };
+    durationMs: number;
+}
+/** What one executor call returns: one result per delivery, in order. */
+interface ReadRunRecord {
+    v: 1;
+    source: string;
+    outcomes: ReadRunResult[];
+    /** The optional hooks this reader defines, so the platform sends only what one handles. */
+    hooks: {
+        relinked: boolean;
+    };
+    startedAt: number;
+    durationMs: number;
+}
+/** The callable executor with its config attached. */
+interface Reader {
+    (params: ReadRunParams): Promise<ReadRunRecord>;
+    readonly kind: 'reader';
+    /** The data source's slug. */
+    readonly source: string;
+    readonly config: ReaderConfig;
+}
+/**
+ * Define a reader — the code that reads every document a data source builds
+ * into the app's own tables. See the module doc for the contract.
+ */
+declare function defineReader(source: {
+    readonly name: string;
+    chunks(documentId: string): Promise<DataSourceChunk[]>;
+}, config: ReaderConfig): Reader;
+
 type MonacoSnippetFieldType = 'string' | 'number' | 'boolean' | 'array' | 'object' | string[];
 type MonacoSnippetField = [name: string, type: MonacoSnippetFieldType];
 interface MonacoSnippet {
@@ -11860,4 +12281,4 @@ declare const prerender: {
     }>;
 };
 
-export { type Accessor, type ActiveCampaignAddNoteStepInput, type ActiveCampaignAddNoteStepOutput, type ActiveCampaignCreateContactStepInput, type ActiveCampaignCreateContactStepOutput, type AddSubtitlesToVideoStepInput, type AddSubtitlesToVideoStepOutput, type AgentInfo, type AgentOptions, type AggregateRow, type AggregateSelect, type AggregateTerm, type AiSourceVendor, type AirtableCreateUpdateRecordStepInput, type AirtableCreateUpdateRecordStepOutput, type AirtableDeleteRecordStepInput, type AirtableDeleteRecordStepOutput, type AirtableGetRecordStepInput, type AirtableGetRecordStepOutput, type AirtableGetTableRecordsStepInput, type AirtableGetTableRecordsStepOutput, type Analytics, type AnalyticsDateRange, type AnalyticsDimension, type AnalyticsFilter, type AnalyticsFilterOp, type AnalyticsGranularity, type AnalyticsMetric, type AnalyticsQueryResponse, type AnalyticsQueryResultRow, type AnalyticsQuerySpec, type AnalyticsReadOptions, type AnalyzeImageStepInput, type AnalyzeImageStepOutput, type AnalyzeVideoStepInput, type AnalyzeVideoStepOutput, type AppAuthContext, type AppContextResult, type AppDatabase, type AppDatabaseColumnSchema, type AppDatabaseTable, type AppRoleAssignment, AuthContext, type AuthTableConfig, type BatchStepInput, type BatchStepResult, type Batchable, type CaptureThumbnailStepInput, type CaptureThumbnailStepOutput, type CheckAppRoleStepInput, type CheckAppRoleStepOutput, type CodaCreateUpdatePageStepInput, type CodaCreateUpdatePageStepOutput, type CodaCreateUpdateRowStepInput, type CodaCreateUpdateRowStepOutput, type CodaFindRowStepInput, type CodaFindRowStepOutput, type CodaGetPageStepInput, type CodaGetPageStepOutput, type CodaGetTableRowsStepInput, type CodaGetTableRowsStepOutput, type Connection, type ConnectorActionDetail, type ConnectorService, type ConvertPdfToImagesStepInput, type ConvertPdfToImagesStepOutput, type CrawlerBucket, type CrawlerHit, type CrawlerOverview, type CreateDataSourceStepInput, type CreateDataSourceStepOutput, type CreateGmailDraftStepInput, type CreateGmailDraftStepOutput, type CreateGoogleCalendarEventStepInput, type CreateGoogleCalendarEventStepOutput, type CreateGoogleDocStepInput, type CreateGoogleDocStepOutput, type CreateGoogleSheetStepInput, type CreateGoogleSheetStepOutput, type Db, type DecomposeImageStepInput, type DecomposeImageStepOutput, type DefineStoreOptions, type DefineTableOptions, type DeleteDataSourceDocumentStepInput, type DeleteDataSourceDocumentStepOutput, type DeleteDataSourceStepInput, type DeleteDataSourceStepOutput, type DeleteGmailEmailStepInput, type DeleteGmailEmailStepOutput, type DeleteGoogleCalendarEventStepInput, type DeleteGoogleCalendarEventStepOutput, type DeleteGoogleSheetRowsStepInput, type DeleteGoogleSheetRowsStepOutput, type DetectChangesStepInput, type DetectChangesStepOutput, type DetectPIIStepInput, type DetectPIIStepOutput, type DownloadVideoStepInput, type DownloadVideoStepOutput, type EnhanceImageGenerationPromptStepInput, type EnhanceImageGenerationPromptStepOutput, type EnhanceVideoGenerationPromptStepInput, type EnhanceVideoGenerationPromptStepOutput, type EnrichPersonStepInput, type EnrichPersonStepOutput, type EventGrantOptions, type EventGrantResult, type Events, type ExecuteStepBatchOptions, type ExecuteStepBatchResult, type ExtractAudioFromVideoStepInput, type ExtractAudioFromVideoStepOutput, type ExtractTextStepInput, type ExtractTextStepOutput, type FetchDataSourceDocumentStepInput, type FetchDataSourceDocumentStepOutput, type FetchGoogleDocStepInput, type FetchGoogleDocStepOutput, type FetchGoogleSheetStepInput, type FetchGoogleSheetStepOutput, type FetchSlackChannelHistoryStepInput, type FetchSlackChannelHistoryStepOutput, type FetchYoutubeCaptionsStepInput, type FetchYoutubeCaptionsStepOutput, type FetchYoutubeChannelStepInput, type FetchYoutubeChannelStepOutput, type FetchYoutubeCommentsStepInput, type FetchYoutubeCommentsStepOutput, type FetchYoutubeVideoStepInput, type FetchYoutubeVideoStepOutput, type FileAccess, type Files, type FromSchema, type Generate3dModelStepInput, type Generate3dModelStepOutput, type GenerateAssetStepInput, type GenerateAssetStepOutput, type GenerateImageStepInput, type GenerateImageStepOutput, type GenerateLipsyncStepInput, type GenerateLipsyncStepOutput, type GenerateMusicStepInput, type GenerateMusicStepOutput, type GeneratePdfStepInput, type GeneratePdfStepOutput, type GenerateSoundStepInput, type GenerateSoundStepOutput, type GenerateStaticVideoFromImageStepInput, type GenerateStaticVideoFromImageStepOutput, type GenerateTextStepInput, type GenerateTextStepOutput, type GenerateVideoStepInput, type GenerateVideoStepOutput, type GetGmailAttachmentsStepInput, type GetGmailAttachmentsStepOutput, type GetGmailDraftStepInput, type GetGmailDraftStepOutput, type GetGmailEmailStepInput, type GetGmailEmailStepOutput, type GetGmailUnreadCountStepInput, type GetGmailUnreadCountStepOutput, type GetGoogleCalendarEventStepInput, type GetGoogleCalendarEventStepOutput, type GetGoogleDriveFileStepInput, type GetGoogleDriveFileStepOutput, type GetGoogleSheetInfoStepInput, type GetGoogleSheetInfoStepOutput, type GetMediaMetadataStepInput, type GetMediaMetadataStepOutput, type HubspotCreateCompanyStepInput, type HubspotCreateCompanyStepOutput, type HubspotCreateContactStepInput, type HubspotCreateContactStepOutput, type HubspotGetCompanyStepInput, type HubspotGetCompanyStepOutput, type HubspotGetContactStepInput, type HubspotGetContactStepOutput, type HunterApiCompanyEnrichmentStepInput, type HunterApiCompanyEnrichmentStepOutput, type HunterApiDomainSearchStepInput, type HunterApiDomainSearchStepOutput, type HunterApiEmailFinderStepInput, type HunterApiEmailFinderStepOutput, type HunterApiEmailVerificationStepInput, type HunterApiEmailVerificationStepOutput, type HunterApiPersonEnrichmentStepInput, type HunterApiPersonEnrichmentStepOutput, type ImageFaceSwapStepInput, type ImageFaceSwapStepOutput, type ImageRemoveWatermarkStepInput, type ImageRemoveWatermarkStepOutput, type InsertVideoClipsStepInput, type InsertVideoClipsStepOutput, type Jewel, type JewelConfig, type JewelGradeContext, type JewelMethod, type JewelMethodInput, type JewelPairRecord, type JewelProposal, type JewelProposeOutcome, type JewelProposeResult, type JewelQueueItem, type JewelQueueResolution, type JewelQueueResolveResult, type JewelRunParams, type JewelVerdict, type JewelsApi, type JsonObjectSchema, type JsonSchema, type JsonSchemaTypeName, type ListAgentsResult, type ListDataSourcesStepInput, type ListDataSourcesStepOutput, type ListGmailDraftsStepInput, type ListGmailDraftsStepOutput, type ListGmailLabelsStepInput, type ListGmailLabelsStepOutput, type ListGoogleCalendarEventsStepInput, type ListGoogleCalendarEventsStepOutput, type ListGoogleDriveFilesStepInput, type ListGoogleDriveFilesStepOutput, type ListOptions, type ListRecentGmailEmailsStepInput, type ListRecentGmailEmailsStepOutput, type LiveNow, type LogicStepInput, type LogicStepOutput, MAX_EVENT_PAYLOAD_CHARS, type MakeDotComRunScenarioStepInput, type MakeDotComRunScenarioStepOutput, type MapObject, type MapOutcome, type MapPoint, type MapRunObject, type MapRunOutcome, type MapRunParams, type MapRunRecord, type MapRunResult, type MappedDocument, type Mapper, type MapperConfig, type MergeAudioStepInput, type MergeAudioStepOutput, type MergeVideosStepInput, type MergeVideosStepOutput, type MeshyAnimateStepInput, type MeshyAnimateStepOutput, type MeshyImageTo3dStepInput, type MeshyImageTo3dStepOutput, type MeshyRemeshStepInput, type MeshyRemeshStepOutput, type MeshyRigStepInput, type MeshyRigStepOutput, type MeshyTextTo3dStepInput, type MeshyTextTo3dStepOutput, type MeshyTextureStepInput, type MeshyTextureStepOutput, MindStudioAgent, MindStudioError, type MindStudioModel, type MindStudioModelSummary, type MixAudioIntoVideoStepInput, type MixAudioIntoVideoStepOutput, type ModelType, type MonacoSnippet, type MonacoSnippetField, type MonacoSnippetFieldType, type MuteVideoStepInput, type MuteVideoStepOutput, type N8nRunNodeStepInput, type N8nRunNodeStepOutput, type NotionCreatePageStepInput, type NotionCreatePageStepOutput, type NotionUpdatePageStepInput, type NotionUpdatePageStepOutput, type PackagedWorkflow, type PackagedWorkflowInput, type PackagedWorkflowSignature, type PeopleSearchStepInput, type PeopleSearchStepOutput, type PostToLinkedInStepInput, type PostToLinkedInStepOutput, type PostToSlackChannelStepInput, type PostToSlackChannelStepOutput, type PostToXStepInput, type PostToXStepOutput, type PostToZapierStepInput, type PostToZapierStepOutput, type Predicate, type PushInput, type PutOptions, Query, type QueryDataSourceStepInput, type QueryDataSourceStepOutput, type QueryExternalDatabaseStepInput, type QueryExternalDatabaseStepOutput, type QuickbooksApiRequestStepInput, type QuickbooksApiRequestStepOutput, RawQuery, type RedactPIIStepInput, type RedactPIIStepOutput, type RemoveBackgroundFromImageStepInput, type RemoveBackgroundFromImageStepOutput, type ReplyToGmailEmailStepInput, type ReplyToGmailEmailStepOutput, type ReportIssueInput, type ReportedIssue, type RequestContext, type ResizeVideoStepInput, type ResizeVideoStepOutput, type ResolvedUser, Roles, type RunAgentOptions, type RunAgentResult, type RunFromConnectorRegistryStepInput, type RunFromConnectorRegistryStepOutput, type RunTaskOptions, type RunTaskOptionsWithExample, type RunTaskOptionsWithSchema, type RunTaskResult, type SchemaValidationError, type ScrapeLinkedInCompanyStepInput, type ScrapeLinkedInCompanyStepOutput, type ScrapeLinkedInProfileStepInput, type ScrapeLinkedInProfileStepOutput, type ScrapeUrlStepInput, type ScrapeUrlStepOutput, type ScrapeXPostStepInput, type ScrapeXPostStepOutput, type ScrapeXProfileStepInput, type ScrapeXProfileStepOutput, type ScreenshotUrlStepInput, type ScreenshotUrlStepOutput, type SearchGmailEmailsStepInput, type SearchGmailEmailsStepOutput, type SearchGoogleCalendarEventsStepInput, type SearchGoogleCalendarEventsStepOutput, type SearchGoogleDriveStepInput, type SearchGoogleDriveStepOutput, type SearchGoogleImagesStepInput, type SearchGoogleImagesStepOutput, type SearchGoogleNewsStepInput, type SearchGoogleNewsStepOutput, type SearchGoogleStepInput, type SearchGoogleStepOutput, type SearchGoogleTrendsStepInput, type SearchGoogleTrendsStepOutput, type SearchPerplexityStepInput, type SearchPerplexityStepOutput, type SearchXPostsStepInput, type SearchXPostsStepOutput, type SearchYoutubeStepInput, type SearchYoutubeStepOutput, type SearchYoutubeTrendsStepInput, type SearchYoutubeTrendsStepOutput, type SendEmailStepInput, type SendEmailStepOutput, type SendGmailDraftStepInput, type SendGmailDraftStepOutput, type SendGmailMessageStepInput, type SendGmailMessageStepOutput, type SendSMSStepInput, type SendSMSStepOutput, type SendSlackDirectMessageStepInput, type SendSlackDirectMessageStepOutput, type SessionContext, type SetGmailReadStatusStepInput, type SetGmailReadStatusStepOutput, type SetRunTitleStepInput, type SetRunTitleStepOutput, type SetVariableStepInput, type SetVariableStepOutput, type StepCostEstimateEntry, type StepExecutionMeta, type StepExecutionOptions, type StepExecutionResult, type StepInputMap, type StepLogEvent, type StepMetadata, type StepMethods, type StepName, type StepOutputMap, Store, type StoredFile, type SystemFields, Table, type TaskEvent, type TaskToolCall, type TaskToolConfig, type TaskUsage, type TextToSpeechStepInput, type TextToSpeechStepOutput, type TopSource, type TranscribeAudioStepInput, type TranscribeAudioStepOutput, type TrimMediaStepInput, type TrimMediaStepOutput, type TypesafeEvaluateStepInput, type TypesafeEvaluateStepOutput, type UpdateGmailLabelsStepInput, type UpdateGmailLabelsStepOutput, type UpdateGoogleCalendarEventStepInput, type UpdateGoogleCalendarEventStepOutput, type UpdateGoogleDocStepInput, type UpdateGoogleDocStepOutput, type UpdateGoogleSheetStepInput, type UpdateGoogleSheetStepOutput, type UpdateInput, type UploadDataSourceDocumentStepInput, type UploadDataSourceDocumentStepOutput, type UploadFileResult, type UploadToken, type UpscaleImageStepInput, type UpscaleImageStepOutput, type UpscaleVideoStepInput, type UpscaleVideoStepOutput, type User, type UserInfoResult, type UserMessageStepInput, type UserMessageStepOutput, type VideoFaceSwapStepInput, type VideoFaceSwapStepOutput, type VideoRemoveBackgroundStepInput, type VideoRemoveBackgroundStepOutput, type VideoRemoveWatermarkStepInput, type VideoRemoveWatermarkStepOutput, type Voice, type VoiceCallResult, type WatermarkImageStepInput, type WatermarkImageStepOutput, type WatermarkVideoStepInput, type WatermarkVideoStepOutput, type YouDotComFinanceResearchStepInput, type YouDotComFinanceResearchStepOutput, type YouDotComGetPageContentStepInput, type YouDotComGetPageContentStepOutput, type YouDotComLiveNewsStepInput, type YouDotComLiveNewsStepOutput, type YouDotComWebResearchStepInput, type YouDotComWebResearchStepOutput, type YouDotComWebSearchStepInput, type YouDotComWebSearchStepOutput, analytics, auth, blockTypeAliases, dataSources, db, mindstudio as default, defineJewel, defineMapper, deletes, documents, email, events, files, getRequestContext, mindstudio, monacoSnippets, passthrough, prerender, reportIssue, resolveUser, runWithContext, session, skip, stepMetadata, stream, voice, waitUntil };
+export { type Accessor, type ActiveCampaignAddNoteStepInput, type ActiveCampaignAddNoteStepOutput, type ActiveCampaignCreateContactStepInput, type ActiveCampaignCreateContactStepOutput, type AddSubtitlesToVideoStepInput, type AddSubtitlesToVideoStepOutput, type AgentInfo, type AgentOptions, type AggregateRow, type AggregateSelect, type AggregateTerm, type AiSourceVendor, type AirtableCreateUpdateRecordStepInput, type AirtableCreateUpdateRecordStepOutput, type AirtableDeleteRecordStepInput, type AirtableDeleteRecordStepOutput, type AirtableGetRecordStepInput, type AirtableGetRecordStepOutput, type AirtableGetTableRecordsStepInput, type AirtableGetTableRecordsStepOutput, type Analytics, type AnalyticsDateRange, type AnalyticsDimension, type AnalyticsFilter, type AnalyticsFilterOp, type AnalyticsGranularity, type AnalyticsMetric, type AnalyticsQueryResponse, type AnalyticsQueryResultRow, type AnalyticsQuerySpec, type AnalyticsReadOptions, type AnalyzeImageStepInput, type AnalyzeImageStepOutput, type AnalyzeVideoStepInput, type AnalyzeVideoStepOutput, type AppAuthContext, type AppContextResult, type AppDatabase, type AppDatabaseColumnSchema, type AppDatabaseTable, type AppRoleAssignment, AuthContext, type AuthTableConfig, type BatchStepInput, type BatchStepResult, type Batchable, type CaptureThumbnailStepInput, type CaptureThumbnailStepOutput, type CheckAppRoleStepInput, type CheckAppRoleStepOutput, type CodaCreateUpdatePageStepInput, type CodaCreateUpdatePageStepOutput, type CodaCreateUpdateRowStepInput, type CodaCreateUpdateRowStepOutput, type CodaFindRowStepInput, type CodaFindRowStepOutput, type CodaGetPageStepInput, type CodaGetPageStepOutput, type CodaGetTableRowsStepInput, type CodaGetTableRowsStepOutput, type Connection, type ConnectorActionDetail, type ConnectorService, type ConvertPdfToImagesStepInput, type ConvertPdfToImagesStepOutput, type CrawlerBucket, type CrawlerHit, type CrawlerOverview, type CreateDataSourceStepInput, type CreateDataSourceStepOutput, type CreateGmailDraftStepInput, type CreateGmailDraftStepOutput, type CreateGoogleCalendarEventStepInput, type CreateGoogleCalendarEventStepOutput, type CreateGoogleDocStepInput, type CreateGoogleDocStepOutput, type CreateGoogleSheetStepInput, type CreateGoogleSheetStepOutput, type Db, type DecomposeImageStepInput, type DecomposeImageStepOutput, type DefineStoreOptions, type DefineTableOptions, type DeleteDataSourceDocumentStepInput, type DeleteDataSourceDocumentStepOutput, type DeleteDataSourceStepInput, type DeleteDataSourceStepOutput, type DeleteGmailEmailStepInput, type DeleteGmailEmailStepOutput, type DeleteGoogleCalendarEventStepInput, type DeleteGoogleCalendarEventStepOutput, type DeleteGoogleSheetRowsStepInput, type DeleteGoogleSheetRowsStepOutput, type DetectChangesStepInput, type DetectChangesStepOutput, type DetectPIIStepInput, type DetectPIIStepOutput, type DownloadVideoStepInput, type DownloadVideoStepOutput, type EnhanceImageGenerationPromptStepInput, type EnhanceImageGenerationPromptStepOutput, type EnhanceVideoGenerationPromptStepInput, type EnhanceVideoGenerationPromptStepOutput, type EnrichPersonStepInput, type EnrichPersonStepOutput, type EventGrantOptions, type EventGrantResult, type Events, type ExecuteStepBatchOptions, type ExecuteStepBatchResult, type ExtractAudioFromVideoStepInput, type ExtractAudioFromVideoStepOutput, type ExtractTextStepInput, type ExtractTextStepOutput, type FetchDataSourceDocumentStepInput, type FetchDataSourceDocumentStepOutput, type FetchGoogleDocStepInput, type FetchGoogleDocStepOutput, type FetchGoogleSheetStepInput, type FetchGoogleSheetStepOutput, type FetchSlackChannelHistoryStepInput, type FetchSlackChannelHistoryStepOutput, type FetchYoutubeCaptionsStepInput, type FetchYoutubeCaptionsStepOutput, type FetchYoutubeChannelStepInput, type FetchYoutubeChannelStepOutput, type FetchYoutubeCommentsStepInput, type FetchYoutubeCommentsStepOutput, type FetchYoutubeVideoStepInput, type FetchYoutubeVideoStepOutput, type FileAccess, type Files, type FromSchema, type Generate3dModelStepInput, type Generate3dModelStepOutput, type GenerateAssetStepInput, type GenerateAssetStepOutput, type GenerateImageStepInput, type GenerateImageStepOutput, type GenerateLipsyncStepInput, type GenerateLipsyncStepOutput, type GenerateMusicStepInput, type GenerateMusicStepOutput, type GeneratePdfStepInput, type GeneratePdfStepOutput, type GenerateSoundStepInput, type GenerateSoundStepOutput, type GenerateStaticVideoFromImageStepInput, type GenerateStaticVideoFromImageStepOutput, type GenerateTextStepInput, type GenerateTextStepOutput, type GenerateVideoStepInput, type GenerateVideoStepOutput, type GetGmailAttachmentsStepInput, type GetGmailAttachmentsStepOutput, type GetGmailDraftStepInput, type GetGmailDraftStepOutput, type GetGmailEmailStepInput, type GetGmailEmailStepOutput, type GetGmailUnreadCountStepInput, type GetGmailUnreadCountStepOutput, type GetGoogleCalendarEventStepInput, type GetGoogleCalendarEventStepOutput, type GetGoogleDriveFileStepInput, type GetGoogleDriveFileStepOutput, type GetGoogleSheetInfoStepInput, type GetGoogleSheetInfoStepOutput, type GetMediaMetadataStepInput, type GetMediaMetadataStepOutput, type HubspotCreateCompanyStepInput, type HubspotCreateCompanyStepOutput, type HubspotCreateContactStepInput, type HubspotCreateContactStepOutput, type HubspotGetCompanyStepInput, type HubspotGetCompanyStepOutput, type HubspotGetContactStepInput, type HubspotGetContactStepOutput, type HunterApiCompanyEnrichmentStepInput, type HunterApiCompanyEnrichmentStepOutput, type HunterApiDomainSearchStepInput, type HunterApiDomainSearchStepOutput, type HunterApiEmailFinderStepInput, type HunterApiEmailFinderStepOutput, type HunterApiEmailVerificationStepInput, type HunterApiEmailVerificationStepOutput, type HunterApiPersonEnrichmentStepInput, type HunterApiPersonEnrichmentStepOutput, type ImageFaceSwapStepInput, type ImageFaceSwapStepOutput, type ImageRemoveWatermarkStepInput, type ImageRemoveWatermarkStepOutput, type InsertVideoClipsStepInput, type InsertVideoClipsStepOutput, type Jewel, type JewelConfig, type JewelGradeContext, type JewelMethod, type JewelMethodInput, type JewelPairRecord, type JewelProposal, type JewelProposeOutcome, type JewelProposeResult, type JewelQueueItem, type JewelQueueResolution, type JewelQueueResolveResult, type JewelRunParams, type JewelVerdict, type JewelsApi, type JsonObjectSchema, type JsonSchema, type JsonSchemaTypeName, type ListAgentsResult, type ListDataSourcesStepInput, type ListDataSourcesStepOutput, type ListGmailDraftsStepInput, type ListGmailDraftsStepOutput, type ListGmailLabelsStepInput, type ListGmailLabelsStepOutput, type ListGoogleCalendarEventsStepInput, type ListGoogleCalendarEventsStepOutput, type ListGoogleDriveFilesStepInput, type ListGoogleDriveFilesStepOutput, type ListOptions, type ListRecentGmailEmailsStepInput, type ListRecentGmailEmailsStepOutput, type LiveNow, type LogicStepInput, type LogicStepOutput, MAX_EVENT_PAYLOAD_CHARS, type MakeDotComRunScenarioStepInput, type MakeDotComRunScenarioStepOutput, type MapObject, type MapOutcome, type MapPoint, type MapRunObject, type MapRunOutcome, type MapRunParams, type MapRunRecord, type MapRunResult, type MappedDocument, type Mapper, type MapperConfig, type MergeAudioStepInput, type MergeAudioStepOutput, type MergeVideosStepInput, type MergeVideosStepOutput, type MeshyAnimateStepInput, type MeshyAnimateStepOutput, type MeshyImageTo3dStepInput, type MeshyImageTo3dStepOutput, type MeshyRemeshStepInput, type MeshyRemeshStepOutput, type MeshyRigStepInput, type MeshyRigStepOutput, type MeshyTextTo3dStepInput, type MeshyTextTo3dStepOutput, type MeshyTextureStepInput, type MeshyTextureStepOutput, MindStudioAgent, MindStudioError, type MindStudioModel, type MindStudioModelSummary, type MixAudioIntoVideoStepInput, type MixAudioIntoVideoStepOutput, type ModelType, type MonacoSnippet, type MonacoSnippetField, type MonacoSnippetFieldType, type MuteVideoStepInput, type MuteVideoStepOutput, type N8nRunNodeStepInput, type N8nRunNodeStepOutput, type NotionCreatePageStepInput, type NotionCreatePageStepOutput, type NotionUpdatePageStepInput, type NotionUpdatePageStepOutput, type PackagedWorkflow, type PackagedWorkflowInput, type PackagedWorkflowSignature, type PeopleSearchStepInput, type PeopleSearchStepOutput, type PostToLinkedInStepInput, type PostToLinkedInStepOutput, type PostToSlackChannelStepInput, type PostToSlackChannelStepOutput, type PostToXStepInput, type PostToXStepOutput, type PostToZapierStepInput, type PostToZapierStepOutput, type Predicate, type PushInput, type PutOptions, Query, type QueryDataSourceStepInput, type QueryDataSourceStepOutput, type QueryExternalDatabaseStepInput, type QueryExternalDatabaseStepOutput, type QuickbooksApiRequestStepInput, type QuickbooksApiRequestStepOutput, RawQuery, type ReadDelivery, type ReadRunParams, type ReadRunRecord, type ReadRunResult, type Reader, type ReaderConfig, type ReaderDocument, type RedactPIIStepInput, type RedactPIIStepOutput, type RemoveBackgroundFromImageStepInput, type RemoveBackgroundFromImageStepOutput, type ReplyToGmailEmailStepInput, type ReplyToGmailEmailStepOutput, type ReportIssueInput, type ReportedIssue, type RequestContext, type ResizeVideoStepInput, type ResizeVideoStepOutput, type ResolvedUser, Roles, type RunAgentOptions, type RunAgentResult, type RunFromConnectorRegistryStepInput, type RunFromConnectorRegistryStepOutput, type RunTaskOptions, type RunTaskOptionsWithExample, type RunTaskOptionsWithSchema, type RunTaskResult, type SchemaValidationError, type ScrapeLinkedInCompanyStepInput, type ScrapeLinkedInCompanyStepOutput, type ScrapeLinkedInProfileStepInput, type ScrapeLinkedInProfileStepOutput, type ScrapeUrlStepInput, type ScrapeUrlStepOutput, type ScrapeXPostStepInput, type ScrapeXPostStepOutput, type ScrapeXProfileStepInput, type ScrapeXProfileStepOutput, type ScreenshotUrlStepInput, type ScreenshotUrlStepOutput, type SearchGmailEmailsStepInput, type SearchGmailEmailsStepOutput, type SearchGoogleCalendarEventsStepInput, type SearchGoogleCalendarEventsStepOutput, type SearchGoogleDriveStepInput, type SearchGoogleDriveStepOutput, type SearchGoogleImagesStepInput, type SearchGoogleImagesStepOutput, type SearchGoogleNewsStepInput, type SearchGoogleNewsStepOutput, type SearchGoogleStepInput, type SearchGoogleStepOutput, type SearchGoogleTrendsStepInput, type SearchGoogleTrendsStepOutput, type SearchPerplexityStepInput, type SearchPerplexityStepOutput, type SearchXPostsStepInput, type SearchXPostsStepOutput, type SearchYoutubeStepInput, type SearchYoutubeStepOutput, type SearchYoutubeTrendsStepInput, type SearchYoutubeTrendsStepOutput, type SendEmailStepInput, type SendEmailStepOutput, type SendGmailDraftStepInput, type SendGmailDraftStepOutput, type SendGmailMessageStepInput, type SendGmailMessageStepOutput, type SendSMSStepInput, type SendSMSStepOutput, type SendSlackDirectMessageStepInput, type SendSlackDirectMessageStepOutput, type SessionContext, type SetGmailReadStatusStepInput, type SetGmailReadStatusStepOutput, type SetRunTitleStepInput, type SetRunTitleStepOutput, type SetVariableStepInput, type SetVariableStepOutput, type StepCostEstimateEntry, type StepExecutionMeta, type StepExecutionOptions, type StepExecutionResult, type StepInputMap, type StepLogEvent, type StepMetadata, type StepMethods, type StepName, type StepOutputMap, Store, type StoredFile, type SystemFields, Table, type TaskEvent, type TaskToolCall, type TaskToolConfig, type TaskUsage, type TextToSpeechStepInput, type TextToSpeechStepOutput, type TopSource, type TranscribeAudioStepInput, type TranscribeAudioStepOutput, type TrimMediaStepInput, type TrimMediaStepOutput, type TypesafeEvaluateStepInput, type TypesafeEvaluateStepOutput, type UpdateGmailLabelsStepInput, type UpdateGmailLabelsStepOutput, type UpdateGoogleCalendarEventStepInput, type UpdateGoogleCalendarEventStepOutput, type UpdateGoogleDocStepInput, type UpdateGoogleDocStepOutput, type UpdateGoogleSheetStepInput, type UpdateGoogleSheetStepOutput, type UpdateInput, type UploadDataSourceDocumentStepInput, type UploadDataSourceDocumentStepOutput, type UploadFileResult, type UploadToken, type UpscaleImageStepInput, type UpscaleImageStepOutput, type UpscaleVideoStepInput, type UpscaleVideoStepOutput, type User, type UserInfoResult, type UserMessageStepInput, type UserMessageStepOutput, type VideoFaceSwapStepInput, type VideoFaceSwapStepOutput, type VideoRemoveBackgroundStepInput, type VideoRemoveBackgroundStepOutput, type VideoRemoveWatermarkStepInput, type VideoRemoveWatermarkStepOutput, type Voice, type VoiceCallResult, type WatermarkImageStepInput, type WatermarkImageStepOutput, type WatermarkVideoStepInput, type WatermarkVideoStepOutput, type YouDotComFinanceResearchStepInput, type YouDotComFinanceResearchStepOutput, type YouDotComGetPageContentStepInput, type YouDotComGetPageContentStepOutput, type YouDotComLiveNewsStepInput, type YouDotComLiveNewsStepOutput, type YouDotComWebResearchStepInput, type YouDotComWebResearchStepOutput, type YouDotComWebSearchStepInput, type YouDotComWebSearchStepOutput, analytics, auth, blockTypeAliases, dataSources, db, mindstudio as default, defineJewel, defineMapper, defineReader, deletes, documents, email, events, files, getRequestContext, mindstudio, monacoSnippets, passthrough, prerender, reportIssue, resolveUser, runWithContext, session, skip, stepMetadata, stream, voice, waitUntil };