@mindstudio-ai/agent 0.1.99 → 0.1.101

package/dist/index.d.ts

@@ -1479,6 +1479,11 @@ interface Db {
      * push, update, remove, removeAll, clear). Compiles them to SQL,
      * sends all in one batch request, and returns typed results.
      *
+     * Only un-awaited Query/Mutation objects can be batched — their SQL is
+     * compiled and bundled. A plain Promise has no SQL to extract, so it is
+     * rejected at the type level (and would throw at runtime): pass
+     * `Table.filter(...)`, not `await`ed results or wrapper functions.
+     *
      * @example
      * ```ts
      * // Mixed reads and writes in one round trip
@@ -1489,13 +1494,20 @@ interface Db {
      * );
      * ```
      */
-    batch<A>(q1: PromiseLike<A>): Promise<[A]>;
-    batch<A, B>(q1: PromiseLike<A>, q2: PromiseLike<B>): Promise<[A, B]>;
-    batch<A, B, C>(q1: PromiseLike<A>, q2: PromiseLike<B>, q3: PromiseLike<C>): Promise<[A, B, C]>;
-    batch<A, B, C, D>(q1: PromiseLike<A>, q2: PromiseLike<B>, q3: PromiseLike<C>, q4: PromiseLike<D>): Promise<[A, B, C, D]>;
-    batch<A, B, C, D, E>(q1: PromiseLike<A>, q2: PromiseLike<B>, q3: PromiseLike<C>, q4: PromiseLike<D>, q5: PromiseLike<E>): Promise<[A, B, C, D, E]>;
-    batch(...queries: PromiseLike<unknown>[]): Promise<unknown[]>;
+    batch<A>(q1: Batchable<A>): Promise<[A]>;
+    batch<A, B>(q1: Batchable<A>, q2: Batchable<B>): Promise<[A, B]>;
+    batch<A, B, C>(q1: Batchable<A>, q2: Batchable<B>, q3: Batchable<C>): Promise<[A, B, C]>;
+    batch<A, B, C, D>(q1: Batchable<A>, q2: Batchable<B>, q3: Batchable<C>, q4: Batchable<D>): Promise<[A, B, C, D]>;
+    batch<A, B, C, D, E>(q1: Batchable<A>, q2: Batchable<B>, q3: Batchable<C>, q4: Batchable<D>, q5: Batchable<E>): Promise<[A, B, C, D, E]>;
+    batch(...queries: Batchable<unknown>[]): Promise<unknown[]>;
 }
