@mindstudio-ai/agent 0.1.173 → 0.1.175

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -4,6 +4,32 @@ What changed in `@mindstudio-ai/agent`, newest first, each version under its own
4
4
 
5
5
  Versions before 0.1.163 aren't recorded here.
6
6
 
7
+ ## 0.1.175
8
+
9
+ ### New
10
+
11
+ - `defineTable` takes `indexes`: column groups, each a plain (non-unique) index for the columns the table's queries filter or sort by, like `indexes: [['status'], ['customerId', 'createdAt']]`. The platform adds and drops them in place as the list changes, without rebuilding the table. A table can declare up to 16. Check: a table whose queries filter a column that isn't the first of a `unique` group reads every row; declaring an index on it makes those lookups.
12
+ - A query that took a while because it read every row of a table logs `[mindstudio] A query read every row of '<table>' (<n> ms)…`, from the platform's plan of it, at most once per statement shape every 15 minutes. An index on the columns it filters or sorts by makes it a lookup.
13
+
14
+ ## 0.1.174
15
+
16
+ ### New
17
+
18
+ - `session.environment`: `'live'`, `'preview'` or `'dev'`, on every run, so a method can keep a dev run's fixed-key file-store writes (a generated sitemap, a `config/latest.json`) off what live reads, since file stores are shared across environments. Absent on older platform versions.
19
+ - `session.host`: the host the request was served on (a custom domain, the app's own subdomain, a preview host, or the parent's host under a mount), set by the platform, so one app serving several sites can tell which one a call came from. On web, API, webhook, MCP and agent-chat calls; absent on cron, inbound email, voice and task-agent tool calls, and dev runs.
20
+ - `prerender.invalidate` takes full URLs as well as paths: `https://site-a.com/blog/x` purges that page on that host only, for an app whose sites have different content at one path. A path still purges the page on every host. App code isn't affected.
21
+ - `analytics` reads how pages were read and how visits went, recorded by `@mindstudio-ai/interface` 0.1.38:
22
+ - Metrics `timeOnPage` (seconds), `scrollDepth` (%), `visitDuration` (seconds) and `bounceRate` (%), each `null` rather than 0 when there's nothing to average. Time on page and scroll depth are lifetime, app-wide or per page; visit duration and bounce rate come from the last 90 days.
23
+ - Visit dimensions `entryPath`, `exitPath`, `visitReferrerHost`, `visitSourceCategory` and `visitUtmSource`…`visitUtmContent`, describing the whole visit a row belongs to. Grouping a custom event by `visitReferrerHost` gives its conversions by source.
24
+ - `prop:<key>` groups or filters custom events by a property, and the filter `visitEvent` keeps the visits that fired an event (`[['is', 'visitEvent', ['signup']]]` by `path` is the pages that led to signups).
25
+ - `orderBy` takes `visits` where the query carries it.
26
+ - `analytics.funnel({ steps, breakdown? })` counts visits through ordered steps (pages or events) and where they dropped off. `analytics.paths({ from?, depth? })` shows where visits went after a page and their commonest routes. Both follow a visitor across the apps sharing the host (an app's mounts) and count as 5 reads.
27
+ - An app that keeps its own visit records for any of these (a visit tracker, a webhook that records reads, its own funnel or journey tables) can read them from the platform instead and drop its own. Visit-level reads start when the platform began recording visits, and say so in `meta.clamped` and `meta.window.served`.
28
+
29
+ ### Changed behavior
30
+
31
+ - `session` is no longer set only for a caller's session: a run no caller started (cron, inbound email, a webhook) has one too, with `environment` and no `channel`. Check: code that took any `session` field being set to mean a voice or agent-chat call should check `session.channel` instead.
32
+
7
33
  ## 0.1.173
8
34
 
9
35
  ### New
package/dist/cli.js CHANGED
@@ -1368,6 +1368,26 @@ var init_context = __esm({
1368
1368
  }
1369
1369
  });
1370
1370
 
1371
+ // src/db/scanHints.ts
1372
+ function warnTableScans(scans) {
1373
+ if (!Array.isArray(scans)) {
1374
+ return;
1375
+ }
1376
+ for (const scan of scans) {
1377
+ if (typeof scan?.table !== "string" || typeof scan?.ms !== "number" || !Number.isFinite(scan.ms)) {
1378
+ continue;
1379
+ }
1380
+ console.warn(
1381
+ `[mindstudio] A query read every row of '${scan.table}' (${Math.round(scan.ms)} ms). An index on the columns it filters or sorts by (defineTable's indexes) would make it a lookup.`
1382
+ );
1383
+ }
1384
+ }
1385
+ var init_scanHints = __esm({
1386
+ "src/db/scanHints.ts"() {
1387
+ "use strict";
1388
+ }
1389
+ });
1390
+
1371
1391
  // src/db-ws.ts
1372
1392
  function isReadOnlySql(sql) {
1373
1393
  const head = sql.trimStart().slice(0, 8).toUpperCase();
@@ -1435,6 +1455,7 @@ function deliver(self, msg) {
1435
1455
  )
1436
1456
  );
1437
1457
  } else {
1458
+ warnTableScans(msg.scans);
1438
1459
  p.resolve(msg.results);
1439
1460
  }
1440
1461
  }