+/**
+ * An operation `db.batch()` can bundle: an un-awaited Query (read) or
+ * Mutation (write). The batch executor compiles these to SQL — a plain
+ * Promise carries no SQL and cannot be batched, which is why this is not
+ * `PromiseLike`.
+ */
+type Batchable<A> = Query<any, A> | Mutation<A>;
 
 /**
  * The `files` namespace — typed, private-by-default file storage for MindStudio
@@ -1551,6 +1563,311 @@ interface Files {
     defineStore(name: string, options?: DefineStoreOptions): Store;
 }
 
+/**
+ * Jewels — agentic shadow companions for app methods.
+ *
+ * A jewel lives in `foo.jewel.ts` beside the method `foo.ts` it shadows. It
+ * proposes what a careful teammate would have done — an input for the method
+ * — without ever applying it: the method stays the only door for writes.
+ *
+ * ```ts
+ * // updateIssue.jewel.ts
+ * export default defineJewel(updateIssue, {
+ *   subject: ({ issueId }) => ({ issueId }),
+ *   propose: async ({ issueId }) => {
+ *     // arbitrary TS: reads via plain imports, model calls via runTask
+ *     return { input: { issueId, status: 'triaged' }, reasoning: '...' };
+ *   },
+ * });
+ * ```
+ *
+ * `defineJewel` returns a CALLABLE — the executor — with the config attached
+ * as properties (the Express-app pattern). That shape is deliberate: the
+ * platform's sandbox worker invokes one exported function per execution
+ * frame (`mod[handlerName](params)`), so a jewel run is an ordinary
+ * method-execution frame with zero worker or protocol changes. Dev tooling
+ * calls the same function, so dev and production share one executor body,
+ * versioned here in the SDK.
+ *
+ * Three run modes, discriminated by which key the caller provides:
+ * - `{ humanInput }` — shadow mode. The subject is derived via the jewel's
+ *   projection (the human's decision fields never reach `propose`), and
+ *   `humanInput` doubles as ground truth for grading.
+ * - `{ subject }` — eval / arrival mode. No human action exists yet, so the
+ *   record is ungraded (an arrival proposal is graded later, when the human
+ *   acts — see the grade mode below).
+ * - `{ grade: { proposed, actual } }` — grade-only mode: deferred grading of
+ *   an earlier arrival proposal against the human's eventual action. Runs
+ *   the jewel's own `grade` (or the default deep-equal) and nothing else.
+ *
+ * The executor NEVER throws: a shadow run must never break anything. Author
+ * code failing (`subject`/`propose`) is captured in the record's `error`;
+ * `grade` failing softens to verdict `'skip'`.
+ */
+/** Any app method a jewel can shadow: one JSON-serializable input, any result. */
+type JewelMethod = (input: any) => any;
+/**
+ * The input type of the shadowed method. Guarded so a zero-parameter method
+ * resolves to `undefined` instead of erroring on `Parameters<M>[0]`.
+ */
+type JewelMethodInput<M extends JewelMethod> = Parameters<M> extends [] ? undefined : Parameters<M>[0];
+/**
+ * What `propose` returns. `input: null` is abstention — a first-class,
+ * graded outcome, not an error. Reasoning is most valuable on abstention.
+ */
+interface JewelProposal<I> {
+    input: I | null;
+    reasoning: string;
+}
+interface JewelVerdict {
+    verdict: 'agree' | 'disagree' | 'skip';
+    notes?: string;
+}
+/**
+ * Argument to a custom `grade`. `proposed` is null when the jewel abstained;
+ * `actual` is always present — grading only happens in shadow mode, where
+ * the human acted.
+ */
+interface JewelGradeContext<I> {
+    proposed: I | null;
+    actual: I;
+}
+type MaybePromise<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
+ * parameter.
+ */
+interface JewelConfig<M extends JewelMethod, S> {
+    /**
+     * Projection: method input → subject. What the human was looking at,
+     * never what they decided — this is what keeps the label out of the exam.
+     */
+    subject: (input: JewelMethodInput<M>) => S;
+    /**
+     * The proposal. Runs on the projection only; arbitrary TS (plain imports
+     * for context, model calls via runTask). Throwing never propagates — it
+     * becomes an `error` on the pair record.
+     */
+    propose: (subject: NoInfer<S>) => MaybePromise<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'`.
+     *
+     * Strict-safe field iteration, when grading only touched fields:
+     * ```ts
+     * grade: ({ proposed, actual }) => {
+     *   if (!proposed) return { verdict: 'disagree', notes: 'abstained' };
+     *   const keys = Object.keys(actual) as (keyof typeof actual)[];
+     *   const misses = keys.filter((k) => proposed[k] !== actual[k]);
+     *   return misses.length
+     *     ? { verdict: 'disagree', notes: misses.join(', ') }
+     *     : { verdict: 'agree' };
+     * }
+     * ```
+     */
+    grade?: (ctx: JewelGradeContext<JewelMethodInput<M>>) => MaybePromise<JewelVerdict>;
+}
+/**
+ * Executor params — constructed by the platform (or dev tooling), exactly
+ * one key. `?: never` on the other keys rejects passing more than one.
+ */
+type JewelRunParams<I, S> = {
+    humanInput: I;
+    subject?: never;
+    grade?: never;
+} | {
+    subject: S;
+    humanInput?: never;
+    grade?: never;
+} | {
+    grade: JewelGradeContext<I>;
+    humanInput?: never;
+    subject?: never;
+};
+/**
+ * The versioned, JSON-serializable output of one jewel run — the row the
+ * pair ledger stores. Values are kept verbatim, so method inputs must be
+ * JSON-safe (they already crossed the wire as JSON in real use).
+ */
+interface JewelPairRecord<I = unknown, S = unknown> {
+    v: 1;
+    /** `grade` records are consumed by the platform (verdict extracted from a
+     *  grade-only run) and never persisted as pair rows themselves. */
+    mode: 'shadow' | 'eval' | 'grade';
+    /** Absent only when the projection itself threw (shadow mode). */
+    subject?: S;
+    /** null = abstention. Absent when propose failed. */
+    proposed?: I | null;
+    /** Absent when propose failed. */
+    reasoning?: string;
+    /** The human's input — present in shadow mode. */
+    actual?: I;
+    /** Present iff graded (shadow or grade mode, propose succeeded). */
+    verdict?: 'agree' | 'disagree' | 'skip';
+    notes?: string;
+    /** Present iff subject() or propose() threw. Grade errors become verdict 'skip'. */
+    error?: {
+        phase: 'subject' | 'propose';
+        message: string;
+        stack?: string;
+    };
+    /**
+     * Whether this jewel declares a custom `grade`. The platform's deferred
+     * grading dispatches a grade-mode run when true; when false it grades
+     * locally with an equivalent of the default deep-equal (no sandbox trip
+     * to evaluate a pure structural comparison).
+     */
+    customGrade: boolean;
+    startedAt: number;
+    durationMs: number;
+}
+/**
+ * The export of a `foo.jewel.ts` file: the executor, callable as an
+ * ordinary handler, with the authored config attached for the compiler and
+ * dev tooling. `method` carries the actual function reference — reference
+ * identity is what lets the compiler verify the manifest's method↔jewel
+ * pairing against the code. `grade` is `undefined` when the default
+ * deep-equal grade applies; presence is the custom-grade signal.
+ */
+interface Jewel<M extends JewelMethod, S> {
+    (params: JewelRunParams<JewelMethodInput<M>, S>): Promise<JewelPairRecord<JewelMethodInput<M>, S>>;
+    readonly kind: 'jewel';
+    readonly method: M;
+    readonly subject: (input: JewelMethodInput<M>) => S;
+    readonly propose: (subject: S) => MaybePromise<JewelProposal<JewelMethodInput<M>>>;
+    readonly grade: ((ctx: JewelGradeContext<JewelMethodInput<M>>) => MaybePromise<JewelVerdict>) | undefined;
+}
+/**
+ * What the platform did with a proposal, routed by the method's autonomy:
+ * - `recorded` — shadow: proposal written to the pair ledger, graded later
+ *   against the human's eventual action (within the attribution window).
+ * - `queued` — approve: waiting in the review queue.
+ * - `committed` — auto: the jewel's proposal was applied (the method ran);
+ *   `output` carries the method's return value.
+ * - `abstained` — the jewel chose not to act; recorded, still gradeable.
+ * - `disabled` — the method has no jewel or autonomy is `manual`. Returned,
+ *   never thrown: dialing a method down must not break the app code that
+ *   proposes to it.
+ * - `skipped` — dev session, jewel-descended recursion, or unsampled
+ *   (sampleRate).
+ * - `failed` — an auto commit was attempted and the method rejected it
+ *   (e.g. the state was consumed concurrently). The moment stays pending.
+ * - `pending` — a concurrent replay: the original propose for this
+ *   idempotencyKey is still mid-run. Treat as accepted.
+ */
+type JewelProposeOutcome = 'recorded' | 'queued' | 'committed' | 'abstained' | 'disabled' | 'skipped' | 'failed' | 'pending';
+interface JewelProposeResult {
+    outcome: JewelProposeOutcome;
+    /** Present on `committed` — the method's return value. */
+    output?: unknown;
+    /** Present on `queued` — address the item via `jewels.queue.resolve`. */
+    queueItemId?: string;
+}
+/** A pending approval-queue item awaiting a reviewer. */
+interface JewelQueueItem {
+    id: string;
+    methodId: string;
+    subject: Record<string, unknown>;
+    /** The method input the jewel proposes to apply. */
+    proposed: unknown;
+    reasoning: string | null;
+    proposedAt: string;
+    /** Unresolved items expire (verdict `expired`) at the attribution window. */
+    expiresAt: string;
+}
+type JewelQueueResolution = 'approved' | 'edited' | 'dismissed';
+interface JewelQueueResolveResult {
+    resolution: JewelQueueResolution;
+    /** Present on approve — the applied method's return value. */
+    output?: unknown;
+}
+interface JewelsApi {
+    /**
+     * Hand a decision moment to a method's jewel — the arrival-shaped trigger.
+     * Place it where the app knows the moment was born (an ingest branch that
+     * lands a row in its pending state). The platform routes by the method's
+     * autonomy; see {@link JewelProposeOutcome}.
+     *
+     * `idempotencyKey` (Stripe semantics — a replayed key returns the ORIGINAL
+     * outcome, so retried webhooks are invisible to this code) defaults to a
+     * hash of the subject. Sibling proposals for one decision moment should
+     * share a key so cross-verb grading can close them together.
+     *
+     * Backend/managed contexts only (rides the execution's hook token). Runs
+     * the jewel synchronously — wrap chains in `mindstudio.waitUntil(...)` so
+     * the calling method returns immediately:
+     *
+     * ```ts
+     * mindstudio.waitUntil((async () => {
+     *   const merge = await mindstudio.jewels.propose(
+     *     'merge-issues', { sourceId: issue.id }, { idempotencyKey: issue.id });
+     *   if (merge.outcome !== 'committed') {
+     *     await mindstudio.jewels.propose(
+     *       'triage-issue', { issueId: issue.id }, { idempotencyKey: issue.id });
+     *   }
+     * })());
+     * ```
+     */
+    propose(methodId: string, subject: Record<string, unknown>, opts?: {
+        idempotencyKey?: string;
+    }): Promise<JewelProposeResult>;
+    /**
+     * The app-native approval queue for `approve`-mode methods. Build the
+     * review UI in the app itself: a backend method lists items (gate it with
+     * the app's reviewer role), the frontend renders the inbox, and a resolve
+     * method approves or dismisses.
+     */
+    queue: {
+        /** Pending items, oldest first. */
+        list(opts?: {
+            methodId?: string;
+            limit?: number;
+        }): Promise<{
+            items: JewelQueueItem[];
+        }>;
+        /**
+         * Resolve one item. `approve` APPLIES the target method as the current
+         * session user — the reviewer — so the effect belongs to the human who
+         * clicked, and the target method's own auth checks are the real gate on
+         * who may approve. Pass `input` to apply an edited version of the
+         * proposal (captured as resolution `edited` — proposed/edited/final ride
+         * the pair record; the richest training signal). `dismiss` records the
+         * rejection and closes the item without running anything; other verbs'
+         * proposals for the same moment stay open.
+         */
+        resolve(itemId: string, opts: {
+            action: 'approve' | 'dismiss';
+            input?: Record<string, unknown>;
+        }): Promise<JewelQueueResolveResult>;
+    };
+}
+/**
+ * Define a jewel — the agentic shadow companion for an app method.
+ *
+ * @example
+ * ```ts
+ * export default defineJewel(updateIssue, {
+ *   subject: ({ issueId }) => ({ issueId }),
+ *   propose: async ({ issueId }) => {
+ *     const issue = await resolveIssue(issueId);
+ *     if (!issue || issue.status !== 'new') {
+ *       return { input: null, reasoning: 'Nothing to propose.' };
+ *     }
+ *     // ...gather context, call a model via runTask + outputSchema...
+ *     return { input: { issueId, status: 'triaged' }, reasoning: '...' };
+ *   },
+ *   grade: async ({ proposed, actual }) => {
+ *     if (!proposed) return { verdict: 'disagree', notes: 'abstained' };
+ *     return proposed.status === actual.status
+ *       ? { verdict: 'agree' }
+ *       : { verdict: 'disagree' };
+ *   },
+ * });
+ * ```
+ */
+declare function defineJewel<M extends JewelMethod, S>(method: M, config: JewelConfig<M, S>): Jewel<M, S>;
+
 /** @internal Transport: `POST /_internal/v2/datasources/<op>` with the hook token. */
 type DataSourcesTransport = (op: string, body: unknown) => Promise<any>;
 /** Where a retrieved chunk came from — enough to show the user the source. */