@@ -1629,6 +1650,7 @@ var DB_WS_SUBPROTOCOL, WS_ACK_TIMEOUT_MS, WS_IDLE_TIMEOUT_MS, WS_OPEN_TIMEOUT_MS
1629
1650
  var init_db_ws = __esm({
1630
1651
  "src/db-ws.ts"() {
1631
1652
  "use strict";
1653
+ init_scanHints();
1632
1654
  init_errors();
1633
1655
  DB_WS_SUBPROTOCOL = "ms-db-v2";
1634
1656
  WS_ACK_TIMEOUT_MS = 2e4;
@@ -5613,6 +5635,12 @@ function createAnalytics(call) {
5613
5635
  const res = await call("query-batch", { queries: specs });
5614
5636
  return res.results;
5615
5637
  },
5638
+ funnel(options) {
5639
+ return call("funnel", options);
5640
+ },
5641
+ paths(options) {
5642
+ return call("paths", options ?? {});
5643
+ },
5616
5644
  live() {
5617
5645
  return call("live", {});
5618
5646
  },
@@ -7598,6 +7626,7 @@ var init_client = __esm({
7598
7626
  init_sql();
7599
7627
  init_time();
7600
7628
  init_readBatching();
7629
+ init_scanHints();
7601
7630
  init_files();
7602
7631
  init_datasources();
7603
7632
  init_voice();
@@ -8690,10 +8719,11 @@ var init_client = __esm({
8690
8719
  }
8691
8720
  /**
8692
8721
  * The `analytics` namespace — read the app's own traffic + event analytics
8693
- * (auto-tracked pageviews, `analytics.track()` events). One general
8694
- * `query()` (metrics × dimensions × filters × time) plus `live()`,
8695
- * `sources()`, `map()`, `aiSources()`, `crawlers.*`. See {@link Analytics}
8696
- * for the lifetime-rollup vs 90-day-events split.
8722
+ * (auto-tracked pageviews and engagement, `analytics.track()` events). One
8723
+ * general `query()` (metrics × dimensions × filters × time) plus
8724
+ * `funnel()`, `paths()`, `live()`, `sources()`, `map()`, `aiSources()`,
8725
+ * `crawlers.*`. See {@link Analytics} for the lifetime-rollup vs
8726
+ * 90-day-events split.
8697
8727
  *
8698
8728
  * @example
8699
8729
  * ```ts
@@ -9077,6 +9107,7 @@ var init_client = __esm({
9077
9107
  throw new MindStudioError(`[db] ${message}`, code, res.status);
9078
9108
  }
9079
9109
  const data = await res.json();
9110
+ warnTableScans(data.scans);
9080
9111
  return data.results;
9081
9112
  }
9082
9113
  /**
@@ -9341,10 +9372,11 @@ var init_client = __esm({
9341
9372
  * page changes (e.g. a short URL's target). Omit `paths` (or pass an empty
9342
9373
  * array) to purge every snapshot for the app.
9343
9374
  *
9344
- * `paths` are this app's OWN route paths (`/u/abc`), whatever host the page is
9345
- * served on. If another app mounts this one under a path prefix, the copies
9346
- * cached at that prefix are purged too — no need to know or pass the mount
9347
- * path.
9375
+ * `paths` are this app's OWN route paths (`/u/abc`), which purge the page
9376
+ * whatever host it is served on, or full URLs (`https://site-a.com/u/abc`),
9377
+ * which purge it on that host only. If another app mounts this one under a
9378
+ * path prefix, the copies cached at that prefix are purged too — no need to
9379
+ * know or pass the mount path.
9348
9380
  *
9349
9381
  * Raw hook-token call (mirrors `reportIssue`) — the appId comes from the
9350
9382
  * token. Backend / managed-context only.
@@ -10035,7 +10067,7 @@ async function startMcpServer(options) {
10035
10067
  capabilities: { tools: {} },
10036
10068
  serverInfo: {
10037
10069
  name: "mindstudio-agent",
10038
- version: "0.1.173"
10070
+ version: "0.1.175"
10039
10071
  },
10040
10072
  instructions: 'Welcome to MindStudio \u2014 a platform with 200+ AI models, 850+ third-party integrations, and pre-built agents.\n\nGetting started:\n1. Call `ask` with any question about the SDK \u2014 it knows every action, model, and connector and returns working code with real model IDs and config options. Examples: ask("generate an image with FLUX"), ask("what models support vision?"), ask("how do I send a Slack message?").\n2. Call `changeName` to set your display name \u2014 use your name or whatever your user calls you. This is how you\'ll appear in MindStudio request logs.\n3. If you have a profile picture, pass its public image URL to `changeProfilePicture`.\n4. For manual browsing, call `listActions` to discover all available actions.\n\nThen use the tools to generate text, images, video, audio, search the web, work with data sources, run agents, and more.\n\nImportant:\n- AI-powered actions (text generation, image generation, video, audio, etc.) cost money. Before running these, call `estimateActionCost` and confirm with the user before proceeding \u2014 unless they\'ve explicitly told you to go ahead.\n- Not all agents from `listAgents` are configured for API use. Do not try to run an agent just because it appears in the list \u2014 it will likely fail. Only run agents the user specifically asks you to run.'
10041
10073
  });
@@ -11075,7 +11107,7 @@ function isNewerVersion(current, latest) {
11075
11107
  return false;
11076
11108
  }
11077
11109
  async function checkForUpdate() {
11078
- const currentVersion = "0.1.173";
11110
+ const currentVersion = "0.1.175";
11079
11111
  if (!currentVersion || process.env.MINDSTUDIO_NO_UPDATE_CHECK) {
11080
11112
  return null;
11081
11113
  }
@@ -11110,7 +11142,7 @@ async function checkForUpdate() {
11110
11142
  }
11111
11143
  }
11112
11144
  function printUpdateNotice(latestVersion) {
11113
- const currentVersion = "0.1.173";
11145
+ const currentVersion = "0.1.175";
11114
11146
  process.stderr.write(
11115
11147
  `
11116
11148
  ${ansi2.cyanBright("Update available")} ${ansi2.gray(currentVersion + " \u2192")} ${ansi2.cyanBold(latestVersion)}
@@ -11123,7 +11155,7 @@ function isStandaloneBinary() {
11123
11155
  return !argv1.includes("node_modules");
11124
11156
  }
11125
11157
  async function cmdUpdate() {
11126
- const currentVersion = "0.1.173";
11158
+ const currentVersion = "0.1.175";
11127
11159
  process.stderr.write(
11128
11160
  ` ${ansi2.gray("Current version:")} ${currentVersion}
11129
11161
  `
@@ -11264,7 +11296,7 @@ async function cmdLogin(options) {
11264
11296
  process.stderr.write("\n");
11265
11297
  printLogo();
11266
11298
  process.stderr.write("\n");
11267
- const ver = "0.1.173";
11299
+ const ver = "0.1.175";
11268
11300
  process.stderr.write(
11269
11301
  ` ${ansi2.bold("MindStudio Agent")} ${ver ? " " + ansi2.gray("v" + ver) : ""}
11270
11302
  `
@@ -11592,7 +11624,7 @@ async function main() {
11592
11624
  const updatePromise = command !== "mcp" && command !== "login" && command !== "update" ? checkForUpdate() : Promise.resolve(null);
11593
11625
  try {
11594
11626
  if (command === "version" || command === "-v") {
11595
- process.stdout.write("0.1.173\n");
11627
+ process.stdout.write("0.1.175\n");
11596
11628
  return;
11597
11629
  }
11598
11630
  if (command === "login") {
package/dist/index.d.ts CHANGED
@@ -1860,6 +1860,23 @@ interface DefineTableOptions<T = unknown> {
1860
1860
  * ```
1861
1861
  */
1862
1862
  unique?: (keyof T & string)[][];
1863
+ /**
1864
+ * Indexes for the table, for the columns its queries filter or sort by.
1865
+ * Each entry is an array of column names, most selective first; the
1866
+ * platform creates a plain (non-unique) SQLite index for each, and adds or
1867
+ * drops one in place when the list changes, without rebuilding the table.
1868
+ * An index makes a lookup on its columns read a few rows rather than the
1869
+ * whole table, and costs a little on every write, so declare the ones the
1870
+ * app's queries use.
1871
+ *
1872
+ * @example
1873
+ * ```ts
1874
+ * db.defineTable<Order>('orders', {
1875
+ * indexes: [['status'], ['customerId', 'createdAt']],
1876
+ * });
1877
+ * ```
1878
+ */
1879
+ indexes?: (keyof T & string)[][];
1863
1880
  /**
1864
1881
  * Default values for columns, applied client-side in `push()` and
1865
1882
  * `upsert()`. Explicit values in the input override defaults.
@@ -3527,8 +3544,26 @@ interface VoiceCallParams {
3527
3544
  assumeIdentity?: boolean;
3528
3545
  }
3529
3546
 
3530
- type AnalyticsMetric = 'pageviews' | 'visitors' | 'visits' | 'events';
3531
- type AnalyticsDimension = 'path' | 'referrerHost' | 'sourceCategory' | 'country' | 'city' | 'deviceType' | 'browser' | 'os' | 'language' | 'visitorType' | 'utmSource' | 'utmMedium' | 'utmCampaign' | 'utmTerm' | 'utmContent' | 'eventName';
3547
+ /**
3548
+ * Counts: `pageviews`, `visitors`, `visits`, `events`. Averages, `null` when
3549
+ * there's nothing to average: `timeOnPage` (seconds a page was actively read,
3550
+ * over the pages that reported), `scrollDepth` (% of the page, the deepest
3551
+ * each page reached), `visitDuration` (seconds of active reading per visit)
3552
+ * and `bounceRate` (% of visits with one pageview, no custom event and under
3553
+ * ten seconds active).
3554
+ */
3555
+ type AnalyticsMetric = AnalyticsCountMetric | AnalyticsAverageMetric;
3556
+ type AnalyticsCountMetric = 'pageviews' | 'visitors' | 'visits' | 'events';
3557
+ type AnalyticsAverageMetric = 'timeOnPage' | 'scrollDepth' | 'visitDuration' | 'bounceRate';
3558
+ /**
3559
+ * What a row is grouped or filtered by. The `visit…`, `entryPath` and
3560
+ * `exitPath` dimensions describe the whole visit a row belongs to: where it
3561
+ * entered and left, and its first source and campaign. `prop:<key>` is a
3562
+ * custom event's property (a key of letters, digits, `_`, `-` and `.`).
3563
+ */
3564
+ type AnalyticsDimension = 'path' | 'referrerHost' | 'sourceCategory' | 'country' | 'city' | 'deviceType' | 'browser' | 'os' | 'language' | 'visitorType' | 'utmSource' | 'utmMedium' | 'utmCampaign' | 'utmTerm' | 'utmContent' | 'eventName' | 'entryPath' | 'exitPath' | 'visitReferrerHost' | 'visitSourceCategory' | 'visitUtmSource' | 'visitUtmMedium' | 'visitUtmCampaign' | 'visitUtmTerm' | 'visitUtmContent' | `prop:${string}`;
3565
+ /** A filter only, never a group: the visit includes this custom event. */
3566
+ type AnalyticsFilterOnlyDimension = 'visitEvent';
3532
3567
  type AnalyticsFilterOp = 'is' | 'is_not' | 'contains';
3533
3568
  /**
3534
3569
  * `[op, dimension, values]`. `is` matches any of the values; `is_not`
@@ -3536,14 +3571,20 @@ type AnalyticsFilterOp = 'is' | 'is_not' | 'contains';
3536
3571
  * is case-insensitive substring. Only `is` filters can be served from the
3537
3572
  * lifetime rollup — the others read the 90-day event table. `city` filters
3538
3573
  * take plain city names (matching any country) and always read the 90-day
3539
- * event table.
3574
+ * event table. A filter on a visit dimension keeps the rows of visits that
3575
+ * match; `['is', 'visitEvent', ['signup']]` keeps those of visits that fired
3576
+ * `signup`, so grouping them by `path` gives the pages that led to it.
3540
3577
  */
3541
- type AnalyticsFilter = [AnalyticsFilterOp, AnalyticsDimension, string[]];
3578
+ type AnalyticsFilter = [
3579
+ AnalyticsFilterOp,
3580
+ AnalyticsDimension | AnalyticsFilterOnlyDimension,
3581
+ string[]
3582
+ ];
3542
3583
  type AnalyticsGranularity = '5m' | 'hour' | 'day' | 'week' | 'month';
3543
3584
  /** Shorthand ("30d", "all") or explicit `[startISO, endISO]`. Default "24h". */
3544
3585
  type AnalyticsDateRange = '1h' | '24h' | '7d' | '30d' | '90d' | 'all' | [string, string];
3545
3586
  interface AnalyticsQuerySpec {
3546
- /** At least one of: pageviews, visitors, visits, events. */
3587
+ /** At least one metric. */
3547
3588
  metrics: AnalyticsMetric[];
3548
3589
  /** At most one entity dimension OR `'time'` (not both, yet). */
3549
3590
  dimensions?: (AnalyticsDimension | 'time')[];
@@ -3557,8 +3598,11 @@ interface AnalyticsQuerySpec {
3557
3598
  timezone?: string;
3558
3599
  filters?: AnalyticsFilter[];
3559
3600
  dateRange?: AnalyticsDateRange;
3560
- /** Grouped queries only: one `['pageviews' | 'events', 'asc' | 'desc']`. */
3561
- orderBy?: ['pageviews' | 'events', 'asc' | 'desc'][];
3601
+ /**
3602
+ * Grouped queries only: one `['pageviews' | 'events' | 'visits', 'asc' |
3603
+ * 'desc']`, by a metric the query's shape carries.
3604
+ */
3605
+ orderBy?: ['pageviews' | 'events' | 'visits', 'asc' | 'desc'][];
3562
3606
  /** Grouped queries only. Default 25, max 1000. */
3563
3607
  limit?: number;
3564
3608
  offset?: number;
@@ -3568,8 +3612,11 @@ interface AnalyticsQuerySpec {
3568
3612
  interface AnalyticsQueryResultRow {
3569
3613
  /** Group keys: the entity dimension and/or `time` (bucket-start ISO). */
3570
3614
  dimensions: Record<string, string>;
3571
- /** Only the requested-and-available metrics appear. */
3572
- metrics: Partial<Record<AnalyticsMetric, number>>;
3615
+ /**
3616
+ * Only the requested-and-available metrics appear. An average with nothing
3617
+ * to average is `null`.
3618
+ */
3619
+ metrics: Partial<Record<AnalyticsCountMetric, number>> & Partial<Record<AnalyticsAverageMetric, number | null>>;
3573
3620
  }
3574
3621
  interface AnalyticsQueryResponse {
3575
3622
  results: AnalyticsQueryResultRow[];
@@ -3580,7 +3627,10 @@ interface AnalyticsQueryResponse {
3580
3627
  requested: [string, string];
3581
3628
  served: [string, string];
3582
3629
  };
3583
- /** True when an events-path window was cut to the retention horizon. */
3630
+ /**
3631
+ * True when an events-path window was cut: to the retention horizon, or
3632
+ * for a query about visits, to when the app's visits were first recorded.
3633
+ */
3584
3634
  clamped: boolean;
3585
3635
  /** Requested metrics this query shape can't carry. */
3586
3636
  metricsOmitted?: AnalyticsMetric[];
@@ -3596,6 +3646,84 @@ interface AnalyticsReadOptions {
3596
3646
  limit?: number;
3597
3647
  offset?: number;
3598
3648
  }
3649
+ /**
3650
+ * A funnel step: a page opened (`match: 'contains'` for any page whose path
3651
+ * contains the text), or a custom event fired, optionally with property
3652
+ * values it must carry.
3653
+ */
3654
+ type FunnelStep = {
3655
+ page: string;
3656
+ match?: 'is' | 'contains';
3657
+ } | {
3658
+ event: string;
3659
+ props?: Record<string, string | number | boolean>;
3660
+ };
3661
+ /** What `funnel` and `paths` report about the window and the apps they read. */
3662
+ interface VisitReadMeta {
3663
+ window: {
3664
+ requested: [string, string];
3665
+ served: [string, string];
3666
+ };
3667
+ /** True when the window was cut: to retention, or to when visits were first recorded. */
3668
+ clamped: boolean;
3669
+ /** The apps whose visits answered: this one, and those sharing its host (its mounts). */
3670
+ apps: string[];
3671
+ }
3672
+ interface FunnelOptions {
3673
+ /** 2 to 8 steps, each reached after the one before it within one visit. */
3674
+ steps: FunnelStep[];
3675
+ /** Split by something a visit has once: a visit dimension, `visitorType`, `deviceType`, `country`, `browser` or `os`. */
3676
+ breakdown?: AnalyticsDimension;
3677
+ dateRange?: AnalyticsDateRange;
3678
+ /** Pick visits: a visit is in when any of its rows matches every filter. */
3679
+ filters?: AnalyticsFilter[];
3680
+ releaseId?: string;
3681
+ }
3682
+ interface FunnelResult {
3683
+ steps: {
3684
+ step: FunnelStep;
3685
+ /** Visits that reached this step, having reached every one before it in order. */
3686
+ visits: number;
3687
+ /** Of those, the visits that didn't go on to the next step (0 on the last). */
3688
+ dropOff: number;
3689
+ }[];
3690
+ /** With `breakdown`: each value's visits at every step, its 25 largest. */
3691
+ breakdown?: {
3692
+ dimension: string;
3693
+ groups: {
3694
+ value: string | null;
3695
+ visits: number[];
3696
+ }[];
3697
+ };
3698
+ meta: VisitReadMeta;
3699
+ }
3700
+ interface PathsOptions {
3701
+ /** A page path: where visits went after it. Without it, only `routes`. */
3702
+ from?: string;
3703
+ /** How many opening pages a route has, 1 to 5. Default 3. */
3704
+ depth?: number;
3705
+ /** Rows in each list, 1 to 100. Default 10. */
3706
+ limit?: number;
3707
+ dateRange?: AnalyticsDateRange;
3708
+ /** Pick visits: a visit is in when any of its rows matches every filter. */
3709
+ filters?: AnalyticsFilter[];
3710
+ releaseId?: string;
3711
+ }
3712
+ interface PathsResult {
3713
+ /** Visits counted. */
3714
+ visits: number;
3715
+ /** With `from`: the page opened next, or `null` where the visit ended. */
3716
+ next?: {
3717
+ path: string | null;
3718
+ visits: number;
3719
+ }[];
3720
+ /** The commonest routes: each visit's first `depth` pages, a page repeated in a row counted once. */
3721
+ routes: {
3722
+ paths: string[];
3723
+ visits: number;
3724
+ }[];
3725
+ meta: VisitReadMeta;
3726
+ }
3599
3727
  interface LiveNow {
3600
3728
  /** Visitors on the app right now. */
3601
3729
  count: number;
@@ -3672,6 +3800,17 @@ interface Analytics {
3672
3800
  * batch (the error names its index).
3673
3801
  */
3674
3802
  batch(specs: AnalyticsQuerySpec[]): Promise<AnalyticsQueryResponse[]>;
3803
+ /**
3804
+ * How many visits went through the steps in order, and where they dropped
3805
+ * off. Follows a visitor across the apps sharing this one's host. Raw
3806
+ * events (90 days); counts as 5 reads against the limit.
3807
+ */
3808
+ funnel(options: FunnelOptions): Promise<FunnelResult>;
3809
+ /**
3810
+ * The routes visits took: where they went after a page, and the pages they
3811
+ * commonly opened with. Raw events (90 days); counts as 5 reads.
3812
+ */
3813
+ paths(options?: PathsOptions): Promise<PathsResult>;
3675
3814
  /** Who's on the app right now (Redis presence, no time window). */
3676
3815
  live(): Promise<LiveNow>;
3677
3816
  /**
@@ -5213,10 +5352,11 @@ declare class MindStudioAgent$1 {
5213
5352
  get files(): Files;
5214
5353
  /**
5215
5354
  * The `analytics` namespace — read the app's own traffic + event analytics
5216
- * (auto-tracked pageviews, `analytics.track()` events). One general
5217
- * `query()` (metrics × dimensions × filters × time) plus `live()`,
5218
- * `sources()`, `map()`, `aiSources()`, `crawlers.*`. See {@link Analytics}
5219
- * for the lifetime-rollup vs 90-day-events split.
5355
+ * (auto-tracked pageviews and engagement, `analytics.track()` events). One
5356
+ * general `query()` (metrics × dimensions × filters × time) plus
5357
+ * `funnel()`, `paths()`, `live()`, `sources()`, `map()`, `aiSources()`,
5358
+ * `crawlers.*`. See {@link Analytics} for the lifetime-rollup vs
5359
+ * 90-day-events split.
5220
5360
  *
5221
5361
  * @example
5222
5362
  * ```ts
@@ -5489,10 +5629,11 @@ declare class MindStudioAgent$1 {
5489
5629
  * page changes (e.g. a short URL's target). Omit `paths` (or pass an empty
5490
5630
  * array) to purge every snapshot for the app.
5491
5631
  *
5492
- * `paths` are this app's OWN route paths (`/u/abc`), whatever host the page is
5493
- * served on. If another app mounts this one under a path prefix, the copies
5494
- * cached at that prefix are purged too — no need to know or pass the mount
5495
- * path.
5632
+ * `paths` are this app's OWN route paths (`/u/abc`), which purge the page
5633
+ * whatever host it is served on, or full URLs (`https://site-a.com/u/abc`),
5634
+ * which purge it on that host only. If another app mounts this one under a
5635
+ * path prefix, the copies cached at that prefix are purged too — no need to
5636
+ * know or pass the mount path.
5496
5637
  *
5497
5638
  * Raw hook-token call (mirrors `reportIssue`) — the appId comes from the
5498
5639
  * token. Backend / managed-context only.
@@ -12638,10 +12779,27 @@ interface SessionContext {
12638
12779
  * Which surface invoked this method: `voice`/`agent` for conversational
12639
12780
  * tool calls (which carry their session/thread ids below), `web` for a
12640
12781
  * browser interface-session method call, `api` for an app-key or
12641
- * platform-key call. `web`/`api` carry only `visitorId`. Absent entirely
12642
- * on older platform versions.
12782
+ * platform-key call. `web`/`api` carry only `visitorId`. Absent on a run
12783
+ * no caller started (cron, inbound email, a webhook) and on older platform
12784
+ * versions.
12643
12785
  */
12644
- channel: 'voice' | 'agent' | 'web' | 'api';
12786
+ channel?: 'voice' | 'agent' | 'web' | 'api';
12787
+ /**
12788
+ * The host the request was served on: `example.com`, the app's
12789
+ * `<slug>.madewithremy.com`, a branch preview's host. Under another app's
12790
+ * mount it is that app's host, the site the visitor is on. Platform-resolved
12791
+ * from the host the request arrived at, so one app serving several sites can
12792
+ * key on it. Absent when the run came through no app host: cron, inbound
12793
+ * email, voice and task-agent tool calls, background runs, and dev.
12794
+ */
12795
+ host?: string;
12796
+ /**
12797
+ * Which world the run is in: `live` (the deployed app), `preview` (a branch
12798
+ * preview, on its own copy of the data) or `dev` (the editor's dev box,
12799
+ * whose file stores are live's). Present on every run on current platform
12800
+ * versions; use it to keep a dev run's fixed-key writes off what live reads.
12801
+ */
12802
+ environment?: 'live' | 'preview' | 'dev';
12645
12803
  /** Voice-session id — matches the browser voice client's `session.sessionId`. */
12646
12804
  voiceSessionId?: string;
12647
12805
  /** Agent-chat thread id. */
@@ -13313,16 +13471,18 @@ declare const events: Events;
13313
13471
  */
13314
13472
  declare const browser: Browser;
13315
13473
  /**
13316
- * Originating-session identity for this invocation — set when the method was
13317
- * triggered by a conversational surface (a voice call's tool use, an
13318
- * agent-chat tool use), absent on plain API/web/cron invocations.
13474
+ * What the platform knows about this invocation: which world it runs in
13475
+ * (`session.environment`, on every run), the host it was served on
13476
+ * (`session.host`), and who started it: `session.channel` with the voice
13477
+ * session, agent-chat thread or visitor behind it. A run no caller started
13478
+ * (cron, inbound email) has only `environment`.
13319
13479
  *
13320
13480
  * Values are platform-resolved and guaranteed (never model- or
13321
13481
  * client-supplied), so they're safe to key on: `session.voiceSessionId`
13322
13482
  * matches the browser voice client's `session.sessionId`, and
13323
13483
  * `session.visitorId` correlates anonymous sessions. Properties read from the
13324
13484
  * per-request context, so they're always this request's values — check
13325
- * `session.channel` to detect whether one is present.
13485
+ * `session.channel` to detect whether a caller's session is present.
13326
13486
  *
13327
13487
  * @example
13328
13488
  * ```ts
@@ -13336,6 +13496,11 @@ declare const browser: Browser;
13336
13496
  * }
13337
13497
  * return results;
13338
13498
  * }
13499
+ *
13500
+ * // One app serving several sites:
13501
+ * const site = await Sites.findOne((s, $) => s.host === $.host, {
13502
+ * host: session.host,
13503
+ * });
13339
13504
  * ```
13340
13505
  */
13341
13506
  declare const session: Readonly<Partial<SessionContext>>;
@@ -13404,14 +13569,17 @@ declare const reportIssue: (input: ReportIssueInput) => Promise<ReportedIssue>;
13404
13569
  * on their next visit. Bound to the default singleton. Backend / managed-context
13405
13570
  * only. Omit `paths` (or pass an empty array) to purge every snapshot.
13406
13571
  *
13407
- * Pass this app's own route paths; snapshots of those routes cached under
13408
- * another app's mount prefix are purged along with them.
13572
+ * Pass this app's own route paths, which purge the page on every host the app
13573
+ * is served on, or full URLs, which purge it on that host only (for an app
13574
+ * serving several sites). Snapshots of those routes cached under another app's
13575
+ * mount prefix are purged along with them.
13409
13576
  *
13410
13577
  * @example
13411
13578
  * ```ts
13412
13579
  * import { prerender } from '@mindstudio-ai/agent';
13413
13580
  *
13414
13581
  * await prerender.invalidate(['/u/abc']);
13582
+ * await prerender.invalidate(['https://site-a.com/blog/launch']);
13415
13583
  * ```
13416
13584
  *
13417
13585
  * @see {@link MindStudioAgent.invalidatePrerender}
@@ -13423,4 +13591,4 @@ declare const prerender: {
13423
13591
  };
13424
13592
 
13425
13593
  export { AuthContext, BrowserSession, HttpResponse, MAX_EVENT_PAYLOAD_CHARS, MindStudioAgent, MindStudioError, Query, RESPONSE_BODY_MAX_BYTES, RawQuery, Roles, Store, Table, analytics, auth, blockTypeAliases, browser, dataSources, db, mindstudio as default, defineJewel, defineMapper, defineReader, deletes, documents, email, events, files, getRequestContext, mindstudio, monacoSnippets, passthrough, prerender, reportIssue, resolveUser, respond, runWithContext, session, skip, stepMetadata, stream, voice, waitUntil };
13426
- export type { Accessor, ActiveCampaignAddNoteStepInput, ActiveCampaignAddNoteStepOutput, ActiveCampaignCreateContactStepInput, ActiveCampaignCreateContactStepOutput, AddSubtitlesToVideoStepInput, AddSubtitlesToVideoStepOutput, AddThumbnailToVideoStepInput, AddThumbnailToVideoStepOutput, AgentInfo, AgentOptions, AggregateRow, AggregateSelect, AggregateTerm, AiSourceVendor, AirtableCreateUpdateRecordStepInput, AirtableCreateUpdateRecordStepOutput, AirtableDeleteRecordStepInput, AirtableDeleteRecordStepOutput, AirtableGetRecordStepInput, AirtableGetRecordStepOutput, AirtableGetTableRecordsStepInput, AirtableGetTableRecordsStepOutput, Analytics, AnalyticsDateRange, AnalyticsDimension, AnalyticsFilter, AnalyticsFilterOp, AnalyticsGranularity, AnalyticsMetric, AnalyticsQueryResponse, AnalyticsQueryResultRow, AnalyticsQuerySpec, AnalyticsReadOptions, AnalyzeImageStepInput, AnalyzeImageStepOutput, AnalyzeVideoStepInput, AnalyzeVideoStepOutput, AppAuthContext, AppContextResult, AppDatabase, AppDatabaseColumnSchema, AppDatabaseTable, AppRoleAssignment, AuthTableConfig, BatchStepInput, BatchStepResult, Batchable, Browser, BrowserBox, BrowserElementResult, BrowserOpenOptions, BrowserPage, BrowserScreenshot, BrowserStoredScreenshot, BrowserTarget, BrowserToolsOptions, BrowserViewport, CaptureThumbnailStepInput, CaptureThumbnailStepOutput, CheckAppRoleStepInput, CheckAppRoleStepOutput, CodaCreateUpdatePageStepInput, CodaCreateUpdatePageStepOutput, CodaCreateUpdateRowStepInput, CodaCreateUpdateRowStepOutput, CodaFindRowStepInput, CodaFindRowStepOutput, CodaGetPageStepInput, CodaGetPageStepOutput, CodaGetTableRowsStepInput, CodaGetTableRowsStepOutput, Connection, ConnectorActionDetail, ConnectorService, ConvertPdfToImagesStepInput, ConvertPdfToImagesStepOutput, CrawlerBucket, CrawlerHit, CrawlerOverview, CreateDataSourceStepInput, CreateDataSourceStepOutput, CreateGmailDraftStepInput, CreateGmailDraftStepOutput, CreateGoogleCalendarEventStepInput, CreateGoogleCalendarEventStepOutput, CreateGoogleDocStepInput, CreateGoogleDocStepOutput, CreateGoogleSheetStepInput, CreateGoogleSheetStepOutput, Db, DecomposeImageStepInput, DecomposeImageStepOutput, DefineStoreOptions, DefineTableOptions, DeleteDataSourceDocumentStepInput, DeleteDataSourceDocumentStepOutput, DeleteDataSourceStepInput, DeleteDataSourceStepOutput, DeleteGmailEmailStepInput, DeleteGmailEmailStepOutput, DeleteGoogleCalendarEventStepInput, DeleteGoogleCalendarEventStepOutput, DeleteGoogleSheetRowsStepInput, DeleteGoogleSheetRowsStepOutput, DetectChangesStepInput, DetectChangesStepOutput, DetectPIIStepInput, DetectPIIStepOutput, DownloadVideoStepInput, DownloadVideoStepOutput, EnhanceImageGenerationPromptStepInput, EnhanceImageGenerationPromptStepOutput, EnhanceVideoGenerationPromptStepInput, EnhanceVideoGenerationPromptStepOutput, EnrichPersonStepInput, EnrichPersonStepOutput, EvaluateDecisionStepInput, EvaluateDecisionStepOutput, EventGrantOptions, EventGrantResult, Events, ExecuteStepBatchOptions, ExecuteStepBatchResult, ExtractAudioFromVideoStepInput, ExtractAudioFromVideoStepOutput, ExtractTextStepInput, ExtractTextStepOutput, FetchDataSourceDocumentStepInput, FetchDataSourceDocumentStepOutput, FetchGoogleDocStepInput, FetchGoogleDocStepOutput, FetchGoogleSheetStepInput, FetchGoogleSheetStepOutput, FetchSlackChannelHistoryStepInput, FetchSlackChannelHistoryStepOutput, FetchYoutubeCaptionsStepInput, FetchYoutubeCaptionsStepOutput, FetchYoutubeChannelStepInput, FetchYoutubeChannelStepOutput, FetchYoutubeCommentsStepInput, FetchYoutubeCommentsStepOutput, FetchYoutubeVideoStepInput, FetchYoutubeVideoStepOutput, FileAccess, Files, FromSchema, Generate3dModelStepInput, Generate3dModelStepOutput, GenerateAssetStepInput, GenerateAssetStepOutput, GenerateImageStepInput, GenerateImageStepOutput, GenerateLipsyncStepInput, GenerateLipsyncStepOutput, GenerateMusicStepInput, GenerateMusicStepOutput, GeneratePdfStepInput, GeneratePdfStepOutput, GenerateSoundStepInput, GenerateSoundStepOutput, GenerateStaticVideoFromImageStepInput, GenerateStaticVideoFromImageStepOutput, GenerateTextStepInput, GenerateTextStepOutput, GenerateVideoStepInput, GenerateVideoStepOutput, GetGmailAttachmentsStepInput, GetGmailAttachmentsStepOutput, GetGmailDraftStepInput, GetGmailDraftStepOutput, GetGmailEmailStepInput, GetGmailEmailStepOutput, GetGmailUnreadCountStepInput, GetGmailUnreadCountStepOutput, GetGoogleCalendarEventStepInput, GetGoogleCalendarEventStepOutput, GetGoogleDriveFileStepInput, GetGoogleDriveFileStepOutput, GetGoogleSheetInfoStepInput, GetGoogleSheetInfoStepOutput, GetMediaMetadataStepInput, GetMediaMetadataStepOutput, GetStreamOptions, HttpResponseFile, HttpResponseHeaders, HttpResponseInit, HttpResponseOptions, HubspotCreateCompanyStepInput, HubspotCreateCompanyStepOutput, HubspotCreateContactStepInput, HubspotCreateContactStepOutput, HubspotGetCompanyStepInput, HubspotGetCompanyStepOutput, HubspotGetContactStepInput, HubspotGetContactStepOutput, HunterApiCompanyEnrichmentStepInput, HunterApiCompanyEnrichmentStepOutput, HunterApiDomainSearchStepInput, HunterApiDomainSearchStepOutput, HunterApiEmailFinderStepInput, HunterApiEmailFinderStepOutput, HunterApiEmailVerificationStepInput, HunterApiEmailVerificationStepOutput, HunterApiPersonEnrichmentStepInput, HunterApiPersonEnrichmentStepOutput, ImageFaceSwapStepInput, ImageFaceSwapStepOutput, ImageRemoveWatermarkStepInput, ImageRemoveWatermarkStepOutput, ImportFromUrlStepInput, ImportFromUrlStepOutput, InsertVideoClipsStepInput, InsertVideoClipsStepOutput, Jewel, JewelConfig, JewelGradeContext, JewelMethod, JewelMethodInput, JewelPairRecord, JewelProposal, JewelProposeOutcome, JewelProposeResult, JewelQueueItem, JewelQueueResolution, JewelQueueResolveResult, JewelRunParams, JewelVerdict, JewelsApi, JsonObjectSchema, JsonSchema, JsonSchemaTypeName, ListAgentsResult, ListDataSourcesStepInput, ListDataSourcesStepOutput, ListGmailDraftsStepInput, ListGmailDraftsStepOutput, ListGmailLabelsStepInput, ListGmailLabelsStepOutput, ListGoogleCalendarEventsStepInput, ListGoogleCalendarEventsStepOutput, ListGoogleDriveFilesStepInput, ListGoogleDriveFilesStepOutput, ListOptions, ListRecentGmailEmailsStepInput, ListRecentGmailEmailsStepOutput, LiveNow, LogicStepInput, LogicStepOutput, MakeDotComRunScenarioStepInput, MakeDotComRunScenarioStepOutput, MapObject, MapOutcome, MapPoint, MapRunObject, MapRunOutcome, MapRunParams, MapRunRecord, MapRunResult, MappedDocument, Mapper, MapperConfig, MergeAudioStepInput, MergeAudioStepOutput, MergeVideosStepInput, MergeVideosStepOutput, MeshyAnimateStepInput, MeshyAnimateStepOutput, MeshyImageTo3dStepInput, MeshyImageTo3dStepOutput, MeshyRemeshStepInput, MeshyRemeshStepOutput, MeshyRigStepInput, MeshyRigStepOutput, MeshyTextTo3dStepInput, MeshyTextTo3dStepOutput, MeshyTextureStepInput, MeshyTextureStepOutput, MindStudioModel, MindStudioModelSummary, MixAudioIntoVideoStepInput, MixAudioIntoVideoStepOutput, ModelType, MonacoSnippet, MonacoSnippetField, MonacoSnippetFieldType, MuteVideoStepInput, MuteVideoStepOutput, N8nRunNodeStepInput, N8nRunNodeStepOutput, NotionCreatePageStepInput, NotionCreatePageStepOutput, NotionUpdatePageStepInput, NotionUpdatePageStepOutput, PackagedWorkflow, PackagedWorkflowInput, PackagedWorkflowSignature, PeopleSearchStepInput, PeopleSearchStepOutput, PostToLinkedInStepInput, PostToLinkedInStepOutput, PostToSlackChannelStepInput, PostToSlackChannelStepOutput, PostToXStepInput, PostToXStepOutput, PostToZapierStepInput, PostToZapierStepOutput, Predicate, PushInput, PutOptions, PutStream, QueryDataSourceStepInput, QueryDataSourceStepOutput, QueryExternalDatabaseStepInput, QueryExternalDatabaseStepOutput, QuickbooksApiRequestStepInput, QuickbooksApiRequestStepOutput, ReadDelivery, ReadRunParams, ReadRunRecord, ReadRunResult, Reader, ReaderConfig, ReaderDocument, RedactPIIStepInput, RedactPIIStepOutput, RemoveBackgroundFromImageStepInput, RemoveBackgroundFromImageStepOutput, RenderVideoFromHtmlCompositionStepInput, RenderVideoFromHtmlCompositionStepOutput, ReplyToGmailEmailStepInput, ReplyToGmailEmailStepOutput, ReportIssueInput, ReportedIssue, RequestContext, ResizeVideoStepInput, ResizeVideoStepOutput, ResolvedUser, RunAgentOptions, RunAgentResult, RunFfmpegStepInput, RunFfmpegStepOutput, RunFromConnectorRegistryStepInput, RunFromConnectorRegistryStepOutput, RunTaskOptions, RunTaskOptionsWithExample, RunTaskOptionsWithSchema, RunTaskResult, SchemaValidationError, ScrapeLinkedInCompanyStepInput, ScrapeLinkedInCompanyStepOutput, ScrapeLinkedInProfileStepInput, ScrapeLinkedInProfileStepOutput, ScrapeUrlStepInput, ScrapeUrlStepOutput, ScrapeXPostStepInput, ScrapeXPostStepOutput, ScrapeXProfileStepInput, ScrapeXProfileStepOutput, ScreenshotUrlStepInput, ScreenshotUrlStepOutput, SearchGmailEmailsStepInput, SearchGmailEmailsStepOutput, SearchGoogleCalendarEventsStepInput, SearchGoogleCalendarEventsStepOutput, SearchGoogleDriveStepInput, SearchGoogleDriveStepOutput, SearchGoogleImagesStepInput, SearchGoogleImagesStepOutput, SearchGoogleNewsStepInput, SearchGoogleNewsStepOutput, SearchGoogleStepInput, SearchGoogleStepOutput, SearchGoogleTrendsStepInput, SearchGoogleTrendsStepOutput, SearchPerplexityStepInput, SearchPerplexityStepOutput, SearchXPostsStepInput, SearchXPostsStepOutput, SearchYoutubeStepInput, SearchYoutubeStepOutput, SearchYoutubeTrendsStepInput, SearchYoutubeTrendsStepOutput, SendEmailStepInput, SendEmailStepOutput, SendGmailDraftStepInput, SendGmailDraftStepOutput, SendGmailMessageStepInput, SendGmailMessageStepOutput, SendSMSStepInput, SendSMSStepOutput, SendSlackDirectMessageStepInput, SendSlackDirectMessageStepOutput, SessionContext, SetGmailReadStatusStepInput, SetGmailReadStatusStepOutput, SetRunTitleStepInput, SetRunTitleStepOutput, SetVariableStepInput, SetVariableStepOutput, SettableSystemColumns, StepCostEstimateEntry, StepExecutionMeta, StepExecutionOptions, StepExecutionResult, StepInputMap, StepLogEvent, StepMetadata, StepMethods, StepName, StepOutputMap, StoredFile, SystemFields, TaskEvent, TaskToolCall, TaskToolConfig, TaskUsage, TextToSpeechStepInput, TextToSpeechStepOutput, TopSource, TranscribeAudioStepInput, TranscribeAudioStepOutput, TrimMediaStepInput, TrimMediaStepOutput, TypesafeEvaluateStepInput, TypesafeEvaluateStepOutput, UpdateGmailLabelsStepInput, UpdateGmailLabelsStepOutput, UpdateGoogleCalendarEventStepInput, UpdateGoogleCalendarEventStepOutput, UpdateGoogleDocStepInput, UpdateGoogleDocStepOutput, UpdateGoogleSheetStepInput, UpdateGoogleSheetStepOutput, UpdateInput, UploadDataSourceDocumentStepInput, UploadDataSourceDocumentStepOutput, UploadFileResult, UploadToken, UpscaleImageStepInput, UpscaleImageStepOutput, UpscaleVideoStepInput, UpscaleVideoStepOutput, User, UserInfoResult, UserMessageStepInput, UserMessageStepOutput, VideoFaceSwapStepInput, VideoFaceSwapStepOutput, VideoRemoveBackgroundStepInput, VideoRemoveBackgroundStepOutput, VideoRemoveWatermarkStepInput, VideoRemoveWatermarkStepOutput, Voice, VoiceCallParams, VoiceCallResult, WatermarkImageStepInput, WatermarkImageStepOutput, WatermarkVideoStepInput, WatermarkVideoStepOutput, YouDotComFinanceResearchStepInput, YouDotComFinanceResearchStepOutput, YouDotComGetPageContentStepInput, YouDotComGetPageContentStepOutput, YouDotComLiveNewsStepInput, YouDotComLiveNewsStepOutput, YouDotComWebResearchStepInput, YouDotComWebResearchStepOutput, YouDotComWebSearchStepInput, YouDotComWebSearchStepOutput };
13594
+ export type { Accessor, ActiveCampaignAddNoteStepInput, ActiveCampaignAddNoteStepOutput, ActiveCampaignCreateContactStepInput, ActiveCampaignCreateContactStepOutput, AddSubtitlesToVideoStepInput, AddSubtitlesToVideoStepOutput, AddThumbnailToVideoStepInput, AddThumbnailToVideoStepOutput, AgentInfo, AgentOptions, AggregateRow, AggregateSelect, AggregateTerm, AiSourceVendor, AirtableCreateUpdateRecordStepInput, AirtableCreateUpdateRecordStepOutput, AirtableDeleteRecordStepInput, AirtableDeleteRecordStepOutput, AirtableGetRecordStepInput, AirtableGetRecordStepOutput, AirtableGetTableRecordsStepInput, AirtableGetTableRecordsStepOutput, Analytics, AnalyticsAverageMetric, AnalyticsCountMetric, AnalyticsDateRange, AnalyticsDimension, AnalyticsFilter, AnalyticsFilterOnlyDimension, AnalyticsFilterOp, AnalyticsGranularity, AnalyticsMetric, AnalyticsQueryResponse, AnalyticsQueryResultRow, AnalyticsQuerySpec, AnalyticsReadOptions, AnalyzeImageStepInput, AnalyzeImageStepOutput, AnalyzeVideoStepInput, AnalyzeVideoStepOutput, AppAuthContext, AppContextResult, AppDatabase, AppDatabaseColumnSchema, AppDatabaseTable, AppRoleAssignment, AuthTableConfig, BatchStepInput, BatchStepResult, Batchable, Browser, BrowserBox, BrowserElementResult, BrowserOpenOptions, BrowserPage, BrowserScreenshot, BrowserStoredScreenshot, BrowserTarget, BrowserToolsOptions, BrowserViewport, CaptureThumbnailStepInput, CaptureThumbnailStepOutput, CheckAppRoleStepInput, CheckAppRoleStepOutput, CodaCreateUpdatePageStepInput, CodaCreateUpdatePageStepOutput, CodaCreateUpdateRowStepInput, CodaCreateUpdateRowStepOutput, CodaFindRowStepInput, CodaFindRowStepOutput, CodaGetPageStepInput, CodaGetPageStepOutput, CodaGetTableRowsStepInput, CodaGetTableRowsStepOutput, Connection, ConnectorActionDetail, ConnectorService, ConvertPdfToImagesStepInput, ConvertPdfToImagesStepOutput, CrawlerBucket, CrawlerHit, CrawlerOverview, CreateDataSourceStepInput, CreateDataSourceStepOutput, CreateGmailDraftStepInput, CreateGmailDraftStepOutput, CreateGoogleCalendarEventStepInput, CreateGoogleCalendarEventStepOutput, CreateGoogleDocStepInput, CreateGoogleDocStepOutput, CreateGoogleSheetStepInput, CreateGoogleSheetStepOutput, Db, DecomposeImageStepInput, DecomposeImageStepOutput, DefineStoreOptions, DefineTableOptions, DeleteDataSourceDocumentStepInput, DeleteDataSourceDocumentStepOutput, DeleteDataSourceStepInput, DeleteDataSourceStepOutput, DeleteGmailEmailStepInput, DeleteGmailEmailStepOutput, DeleteGoogleCalendarEventStepInput, DeleteGoogleCalendarEventStepOutput, DeleteGoogleSheetRowsStepInput, DeleteGoogleSheetRowsStepOutput, DetectChangesStepInput, DetectChangesStepOutput, DetectPIIStepInput, DetectPIIStepOutput, DownloadVideoStepInput, DownloadVideoStepOutput, EnhanceImageGenerationPromptStepInput, EnhanceImageGenerationPromptStepOutput, EnhanceVideoGenerationPromptStepInput, EnhanceVideoGenerationPromptStepOutput, EnrichPersonStepInput, EnrichPersonStepOutput, EvaluateDecisionStepInput, EvaluateDecisionStepOutput, EventGrantOptions, EventGrantResult, Events, ExecuteStepBatchOptions, ExecuteStepBatchResult, ExtractAudioFromVideoStepInput, ExtractAudioFromVideoStepOutput, ExtractTextStepInput, ExtractTextStepOutput, FetchDataSourceDocumentStepInput, FetchDataSourceDocumentStepOutput, FetchGoogleDocStepInput, FetchGoogleDocStepOutput, FetchGoogleSheetStepInput, FetchGoogleSheetStepOutput, FetchSlackChannelHistoryStepInput, FetchSlackChannelHistoryStepOutput, FetchYoutubeCaptionsStepInput, FetchYoutubeCaptionsStepOutput, FetchYoutubeChannelStepInput, FetchYoutubeChannelStepOutput, FetchYoutubeCommentsStepInput, FetchYoutubeCommentsStepOutput, FetchYoutubeVideoStepInput, FetchYoutubeVideoStepOutput, FileAccess, Files, FromSchema, FunnelOptions, FunnelResult, FunnelStep, Generate3dModelStepInput, Generate3dModelStepOutput, GenerateAssetStepInput, GenerateAssetStepOutput, GenerateImageStepInput, GenerateImageStepOutput, GenerateLipsyncStepInput, GenerateLipsyncStepOutput, GenerateMusicStepInput, GenerateMusicStepOutput, GeneratePdfStepInput, GeneratePdfStepOutput, GenerateSoundStepInput, GenerateSoundStepOutput, GenerateStaticVideoFromImageStepInput, GenerateStaticVideoFromImageStepOutput, GenerateTextStepInput, GenerateTextStepOutput, GenerateVideoStepInput, GenerateVideoStepOutput, GetGmailAttachmentsStepInput, GetGmailAttachmentsStepOutput, GetGmailDraftStepInput, GetGmailDraftStepOutput, GetGmailEmailStepInput, GetGmailEmailStepOutput, GetGmailUnreadCountStepInput, GetGmailUnreadCountStepOutput, GetGoogleCalendarEventStepInput, GetGoogleCalendarEventStepOutput, GetGoogleDriveFileStepInput, GetGoogleDriveFileStepOutput, GetGoogleSheetInfoStepInput, GetGoogleSheetInfoStepOutput, GetMediaMetadataStepInput, GetMediaMetadataStepOutput, GetStreamOptions, HttpResponseFile, HttpResponseHeaders, HttpResponseInit, HttpResponseOptions, HubspotCreateCompanyStepInput, HubspotCreateCompanyStepOutput, HubspotCreateContactStepInput, HubspotCreateContactStepOutput, HubspotGetCompanyStepInput, HubspotGetCompanyStepOutput, HubspotGetContactStepInput, HubspotGetContactStepOutput, HunterApiCompanyEnrichmentStepInput, HunterApiCompanyEnrichmentStepOutput, HunterApiDomainSearchStepInput, HunterApiDomainSearchStepOutput, HunterApiEmailFinderStepInput, HunterApiEmailFinderStepOutput, HunterApiEmailVerificationStepInput, HunterApiEmailVerificationStepOutput, HunterApiPersonEnrichmentStepInput, HunterApiPersonEnrichmentStepOutput, ImageFaceSwapStepInput, ImageFaceSwapStepOutput, ImageRemoveWatermarkStepInput, ImageRemoveWatermarkStepOutput, ImportFromUrlStepInput, ImportFromUrlStepOutput, InsertVideoClipsStepInput, InsertVideoClipsStepOutput, Jewel, JewelConfig, JewelGradeContext, JewelMethod, JewelMethodInput, JewelPairRecord, JewelProposal, JewelProposeOutcome, JewelProposeResult, JewelQueueItem, JewelQueueResolution, JewelQueueResolveResult, JewelRunParams, JewelVerdict, JewelsApi, JsonObjectSchema, JsonSchema, JsonSchemaTypeName, ListAgentsResult, ListDataSourcesStepInput, ListDataSourcesStepOutput, ListGmailDraftsStepInput, ListGmailDraftsStepOutput, ListGmailLabelsStepInput, ListGmailLabelsStepOutput, ListGoogleCalendarEventsStepInput, ListGoogleCalendarEventsStepOutput, ListGoogleDriveFilesStepInput, ListGoogleDriveFilesStepOutput, ListOptions, ListRecentGmailEmailsStepInput, ListRecentGmailEmailsStepOutput, LiveNow, LogicStepInput, LogicStepOutput, MakeDotComRunScenarioStepInput, MakeDotComRunScenarioStepOutput, MapObject, MapOutcome, MapPoint, MapRunObject, MapRunOutcome, MapRunParams, MapRunRecord, MapRunResult, MappedDocument, Mapper, MapperConfig, MergeAudioStepInput, MergeAudioStepOutput, MergeVideosStepInput, MergeVideosStepOutput, MeshyAnimateStepInput, MeshyAnimateStepOutput, MeshyImageTo3dStepInput, MeshyImageTo3dStepOutput, MeshyRemeshStepInput, MeshyRemeshStepOutput, MeshyRigStepInput, MeshyRigStepOutput, MeshyTextTo3dStepInput, MeshyTextTo3dStepOutput, MeshyTextureStepInput, MeshyTextureStepOutput, MindStudioModel, MindStudioModelSummary, MixAudioIntoVideoStepInput, MixAudioIntoVideoStepOutput, ModelType, MonacoSnippet, MonacoSnippetField, MonacoSnippetFieldType, MuteVideoStepInput, MuteVideoStepOutput, N8nRunNodeStepInput, N8nRunNodeStepOutput, NotionCreatePageStepInput, NotionCreatePageStepOutput, NotionUpdatePageStepInput, NotionUpdatePageStepOutput, PackagedWorkflow, PackagedWorkflowInput, PackagedWorkflowSignature, PathsOptions, PathsResult, PeopleSearchStepInput, PeopleSearchStepOutput, PostToLinkedInStepInput, PostToLinkedInStepOutput, PostToSlackChannelStepInput, PostToSlackChannelStepOutput, PostToXStepInput, PostToXStepOutput, PostToZapierStepInput, PostToZapierStepOutput, Predicate, PushInput, PutOptions, PutStream, QueryDataSourceStepInput, QueryDataSourceStepOutput, QueryExternalDatabaseStepInput, QueryExternalDatabaseStepOutput, QuickbooksApiRequestStepInput, QuickbooksApiRequestStepOutput, ReadDelivery, ReadRunParams, ReadRunRecord, ReadRunResult, Reader, ReaderConfig, ReaderDocument, RedactPIIStepInput, RedactPIIStepOutput, RemoveBackgroundFromImageStepInput, RemoveBackgroundFromImageStepOutput, RenderVideoFromHtmlCompositionStepInput, RenderVideoFromHtmlCompositionStepOutput, ReplyToGmailEmailStepInput, ReplyToGmailEmailStepOutput, ReportIssueInput, ReportedIssue, RequestContext, ResizeVideoStepInput, ResizeVideoStepOutput, ResolvedUser, RunAgentOptions, RunAgentResult, RunFfmpegStepInput, RunFfmpegStepOutput, RunFromConnectorRegistryStepInput, RunFromConnectorRegistryStepOutput, RunTaskOptions, RunTaskOptionsWithExample, RunTaskOptionsWithSchema, RunTaskResult, SchemaValidationError, ScrapeLinkedInCompanyStepInput, ScrapeLinkedInCompanyStepOutput, ScrapeLinkedInProfileStepInput, ScrapeLinkedInProfileStepOutput, ScrapeUrlStepInput, ScrapeUrlStepOutput, ScrapeXPostStepInput, ScrapeXPostStepOutput, ScrapeXProfileStepInput, ScrapeXProfileStepOutput, ScreenshotUrlStepInput, ScreenshotUrlStepOutput, SearchGmailEmailsStepInput, SearchGmailEmailsStepOutput, SearchGoogleCalendarEventsStepInput, SearchGoogleCalendarEventsStepOutput, SearchGoogleDriveStepInput, SearchGoogleDriveStepOutput, SearchGoogleImagesStepInput, SearchGoogleImagesStepOutput, SearchGoogleNewsStepInput, SearchGoogleNewsStepOutput, SearchGoogleStepInput, SearchGoogleStepOutput, SearchGoogleTrendsStepInput, SearchGoogleTrendsStepOutput, SearchPerplexityStepInput, SearchPerplexityStepOutput, SearchXPostsStepInput, SearchXPostsStepOutput, SearchYoutubeStepInput, SearchYoutubeStepOutput, SearchYoutubeTrendsStepInput, SearchYoutubeTrendsStepOutput, SendEmailStepInput, SendEmailStepOutput, SendGmailDraftStepInput, SendGmailDraftStepOutput, SendGmailMessageStepInput, SendGmailMessageStepOutput, SendSMSStepInput, SendSMSStepOutput, SendSlackDirectMessageStepInput, SendSlackDirectMessageStepOutput, SessionContext, SetGmailReadStatusStepInput, SetGmailReadStatusStepOutput, SetRunTitleStepInput, SetRunTitleStepOutput, SetVariableStepInput, SetVariableStepOutput, SettableSystemColumns, StepCostEstimateEntry, StepExecutionMeta, StepExecutionOptions, StepExecutionResult, StepInputMap, StepLogEvent, StepMetadata, StepMethods, StepName, StepOutputMap, StoredFile, SystemFields, TaskEvent, TaskToolCall, TaskToolConfig, TaskUsage, TextToSpeechStepInput, TextToSpeechStepOutput, TopSource, TranscribeAudioStepInput, TranscribeAudioStepOutput, TrimMediaStepInput, TrimMediaStepOutput, TypesafeEvaluateStepInput, TypesafeEvaluateStepOutput, UpdateGmailLabelsStepInput, UpdateGmailLabelsStepOutput, UpdateGoogleCalendarEventStepInput, UpdateGoogleCalendarEventStepOutput, UpdateGoogleDocStepInput, UpdateGoogleDocStepOutput, UpdateGoogleSheetStepInput, UpdateGoogleSheetStepOutput, UpdateInput, UploadDataSourceDocumentStepInput, UploadDataSourceDocumentStepOutput, UploadFileResult, UploadToken, UpscaleImageStepInput, UpscaleImageStepOutput, UpscaleVideoStepInput, UpscaleVideoStepOutput, User, UserInfoResult, UserMessageStepInput, UserMessageStepOutput, VideoFaceSwapStepInput, VideoFaceSwapStepOutput, VideoRemoveBackgroundStepInput, VideoRemoveBackgroundStepOutput, VideoRemoveWatermarkStepInput, VideoRemoveWatermarkStepOutput, VisitReadMeta, Voice, VoiceCallParams, VoiceCallResult, WatermarkImageStepInput, WatermarkImageStepOutput, WatermarkVideoStepInput, WatermarkVideoStepOutput, YouDotComFinanceResearchStepInput, YouDotComFinanceResearchStepOutput, YouDotComGetPageContentStepInput, YouDotComGetPageContentStepOutput, YouDotComLiveNewsStepInput, YouDotComLiveNewsStepOutput, YouDotComWebResearchStepInput, YouDotComWebResearchStepOutput, YouDotComWebSearchStepInput, YouDotComWebSearchStepOutput };