@@ -2034,13 +2351,111 @@ interface Voice {
     }): Promise<VoiceCallResult>;
 }
 
+/**
+ * JSON Schema support for task-agent structured output.
+ *
+ * The dialect is a deliberately bounded subset of JSON Schema — the shape
+ * used for Anthropic tool `input_schema` / OpenAI function parameters:
+ * `type` (including type arrays for nullability), `properties`, `required`,
+ * `additionalProperties`, `items`, `enum`, `const`. Everything in this file
+ * covers exactly that subset and nothing more, on both levels:
+ *
+ * - {@link FromSchema} maps a schema *value* to the TypeScript type it
+ *   describes (compile time).
+ * - {@link validateAgainstSchema} checks a runtime value against the same
+ *   constructs (runtime).
+ *
+ * Keeping the two in one module is the point: what the type infers is what
+ * the validator enforces. Schemas using keywords outside the subset are
+ * rejected loudly by {@link assertSupportedSchema} rather than silently
+ * half-enforced.
+ */
+type JsonSchemaTypeName = 'object' | 'array' | 'string' | 'number' | 'integer' | 'boolean' | 'null';
+/**
+ * A schema in the supported dialect. Every position is readonly so inline
+ * literals inferred via `const` type parameters (which produce readonly
+ * tuples/objects) are assignable.
+ */
+interface JsonSchema {
+    readonly type?: JsonSchemaTypeName | readonly JsonSchemaTypeName[];
+    readonly properties?: Readonly<Record<string, JsonSchema>>;
+    readonly required?: readonly string[];
+    readonly additionalProperties?: boolean;
+    readonly items?: JsonSchema;
+    readonly enum?: readonly (string | number | boolean | null)[];
+    readonly const?: string | number | boolean | null;
+    readonly description?: string;
+}
+/**
+ * The root schema for task output must be an object schema. The literal
+ * `type: 'object'` requirement also anchors overload resolution on
+ * `runTask` — without it, nearly any object type would satisfy the schema
+ * overload's constraint (every `JsonSchema` property is optional).
+ */
+interface JsonObjectSchema extends JsonSchema {
+    readonly type: 'object';
+    readonly properties: Readonly<Record<string, JsonSchema>>;
+}
+/**
+ * Infers the TypeScript type described by a schema literal.
+ *
+ * ```ts
+ * const schema = {
+ *   type: 'object',
+ *   properties: {
+ *     action: { enum: ['approve', 'reject'] },
+ *     note: { type: ['string', 'null'] },
+ *   },
+ *   required: ['action'],
+ * } as const satisfies JsonObjectSchema;
+ *
+ * type Out = FromSchema<typeof schema>;
+ * // { action: 'approve' | 'reject'; note?: string | null }
+ * ```
+ */
+type FromSchema<S> = S extends {
+    const: infer C;
+} ? C : S extends {
+    enum: readonly (infer E)[];
+} ? E : S extends {
+    type: readonly (infer TN extends JsonSchemaTypeName)[];
+} ? FromTypeName<TN, S> : S extends {
+    type: infer TN extends JsonSchemaTypeName;
+} ? FromTypeName<TN, S> : unknown;
+/** Distributes over union type names, so `['string','null']` → `string | null`. */
+type FromTypeName<TN extends JsonSchemaTypeName, S> = (TN extends 'string' ? string : never) | (TN extends 'number' | 'integer' ? number : never) | (TN extends 'boolean' ? boolean : never) | (TN extends 'null' ? null : never) | (TN extends 'array' ? S extends {
+    items: infer I;
+} ? FromSchema<I>[] : unknown[] : never) | (TN extends 'object' ? FromObjectSchema<S> : never);
+type RequiredKeys<S> = S extends {
+    required: readonly (infer R extends string)[];
+} ? R : never;
+type FromObjectSchema<S> = S extends {
+    properties: infer P;
+} ? Prettify<{
+    [K in Extract<keyof P, RequiredKeys<S>>]: FromSchema<P[K]>;
+} & {
+    [K in Exclude<keyof P, RequiredKeys<S>>]?: FromSchema<P[K]>;
+}> : Record<string, unknown>;
+/** Collapses the required/optional intersection into one readable object type. */
+type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+interface SchemaValidationError {
+    /** JSONPath-style location, e.g. `$.items[2].severity`. */
+    path: string;
+    /** Human-readable problem, e.g. `expected one of "low" | "high", got "critical"`. */
+    message: string;
+}
+
 /**
  * Types for the task agent runtime.
  *
  * A task agent is a multi-step tool-use loop: the model receives a prompt
  * and a set of SDK actions as tools, calls them as needed, and produces
- * structured output matching the developer's example.
+ * structured output — validated against the developer's `outputSchema`, or
+ * shaped by a `structuredOutputExample`.
  */
+
 /**
  * Tool configuration for {@link RunTaskOptions.tools}.
  * - String: SDK method name (e.g. `'searchGoogle'`).
@@ -2065,16 +2480,14 @@ type TaskToolConfig = string | {
     description?: string;
     defaults?: Record<string, unknown>;
 };
-/** Options for {@link MindStudioAgent.runTask}. */
-interface RunTaskOptions {
+/** Options shared by both output modes of {@link MindStudioAgent.runTask}. */
+interface RunTaskOptionsBase {
     /** System prompt — defines the agent's behavior and approach. */
     prompt: string;
     /** Structured input for this task instance. Passed as the user message. */
     input: Record<string, unknown>;
     /** SDK actions and/or app methods to make available as tools. */
     tools: TaskToolConfig[];
-    /** Expected output shape. Pass a JSON string or an object (will be stringified automatically). */
-    structuredOutputExample: string | Record<string, unknown>;
     /** Model ID for the task agent. Must support tool use. */
     model: string;
     /** Max loop iterations before forcing final output. Default 20, max 100. */
@@ -2090,6 +2503,32 @@ interface RunTaskOptions {
      */
     onEvent?: (event: TaskEvent) => void;
 }
+/**
+ * Example mode: the output shape is suggested by example only. `output` is
+ * whatever `JSON.parse` produced (or the raw string when
+ * `parsedSuccessfully` is false) — callers must validate it themselves.
+ */
+interface RunTaskOptionsWithExample extends RunTaskOptionsBase {
+    /** Expected output shape. Pass a JSON string or an object (will be stringified automatically). */
+    structuredOutputExample: string | Record<string, unknown>;
+    outputSchema?: never;
+}
+/**
+ * Schema mode: the output contract is a plain JSON Schema (the Anthropic
+ * tool `input_schema` dialect subset — type/properties/required/enum/items,
+ * nullability via type arrays like `['string', 'null']`). Output is
+ * validated every turn with automatic repair, `result.output` is typed by
+ * inference from the schema value, and `runTask` either returns conforming
+ * output or throws (`task_output_schema_mismatch`) — it never resolves with
+ * garbage.
+ */
+interface RunTaskOptionsWithSchema<S extends JsonObjectSchema = JsonObjectSchema> extends RunTaskOptionsBase {
+    /** Plain JSON Schema for the output. Root must be `type: 'object'`. */
+    outputSchema: S;
+    structuredOutputExample?: never;
+}
+/** Options for {@link MindStudioAgent.runTask} — one of the two output modes. */
+type RunTaskOptions = RunTaskOptionsWithExample | RunTaskOptionsWithSchema;
 /** An event from a streaming task agent execution. */
 interface TaskEvent {
     type: 'text' | 'thinking' | 'thinking_complete' | 'tool_use' | 'tool_input_delta' | 'tool_input_args' | 'tool_call_start' | 'tool_call_result' | 'error' | 'done';
@@ -2248,13 +2687,19 @@ declare class MindStudioAgent$1 {
     /**
      * Run a task agent — a multi-step tool-use loop that composes SDK actions
      * to produce structured output. The model receives the prompt and tools,
-     * calls actions as needed, and returns JSON matching the output example.
+     * calls actions as needed, and returns structured JSON.
      *
      * Tools can be SDK actions, your own app's methods, or both. App methods run
      * as the user who invoked the method that started the task, with their roles.
      *
+     * Prefer `outputSchema` (plain JSON Schema, tool-definition dialect):
+     * output is validated every turn with automatic repair, `result.output` is
+     * typed by inference from the schema — no generic argument, no manual
+     * validation — and the call either returns conforming output or throws
+     * (`task_output_schema_mismatch`).
+     *
      * ```ts
-     * const result = await agent.runTask<{ name: string; url: string }>({
+     * const result = await agent.runTask({
      *   prompt: 'Find canonical info for this restaurant, then save it.',
      *   input: { restaurantName: 'Tartine Bakery SF' },
      *   tools: [
@@ -2262,13 +2707,26 @@ declare class MindStudioAgent$1 {
      *     'fetchUrl',
      *     { appMethod: 'saveRestaurant', description: 'Persist the researched restaurant.' },
      *   ],
-     *   structuredOutputExample: JSON.stringify({ name: 'Tartine Bakery', url: 'https://tartinebakery.com' }),
+     *   outputSchema: {
+     *     type: 'object',
+     *     properties: {
+     *       name: { type: 'string' },
+     *       url: { type: ['string', 'null'] },
+     *       kind: { enum: ['bakery', 'cafe', 'restaurant'] },
+     *     },
+     *     required: ['name', 'kind'],
+     *   },
      *   model: 'claude-4-6-sonnet',
      * });
-     * console.log(result.output.name); // 'Tartine Bakery'
+     * result.output.kind; // typed as 'bakery' | 'cafe' | 'restaurant'
      * ```
+     *
+     * The legacy alternative, `structuredOutputExample`, shapes output by
+     * example only: `output` is typed by the caller's generic argument and
+     * must be validated manually (check `parsedSuccessfully` first).
      */
-    runTask<T = unknown>(options: RunTaskOptions): Promise<RunTaskResult<T>>;
+    runTask<const S extends JsonObjectSchema>(options: RunTaskOptionsWithSchema<S>): Promise<RunTaskResult<FromSchema<S>>>;
+    runTask<T = unknown>(options: RunTaskOptionsWithExample): Promise<RunTaskResult<T>>;
     /**
      * Register background work with the platform so the sandbox stays alive
      * until it settles (bounded at ~30 minutes) instead of being reaped as
@@ -2495,6 +2953,17 @@ declare class MindStudioAgent$1 {
      * ```
      */
     get files(): Files;
+    /**
+     * Jewel surfaces: arrival-shaped triggers (`propose`) and the app-native
+     * approval queue (`queue.list` / `queue.resolve`). See {@link JewelsApi}.
+     */
+    get jewels(): JewelsApi;
+    /**
+     * Raw hook-token call shared by the jewels surfaces (mirrors reportIssue).
+     * No retries: propose holds the request for the jewel run and is idempotent
+     * by key anyway; resolve applies a method and must never double-fire.
+     */
+    private _jewelsRequest;
     /**
      * Searchable document corpora.
      *
@@ -5379,10 +5848,10 @@ interface ScrapeUrlStepInput {
     url: string;
     /** Scraping service to use */
     service?: "default" | "firecrawl";
-    /** Whether to enable enhanced scraping for social media URLs (e.g. Twitter, LinkedIn) */
+    /** No longer selects a provider — the default service's anti-bot engine decides per request how hard to work. Retained because existing workflows set it and the builder still renders it. */
     autoEnhance?: boolean;
-    /** Output format: text returns markdown, html returns raw HTML, json returns structured scraper data */
-    outputFormat?: "text" | "json" | "html";
+    /** Output format: text returns markdown, html returns raw HTML, json returns structured scraper data, summary returns a model-written summary (Firecrawl only) */
+    outputFormat?: "text" | "json" | "html" | "summary";
     /** Page-level scraping options (content filtering, screenshots, headers, etc.) */
     pageOptions?: {
         /** Whether to extract only the main content of the page, excluding navigation, footers, etc. */
@@ -5428,6 +5897,12 @@ interface ScrapeUrlStepOutput {
             code: string;
             message: string;
         };
+        /**
+     * What the provider actually charged, when it tells us. Scrapfly returns an exact per-request credit total that varies with how hard the target fought back (6 for an unprotected page, 80 for Glassdoor), so billing a flat rate would either overcharge the easy case or eat the hard one. Providers that report nothing leave this undefined and fall back to the route's estimate.
+     *
+     * Includes every attempt made on the caller's behalf, not just the last one.
+     */
+        costUnits?: number;
     } | {
         /** Markdown/plain-text content of the scraped page */
         text: string;
@@ -5453,6 +5928,12 @@ interface ScrapeUrlStepOutput {
             code: string;
             message: string;
         };
+        /**
+     * What the provider actually charged, when it tells us. Scrapfly returns an exact per-request credit total that varies with how hard the target fought back (6 for an unprotected page, 80 for Glassdoor), so billing a flat rate would either overcharge the easy case or eat the hard one. Providers that report nothing leave this undefined and fall back to the route's estimate.
+     *
+     * Includes every attempt made on the caller's behalf, not just the last one.
+     */
+        costUnits?: number;
     }[];
     /** Screenshot URL(s), only present when a screenshot was captured */
     screenshot?: string | string[];
@@ -5488,6 +5969,12 @@ interface ScrapeXPostStepOutput {
             code: string;
             message: string;
         };
+        /**
+     * What the provider actually charged, when it tells us. Scrapfly returns an exact per-request credit total that varies with how hard the target fought back (6 for an unprotected page, 80 for Glassdoor), so billing a flat rate would either overcharge the easy case or eat the hard one. Providers that report nothing leave this undefined and fall back to the route's estimate.
+     *
+     * Includes every attempt made on the caller's behalf, not just the last one.
+     */
+        costUnits?: number;
     };
 }
 interface ScrapeXProfileStepInput {
@@ -5521,6 +6008,12 @@ interface ScrapeXProfileStepOutput {
             code: string;
             message: string;
         };
+        /**
+     * What the provider actually charged, when it tells us. Scrapfly returns an exact per-request credit total that varies with how hard the target fought back (6 for an unprotected page, 80 for Glassdoor), so billing a flat rate would either overcharge the easy case or eat the hard one. Providers that report nothing leave this undefined and fall back to the route's estimate.
+     *
+     * Includes every attempt made on the caller's behalf, not just the last one.
+     */
+        costUnits?: number;
     };
 }
 interface ScreenshotUrlStepInput {
@@ -8764,8 +9257,9 @@ interface StepMethods {
      *
      * @remarks
      * - Accepts a single URL or multiple URLs (as a JSON array, comma-separated, or newline-separated).
-     * - Output format controls the result shape: "text" returns markdown, "html" returns raw HTML, "json" returns structured scraper data.
+     * - Output format controls the result shape: "text" returns markdown, "html" returns raw HTML, "json" returns structured scraper data, "summary" returns a model-written summary and requires the "firecrawl" service.
      * - Can optionally capture a screenshot of each page.
+     * - Handles bot protection automatically; no proxy or rendering configuration is needed.
      *
      * @example
      * ```typescript
@@ -8811,8 +9305,11 @@ interface StepMethods {
      * @remarks
      * - Takes a viewport or full-page screenshot of the given URL.
      * - Returns a CDN-hosted PNG image URL.
-     * - Viewport mode captures only the visible area; fullPage captures the entire scrollable page.
-     * - You can customize viewport width/height, add a delay, or wait for a CSS selector before capturing.
+     * - Viewport mode captures only the visible area; fullPage captures the entire scrollable page, scrolling it first so lazy-loaded content is included.
+     * - Works on sites behind bot protection (Cloudflare and similar).
+     * - Cookie-consent banners and similar overlays are suppressed automatically.
+     * - `width` and `height` are the exact output pixel dimensions.
+     * - You can add a delay or wait for a CSS selector before capturing. A selector that never appears fails the step rather than capturing early.
      *
      * @example
      * ```typescript
@@ -10009,4 +10506,4 @@ declare const prerender: {
     }>;
 };
 
-export { type Accessor, type ActiveCampaignAddNoteStepInput, type ActiveCampaignAddNoteStepOutput, type ActiveCampaignCreateContactStepInput, type ActiveCampaignCreateContactStepOutput, type AddSubtitlesToVideoStepInput, type AddSubtitlesToVideoStepOutput, type AgentInfo, type AgentOptions, type AirtableCreateUpdateRecordStepInput, type AirtableCreateUpdateRecordStepOutput, type AirtableDeleteRecordStepInput, type AirtableDeleteRecordStepOutput, type AirtableGetRecordStepInput, type AirtableGetRecordStepOutput, type AirtableGetTableRecordsStepInput, type AirtableGetTableRecordsStepOutput, 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 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 CreateDataSourceStepInput, type CreateDataSourceStepOutput, type CreateGmailDraftStepInput, type CreateGmailDraftStepOutput, type CreateGoogleCalendarEventStepInput, type CreateGoogleCalendarEventStepOutput, type CreateGoogleDocStepInput, type CreateGoogleDocStepOutput, type CreateGoogleSheetStepInput, type CreateGoogleSheetStepOutput, type Db, 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 DiscordEditMessageStepInput, type DiscordEditMessageStepOutput, type DiscordSendFollowUpStepInput, type DiscordSendFollowUpStepOutput, type DiscordSendMessageStepInput, type DiscordSendMessageStepOutput, type DownloadVideoStepInput, type DownloadVideoStepOutput, type EnhanceImageGenerationPromptStepInput, type EnhanceImageGenerationPromptStepOutput, type EnhanceVideoGenerationPromptStepInput, type EnhanceVideoGenerationPromptStepOutput, type EnrichPersonStepInput, type EnrichPersonStepOutput, 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 Generate3dModelStepInput, type Generate3dModelStepOutput, type GenerateAssetStepInput, type GenerateAssetStepOutput, type GenerateChartStepInput, type GenerateChartStepOutput, type GenerateImageStepInput, type GenerateImageStepOutput, type GenerateLipsyncStepInput, type GenerateLipsyncStepOutput, type GenerateMusicStepInput, type GenerateMusicStepOutput, type GeneratePdfStepInput, type GeneratePdfStepOutput, 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 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 LogicStepInput, type LogicStepOutput, type MakeDotComRunScenarioStepInput, type MakeDotComRunScenarioStepOutput, 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 ParticlePodcastsFindMentionsStepInput, type ParticlePodcastsFindMentionsStepOutput, type ParticlePodcastsGetEpisodeStepInput, type ParticlePodcastsGetEpisodeStepOutput, type ParticlePodcastsGetEpisodeTranscriptStepInput, type ParticlePodcastsGetEpisodeTranscriptStepOutput, type ParticlePodcastsSearchCompaniesStepInput, type ParticlePodcastsSearchCompaniesStepOutput, type ParticlePodcastsSearchDialogueStepInput, type ParticlePodcastsSearchDialogueStepOutput, type ParticlePodcastsSearchPodcastsStepInput, type ParticlePodcastsSearchPodcastsStepOutput, 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 QueryAppDatabaseStepInput, type QueryAppDatabaseStepOutput, type QueryDataSourceStepInput, type QueryDataSourceStepOutput, type QueryExternalDatabaseStepInput, type QueryExternalDatabaseStepOutput, 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 RunPackagedWorkflowStepInput, type RunPackagedWorkflowStepOutput, type RunTaskOptions, type RunTaskResult, 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 TelegramEditMessageStepInput, type TelegramEditMessageStepOutput, type TelegramReplyToMessageStepInput, type TelegramReplyToMessageStepOutput, type TelegramSendAudioStepInput, type TelegramSendAudioStepOutput, type TelegramSendFileStepInput, type TelegramSendFileStepOutput, type TelegramSendImageStepInput, type TelegramSendImageStepOutput, type TelegramSendMessageStepInput, type TelegramSendMessageStepOutput, type TelegramSendVideoStepInput, type TelegramSendVideoStepOutput, type TelegramSetTypingStepInput, type TelegramSetTypingStepOutput, type TextToSpeechStepInput, type TextToSpeechStepOutput, type TranscribeAudioStepInput, type TranscribeAudioStepOutput, type TrimMediaStepInput, type TrimMediaStepOutput, 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, auth, blockTypeAliases, dataSources, db, mindstudio as default, files, getRequestContext, mindstudio, monacoSnippets, prerender, reportIssue, resolveUser, runWithContext, session, stepMetadata, stream, voice, waitUntil };
+export { type Accessor, type ActiveCampaignAddNoteStepInput, type ActiveCampaignAddNoteStepOutput, type ActiveCampaignCreateContactStepInput, type ActiveCampaignCreateContactStepOutput, type AddSubtitlesToVideoStepInput, type AddSubtitlesToVideoStepOutput, type AgentInfo, type AgentOptions, type AirtableCreateUpdateRecordStepInput, type AirtableCreateUpdateRecordStepOutput, type AirtableDeleteRecordStepInput, type AirtableDeleteRecordStepOutput, type AirtableGetRecordStepInput, type AirtableGetRecordStepOutput, type AirtableGetTableRecordsStepInput, type AirtableGetTableRecordsStepOutput, 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 CreateDataSourceStepInput, type CreateDataSourceStepOutput, type CreateGmailDraftStepInput, type CreateGmailDraftStepOutput, type CreateGoogleCalendarEventStepInput, type CreateGoogleCalendarEventStepOutput, type CreateGoogleDocStepInput, type CreateGoogleDocStepOutput, type CreateGoogleSheetStepInput, type CreateGoogleSheetStepOutput, type Db, 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 DiscordEditMessageStepInput, type DiscordEditMessageStepOutput, type DiscordSendFollowUpStepInput, type DiscordSendFollowUpStepOutput, type DiscordSendMessageStepInput, type DiscordSendMessageStepOutput, type DownloadVideoStepInput, type DownloadVideoStepOutput, type EnhanceImageGenerationPromptStepInput, type EnhanceImageGenerationPromptStepOutput, type EnhanceVideoGenerationPromptStepInput, type EnhanceVideoGenerationPromptStepOutput, type EnrichPersonStepInput, type EnrichPersonStepOutput, 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 GenerateChartStepInput, type GenerateChartStepOutput, type GenerateImageStepInput, type GenerateImageStepOutput, type GenerateLipsyncStepInput, type GenerateLipsyncStepOutput, type GenerateMusicStepInput, type GenerateMusicStepOutput, type GeneratePdfStepInput, type GeneratePdfStepOutput, 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 LogicStepInput, type LogicStepOutput, type MakeDotComRunScenarioStepInput, type MakeDotComRunScenarioStepOutput, 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 ParticlePodcastsFindMentionsStepInput, type ParticlePodcastsFindMentionsStepOutput, type ParticlePodcastsGetEpisodeStepInput, type ParticlePodcastsGetEpisodeStepOutput, type ParticlePodcastsGetEpisodeTranscriptStepInput, type ParticlePodcastsGetEpisodeTranscriptStepOutput, type ParticlePodcastsSearchCompaniesStepInput, type ParticlePodcastsSearchCompaniesStepOutput, type ParticlePodcastsSearchDialogueStepInput, type ParticlePodcastsSearchDialogueStepOutput, type ParticlePodcastsSearchPodcastsStepInput, type ParticlePodcastsSearchPodcastsStepOutput, 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 QueryAppDatabaseStepInput, type QueryAppDatabaseStepOutput, type QueryDataSourceStepInput, type QueryDataSourceStepOutput, type QueryExternalDatabaseStepInput, type QueryExternalDatabaseStepOutput, 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 RunPackagedWorkflowStepInput, type RunPackagedWorkflowStepOutput, 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 TelegramEditMessageStepInput, type TelegramEditMessageStepOutput, type TelegramReplyToMessageStepInput, type TelegramReplyToMessageStepOutput, type TelegramSendAudioStepInput, type TelegramSendAudioStepOutput, type TelegramSendFileStepInput, type TelegramSendFileStepOutput, type TelegramSendImageStepInput, type TelegramSendImageStepOutput, type TelegramSendMessageStepInput, type TelegramSendMessageStepOutput, type TelegramSendVideoStepInput, type TelegramSendVideoStepOutput, type TelegramSetTypingStepInput, type TelegramSetTypingStepOutput, type TextToSpeechStepInput, type TextToSpeechStepOutput, type TranscribeAudioStepInput, type TranscribeAudioStepOutput, type TrimMediaStepInput, type TrimMediaStepOutput, 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, auth, blockTypeAliases, dataSources, db, mindstudio as default, defineJewel, files, getRequestContext, mindstudio, monacoSnippets, prerender, reportIssue, resolveUser, runWithContext, session, stepMetadata, stream, voice, waitUntil };