@malloy-publisher/sdk 0.0.205 → 0.0.206

package/dist/client/api.d.ts

@@ -169,13 +169,88 @@ export interface BigqueryConnection {
     'queryTimeoutMilliseconds'?: string;
 }
 /**
- * Manifest mapping BuildIDs to materialized table names
+ *
+ * @export
+ * @interface BuildGraph
+ */
+export interface BuildGraph {
+    /**
+     *
+     * @type {string}
+     * @memberof BuildGraph
+     */
+    'connectionName': string;
+    /**
+     * Leveled build nodes; each inner array is one parallelizable level, levels run in order.
+     * @type {Array<Array<BuildNode>>}
+     * @memberof BuildGraph
+     */
+    'nodes': Array<Array<BuildNode>>;
+}
+/**
+ *
+ * @export
+ * @interface BuildInstruction
+ */
+export interface BuildInstruction {
+    /**
+     * Identifies which planned source this instruction is for (matches PersistSourcePlan.buildId).
+     * @type {string}
+     * @memberof BuildInstruction
+     */
+    'buildId': string;
+    /**
+     * Optional convenience echo of \"sourceName@modelURL\"; buildId is authoritative.
+     * @type {string}
+     * @memberof BuildInstruction
+     */
+    'sourceID'?: string;
+    /**
+     * CP-assigned surrogate id for the materialized table about to be produced.
+     * @type {string}
+     * @memberof BuildInstruction
+     */
+    'materializedTableId': string;
+    /**
+     * Fully-qualified, dialect-quoted table name to create. The publisher writes here verbatim.
+     * @type {string}
+     * @memberof BuildInstruction
+     */
+    'physicalTableName': string;
+    /**
+     *
+     * @type {Realization}
+     * @memberof BuildInstruction
+     */
+    'realization': Realization;
+}
+/**
+ * Round 2 input. Per-source instructions assigned by the control plane.
+ * @export
+ * @interface BuildInstructions
+ */
+export interface BuildInstructions {
+    /**
+     *
+     * @type {Array<BuildInstruction>}
+     * @memberof BuildInstructions
+     */
+    'sources': Array<BuildInstruction>;
+}
+/**
+ * Round 2 output. Maps each buildId a build produced to its physical table. Returned inline; the control plane persists it.
  * @export
  * @interface BuildManifest
  */
 export interface BuildManifest {
     /**
-     * Map of BuildID to manifest entry
+     *
+     * @type {string}
+     * @memberof BuildManifest
+     */
+    'builtAt'?: string;
+    /**
+     * Map of buildId to manifest entry.
      * @type {{ [key: string]: ManifestEntry; }}
      * @memberof BuildManifest
      */
@@ -183,12 +258,52 @@ export interface BuildManifest {
         [key: string]: ManifestEntry;
     };
     /**
-     * Whether the manifest is in strict mode
+     * Whether unresolved references should error.
      * @type {boolean}
      * @memberof BuildManifest
      */
     'strict'?: boolean;
 }
+/**
+ *
+ * @export
+ * @interface BuildNode
+ */
+export interface BuildNode {
+    /**
+     * sourceName@modelURL
+     * @type {string}
+     * @memberof BuildNode
+     */
+    'sourceID': string;
+    /**
+     * Upstream sourceIDs in this graph.
+     * @type {Array<string>}
+     * @memberof BuildNode
+     */
+    'dependsOn'?: Array<string>;
+}
+/**
+ * Round 1 output. Mirrors Malloy\'s native build plan plus the minimal per-source detail the control plane needs in v0 to assign identity/naming/realization. Lineage, policy, and connection capability are intentionally omitted until they carry real data.
+ * @export
+ * @interface BuildPlan
+ */
+export interface BuildPlan {
+    /**
+     * Dependency-ordered build graphs, one per connection.
+     * @type {Array<BuildGraph>}
+     * @memberof BuildPlan
+     */
+    'graphs': Array<BuildGraph>;
+    /**
+     * Map of sourceID (\"sourceName@modelURL\") to per-source plan.
+     * @type {{ [key: string]: PersistSourcePlan; }}
+     * @memberof BuildPlan
+     */
+    'sources': {
+        [key: string]: PersistSourcePlan;
+    };
+}
 /**
  * Database column definition
  * @export
@@ -561,23 +676,29 @@ export interface CreateConnection409Response {
     'error'?: string;
 }
 /**
- * Options for creating a materialization
+ * Options for starting a materialization. Auto-run by default; opt into the two-round control-plane-driven flow with pauseBetweenPhases.
  * @export
  * @interface CreateMaterializationRequest
  */
 export interface CreateMaterializationRequest {
     /**
-     * If true, forces rebuild of all sources even if their BuildID is unchanged
+     * When false (default) the publisher runs all phases in one pass — self-assigns table names (the \"#@ persist name=\" value, else the source name), builds with realization=COPY, assembles the manifest, and auto-loads it into the package models. When true it pauses at BUILD_PLAN_READY for the control plane to send Round 2 build instructions.
      * @type {boolean}
      * @memberof CreateMaterializationRequest
      */
-    'forceRefresh'?: boolean;
+    'pauseBetweenPhases'?: boolean;
     /**
-     * If true, automatically reloads the manifest into the Malloy Runtime after a successful materialization
+     * Build a new table even when a source\'s buildId is unchanged.
      * @type {boolean}
      * @memberof CreateMaterializationRequest
      */
-    'autoLoadManifest'?: boolean;
+    'forceRefresh'?: boolean;
+    /**
+     * Restrict the plan/build to these persist source names. Omit = all persist sources.
+     * @type {Array<string>}
+     * @memberof CreateMaterializationRequest
+     */
+    'sourceNames'?: Array<string>;
 }
 /**
  * Embedded database within a Malloy package
@@ -782,31 +903,6 @@ export interface Environment {
      * @memberof Environment
      */
     'packages'?: Array<Package>;
-    /**
-     *
-     * @type {EnvironmentMaterializationStorage}
-     * @memberof Environment
-     */
-    'materializationStorage'?: EnvironmentMaterializationStorage;
-}
-/**
- * Optional DuckLake-backed storage for materialization manifests (orchestrated mode). When set, manifests are stored in a shared DuckLake catalog instead of the local DuckDB database.
- * @export
- * @interface EnvironmentMaterializationStorage
- */
-export interface EnvironmentMaterializationStorage {
-    /**
-     * PostgreSQL connection URL for the DuckLake catalog metadata store
-     * @type {string}
-     * @memberof EnvironmentMaterializationStorage
-     */
-    'catalogUrl'?: string;
-    /**
-     * Cloud storage path (s3:// or gs://) for DuckLake data files
-     * @type {string}
-     * @memberof EnvironmentMaterializationStorage
-     */
-    'dataPath'?: string;
 }
 /**
  * **DEPRECATED**: Use the `Given` schema (native Malloy runtime parameters) instead. See docs/givens.md for migration recipes.  A filter declared via #(filter) annotation on a Malloy source.
@@ -986,20 +1082,56 @@ export interface LogMessageRangeStart {
     'character'?: number;
 }
 /**
- * A single entry in the build manifest
+ * A single entry in the build manifest.
  * @export
  * @interface ManifestEntry
  */
 export interface ManifestEntry {
     /**
-     * Name of the materialized table
+     *
+     * @type {string}
+     * @memberof ManifestEntry
+     */
+    'buildId': string;
+    /**
+     *
+     * @type {string}
+     * @memberof ManifestEntry
+     */
+    'sourceName'?: string;
+    /**
+     * Echoes the CP-assigned id from the BuildInstruction.
+     * @type {string}
+     * @memberof ManifestEntry
+     */
+    'materializedTableId'?: string;
+    /**
+     * Name of the materialized table.
      * @type {string}
      * @memberof ManifestEntry
      */
-    'tableName'?: string;
+    'physicalTableName': string;
+    /**
+     *
+     * @type {string}
+     * @memberof ManifestEntry
+     */
+    'connectionName'?: string;
+    /**
+     *
+     * @type {Realization}
+     * @memberof ManifestEntry
+     */
+    'realization'?: Realization;
+    /**
+     *
+     * @type {number}
+     * @memberof ManifestEntry
+     */
+    'rowCount'?: number | null;
 }
 /**
- * A record of a package materialization
+ * A record of one two-round materialization run for a package.
  * @export
  * @interface Materialization
  */
@@ -1022,12 +1154,30 @@ export interface Materialization {
      * @memberof Materialization
      */
     'packageName'?: string;
+    /**
+     * Echoes the create-time flag. False (default) = auto-run all phases; true = pause at BUILD_PLAN_READY for control-plane-driven Round 2.
+     * @type {boolean}
+     * @memberof Materialization
+     */
+    'pauseBetweenPhases'?: boolean;
     /**
      *
-     * @type {string}
+     * @type {MaterializationStatus}
      * @memberof Materialization
      */
-    'status'?: MaterializationStatusEnum;
+    'status'?: MaterializationStatus;
+    /**
+     *
+     * @type {BuildPlan}
+     * @memberof Materialization
+     */
+    'buildPlan'?: BuildPlan | null;
+    /**
+     *
+     * @type {BuildManifest}
+     * @memberof Materialization
+     */
+    'manifest'?: BuildManifest | null;
     /**
      *
      * @type {string}
@@ -1065,14 +1215,20 @@ export interface Materialization {
      */
     'updatedAt'?: string;
 }
-export declare const MaterializationStatusEnum: {
+/**
+ * Phase-aware status of a two-round materialization run.
+ * @export
+ * @enum {string}
+ */
+export declare const MaterializationStatus: {
     readonly Pending: "PENDING";
-    readonly Running: "RUNNING";
-    readonly Success: "SUCCESS";
+    readonly BuildPlanReady: "BUILD_PLAN_READY";
+    readonly ManifestRowsReady: "MANIFEST_ROWS_READY";
+    readonly ManifestFileReady: "MANIFEST_FILE_READY";
     readonly Failed: "FAILED";
     readonly Cancelled: "CANCELLED";
 };
-export type MaterializationStatusEnum = typeof MaterializationStatusEnum[keyof typeof MaterializationStatusEnum];
+export type MaterializationStatus = typeof MaterializationStatus[keyof typeof MaterializationStatus];
 /**
  * Malloy model metadata and status information
  * @export
@@ -1312,7 +1468,36 @@ export interface Package {
      * @memberof Package
      */
     'location'?: string;
+    /**
+     * Optional opt-in for curated discovery. When present, only these model file paths (relative to the package root) are listed via `listModels()`, and within-file discovery is filtered to each model\'s `export {}` closure. When absent or empty, every model is listed with its full source set (backward-compatible). Every other .malloy file still compiles for import/join resolution but is hidden from listings once `explores` is declared. Notebooks are always listed regardless of this field.
+     * @type {Array<string>}
+     * @memberof Package
+     */
+    'explores'?: Array<string>;
+    /**
+     * Actionable messages for declared explores that do not resolve to a real model in this package (e.g. a misspelled path, or a notebook listed as an explore). Server-computed and read-only: it is ignored on create/update requests and only ever returned in responses. Present only when there are such problems. Loading is fail-safe — the unresolved entry simply lists nothing rather than exposing everything — so this is the signal that a package is misconfigured; publishing such a package is rejected.
+     * @type {Array<string>}
+     * @memberof Package
+     */
+    'exploresWarnings'?: Array<string>;
+    /**
+     * Controls whether the discovery surface is also a query boundary. `\"declared\"` (the default) makes queryable == discoverable: when `explores` is declared, only `explores` model files — and within them only the `export {}` closure — are valid top-level query targets; every other source still compiles, imports, joins, and extends but is not directly queryable (denied with 404). `\"all\"` decouples them: `explores`/`export {}` gate discovery only and every compiled source stays directly queryable. When `explores` is absent there is no curated surface, so both modes are equivalent (everything queryable). Invalid values fall back to `\"declared\"`. Identity-based access is a separate concern — see `#(authorize)`.
+     * @type {string}
+     * @memberof Package
+     */
+    'queryableSources'?: PackageQueryableSourcesEnum;
+    /**
+     * URI (gs:// or s3://) of the control-plane-computed manifest for this package. On (re)load the worker reads it and binds persist references (buildId -> physicalTableName). Null = serve live.
+     * @type {string}
+     * @memberof Package
+     */
+    'manifestLocation'?: string | null;
 }
+export declare const PackageQueryableSourcesEnum: {
+    readonly Declared: "declared";
+    readonly All: "all";
+};
+export type PackageQueryableSourcesEnum = typeof PackageQueryableSourcesEnum[keyof typeof PackageQueryableSourcesEnum];
 /**
  * Static HTML page (in-package data app) within a Malloy package
  * @export
@@ -1344,6 +1529,55 @@ export interface Page {
      */
     'title'?: string;
 }
+/**
+ *
+ * @export
+ * @interface PersistSourcePlan
+ */
+export interface PersistSourcePlan {
+    /**
+     *
+     * @type {string}
+     * @memberof PersistSourcePlan
+     */
+    'name': string;
+    /**
+     *
+     * @type {string}
+     * @memberof PersistSourcePlan
+     */
+    'sourceID': string;
+    /**
+     *
+     * @type {string}
+     * @memberof PersistSourcePlan
+     */
+    'connectionName': string;
+    /**
+     *
+     * @type {string}
+     * @memberof PersistSourcePlan
+     */
+    'dialect'?: string;
+    /**
+     * hash(connectionDigest + canonical logical SQL).
+     * @type {string}
+     * @memberof PersistSourcePlan
+     */
+    'buildId': string;
+    /**
+     * The source\'s build SQL (with the build manifest applied for upstream rewrites).
+     * @type {string}
+     * @memberof PersistSourcePlan
+     */
+    'sql': string;
+    /**
+     * Output schema of the source.
+     * @type {Array<Column>}
+     * @memberof PersistSourcePlan
+     */
+    'columns': Array<Column>;
+}
 /**
  *
  * @export
@@ -1598,6 +1832,16 @@ export interface RawNotebook {
      */
     'sources'?: Array<Source>;
 }
+/**
+ * SNAPSHOT = warehouse clone/snapshot; COPY = CREATE TABLE AS SELECT.
+ * @export
+ * @enum {string}
+ */
+export declare const Realization: {
+    readonly Snapshot: "SNAPSHOT";
+    readonly Copy: "COPY";
+};
+export type Realization = typeof Realization[keyof typeof Realization];
 /**
  * AWS S3 connection configuration for DuckDB
  * @export
@@ -1902,31 +2146,6 @@ export interface TableDescription {
      */
     'columns'?: Array<Column>;
 }
-/**
- *
- * @export
- * @interface TableSource
- */
-export interface TableSource {
-    /**
-     * Resource path to the table source.
-     * @type {string}
-     * @memberof TableSource
-     */
-    'resource'?: string;
-    /**
-     *
-     * @type {string}
-     * @memberof TableSource
-     */
-    'source'?: string;
-    /**
-     * Table fields
-     * @type {Array<Column>}
-     * @memberof TableSource
-     */
-    'columns'?: Array<Column>;
-}
 /**
  *
  * @export
@@ -2133,29 +2352,6 @@ export declare const ConnectionsApiAxiosParamCreator: (configuration?: Configura
      * @throws {RequiredError}
      */
     getConnection: (environmentName: string, connectionName: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
-    /**
-     * **DEPRECATED**: This endpoint is deprecated and may be removed in future versions. Use the POST version instead for better security and functionality.  Creates a Malloy source from a SQL statement using the specified connection. The SQL statement is executed to generate a source definition that can be used in Malloy models.
-     * @summary Get SQL source (deprecated)
-     * @param {string} environmentName Name of the environment
-     * @param {string} connectionName Name of the connection
-     * @param {string} [sqlStatement] SQL statement
-     * @param {*} [options] Override http request option.
-     * @deprecated
-     * @throws {RequiredError}
-     */
-    getSqlsource: (environmentName: string, connectionName: string, sqlStatement?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
-    /**
-     * **DEPRECATED**: Use the POST version instead.  Creates a Malloy source from a SQL statement using the specified connection, resolved in the context of the named package.
-     * @summary Get SQL source (per-package, deprecated)
-     * @param {string} environmentName Name of the environment
-     * @param {string} packageName Name of the package whose connection context to use
-     * @param {string} connectionName Name of the connection
-     * @param {string} [sqlStatement] SQL statement
-     * @param {*} [options] Override http request option.
-     * @deprecated
-     * @throws {RequiredError}
-     */
-    getSqlsourceInPackage: (environmentName: string, packageName: string, connectionName: string, sqlStatement?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Retrieves a table from the specified database schema. This endpoint is useful for discovering available data sources and exploring the database structure. The schema must exist in the connection for this operation to succeed. The tablePath is the full path to the table, including the schema name.
      * @summary Get table details from database
@@ -2179,29 +2375,6 @@ export declare const ConnectionsApiAxiosParamCreator: (configuration?: Configura
      * @throws {RequiredError}
      */
     getTableInPackage: (environmentName: string, packageName: string, connectionName: string, schemaName: string, tablePath: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
-    /**
-     * **DEPRECATED**: This endpoint is deprecated and may be removed in future versions. Use the POST version instead for better security and functionality.  Creates a temporary table from a SQL statement using the specified connection. Temporary tables are useful for storing intermediate results during complex queries.
-     * @summary Create temporary table (deprecated)
-     * @param {string} environmentName Name of the environment
-     * @param {string} connectionName Name of the connection
-     * @param {string} [sqlStatement] SQL statement
-     * @param {*} [options] Override http request option.
-     * @deprecated
-     * @throws {RequiredError}
-     */
-    getTemporarytable: (environmentName: string, connectionName: string, sqlStatement?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
-    /**
-     * **DEPRECATED**: Use the POST version instead.  Creates a temporary table from a SQL statement using the specified connection, resolved in the context of the named package.
-     * @summary Create temporary table (per-package, deprecated)
-     * @param {string} environmentName Name of the environment
-     * @param {string} packageName Name of the package whose connection context to use
-     * @param {string} connectionName Name of the connection
-     * @param {string} [sqlStatement] SQL statement
-     * @param {*} [options] Override http request option.
-     * @deprecated
-     * @throws {RequiredError}
-     */
-    getTemporarytableInPackage: (environmentName: string, packageName: string, connectionName: string, sqlStatement?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Retrieves a list of all database connections configured for the specified environment. Each connection includes its configuration, type, and status information. This endpoint is useful for discovering available data sources within an environment.
      * @summary List environment database connections
@@ -2258,11 +2431,10 @@ export declare const ConnectionsApiAxiosParamCreator: (configuration?: Configura
      * @param {string} environmentName Name of the environment
      * @param {string} connectionName Name of the connection
      * @param {PostQuerydataRequest} postQuerydataRequest SQL statement to execute
-     * @param {string} [_options] Options (deprecated; pass in body instead)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    postQuerydata: (environmentName: string, connectionName: string, postQuerydataRequest: PostQuerydataRequest, _options?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    postQuerydata: (environmentName: string, connectionName: string, postQuerydataRequest: PostQuerydataRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Executes a SQL statement against the specified database connection, resolved in the context of the named package, and returns the results.  Subject to the same PUBLISHER_MAX_QUERY_ROWS row cap as the environment-level sqlQuery endpoint.
      * @summary Execute SQL query (per-package)
@@ -2270,11 +2442,10 @@ export declare const ConnectionsApiAxiosParamCreator: (configuration?: Configura
      * @param {string} packageName Name of the package whose connection context to use
      * @param {string} connectionName Name of the connection
      * @param {PostQuerydataRequest} postQuerydataRequest SQL statement to execute
-     * @param {string} [_options] Options (deprecated; pass in body instead)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    postQuerydataInPackage: (environmentName: string, packageName: string, connectionName: string, postQuerydataRequest: PostQuerydataRequest, _options?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    postQuerydataInPackage: (environmentName: string, packageName: string, connectionName: string, postQuerydataRequest: PostQuerydataRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Creates a Malloy source from a SQL statement using the specified database connection. The SQL statement is executed to generate a source definition that can be used in Malloy models.
      * @summary Create SQL source from statement
@@ -2361,29 +2532,6 @@ export declare const ConnectionsApiFp: (configuration?: Configuration) => {
      * @throws {RequiredError}
      */
     getConnection(environmentName: string, connectionName: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Connection>>;
-    /**
-     * **DEPRECATED**: This endpoint is deprecated and may be removed in future versions. Use the POST version instead for better security and functionality.  Creates a Malloy source from a SQL statement using the specified connection. The SQL statement is executed to generate a source definition that can be used in Malloy models.
-     * @summary Get SQL source (deprecated)
-     * @param {string} environmentName Name of the environment
-     * @param {string} connectionName Name of the connection
-     * @param {string} [sqlStatement] SQL statement
-     * @param {*} [options] Override http request option.
-     * @deprecated
-     * @throws {RequiredError}
-     */
-    getSqlsource(environmentName: string, connectionName: string, sqlStatement?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<SqlSource>>;
-    /**
-     * **DEPRECATED**: Use the POST version instead.  Creates a Malloy source from a SQL statement using the specified connection, resolved in the context of the named package.
-     * @summary Get SQL source (per-package, deprecated)
-     * @param {string} environmentName Name of the environment
-     * @param {string} packageName Name of the package whose connection context to use
-     * @param {string} connectionName Name of the connection
-     * @param {string} [sqlStatement] SQL statement
-     * @param {*} [options] Override http request option.
-     * @deprecated
-     * @throws {RequiredError}
-     */
-    getSqlsourceInPackage(environmentName: string, packageName: string, connectionName: string, sqlStatement?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<SqlSource>>;
     /**
      * Retrieves a table from the specified database schema. This endpoint is useful for discovering available data sources and exploring the database structure. The schema must exist in the connection for this operation to succeed. The tablePath is the full path to the table, including the schema name.
      * @summary Get table details from database
@@ -2407,29 +2555,6 @@ export declare const ConnectionsApiFp: (configuration?: Configuration) => {
      * @throws {RequiredError}
      */
     getTableInPackage(environmentName: string, packageName: string, connectionName: string, schemaName: string, tablePath: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Table>>;
-    /**
-     * **DEPRECATED**: This endpoint is deprecated and may be removed in future versions. Use the POST version instead for better security and functionality.  Creates a temporary table from a SQL statement using the specified connection. Temporary tables are useful for storing intermediate results during complex queries.
-     * @summary Create temporary table (deprecated)
-     * @param {string} environmentName Name of the environment
-     * @param {string} connectionName Name of the connection
-     * @param {string} [sqlStatement] SQL statement
-     * @param {*} [options] Override http request option.
-     * @deprecated
-     * @throws {RequiredError}
-     */
-    getTemporarytable(environmentName: string, connectionName: string, sqlStatement?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<TemporaryTable>>;
-    /**
-     * **DEPRECATED**: Use the POST version instead.  Creates a temporary table from a SQL statement using the specified connection, resolved in the context of the named package.
-     * @summary Create temporary table (per-package, deprecated)
-     * @param {string} environmentName Name of the environment
-     * @param {string} packageName Name of the package whose connection context to use
-     * @param {string} connectionName Name of the connection
-     * @param {string} [sqlStatement] SQL statement
-     * @param {*} [options] Override http request option.
-     * @deprecated
-     * @throws {RequiredError}
-     */
-    getTemporarytableInPackage(environmentName: string, packageName: string, connectionName: string, sqlStatement?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<TemporaryTable>>;
     /**
      * Retrieves a list of all database connections configured for the specified environment. Each connection includes its configuration, type, and status information. This endpoint is useful for discovering available data sources within an environment.
      * @summary List environment database connections
@@ -2486,11 +2611,10 @@ export declare const ConnectionsApiFp: (configuration?: Configuration) => {
      * @param {string} environmentName Name of the environment
      * @param {string} connectionName Name of the connection
      * @param {PostQuerydataRequest} postQuerydataRequest SQL statement to execute
-     * @param {string} [_options] Options (deprecated; pass in body instead)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    postQuerydata(environmentName: string, connectionName: string, postQuerydataRequest: PostQuerydataRequest, _options?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<QueryData>>;
+    postQuerydata(environmentName: string, connectionName: string, postQuerydataRequest: PostQuerydataRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<QueryData>>;
     /**
      * Executes a SQL statement against the specified database connection, resolved in the context of the named package, and returns the results.  Subject to the same PUBLISHER_MAX_QUERY_ROWS row cap as the environment-level sqlQuery endpoint.
      * @summary Execute SQL query (per-package)
@@ -2498,11 +2622,10 @@ export declare const ConnectionsApiFp: (configuration?: Configuration) => {
      * @param {string} packageName Name of the package whose connection context to use
      * @param {string} connectionName Name of the connection
      * @param {PostQuerydataRequest} postQuerydataRequest SQL statement to execute
-     * @param {string} [_options] Options (deprecated; pass in body instead)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    postQuerydataInPackage(environmentName: string, packageName: string, connectionName: string, postQuerydataRequest: PostQuerydataRequest, _options?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<QueryData>>;
+    postQuerydataInPackage(environmentName: string, packageName: string, connectionName: string, postQuerydataRequest: PostQuerydataRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<QueryData>>;
     /**
      * Creates a Malloy source from a SQL statement using the specified database connection. The SQL statement is executed to generate a source definition that can be used in Malloy models.
      * @summary Create SQL source from statement
@@ -2589,29 +2712,6 @@ export declare const ConnectionsApiFactory: (configuration?: Configuration, base
      * @throws {RequiredError}
      */
     getConnection(environmentName: string, connectionName: string, options?: RawAxiosRequestConfig): AxiosPromise<Connection>;
-    /**
-     * **DEPRECATED**: This endpoint is deprecated and may be removed in future versions. Use the POST version instead for better security and functionality.  Creates a Malloy source from a SQL statement using the specified connection. The SQL statement is executed to generate a source definition that can be used in Malloy models.
-     * @summary Get SQL source (deprecated)
-     * @param {string} environmentName Name of the environment
-     * @param {string} connectionName Name of the connection
-     * @param {string} [sqlStatement] SQL statement
-     * @param {*} [options] Override http request option.
-     * @deprecated
-     * @throws {RequiredError}
-     */
-    getSqlsource(environmentName: string, connectionName: string, sqlStatement?: string, options?: RawAxiosRequestConfig): AxiosPromise<SqlSource>;
-    /**
-     * **DEPRECATED**: Use the POST version instead.  Creates a Malloy source from a SQL statement using the specified connection, resolved in the context of the named package.
-     * @summary Get SQL source (per-package, deprecated)
-     * @param {string} environmentName Name of the environment
-     * @param {string} packageName Name of the package whose connection context to use
-     * @param {string} connectionName Name of the connection
-     * @param {string} [sqlStatement] SQL statement
-     * @param {*} [options] Override http request option.
-     * @deprecated
-     * @throws {RequiredError}
-     */
-    getSqlsourceInPackage(environmentName: string, packageName: string, connectionName: string, sqlStatement?: string, options?: RawAxiosRequestConfig): AxiosPromise<SqlSource>;
     /**
      * Retrieves a table from the specified database schema. This endpoint is useful for discovering available data sources and exploring the database structure. The schema must exist in the connection for this operation to succeed. The tablePath is the full path to the table, including the schema name.
      * @summary Get table details from database
@@ -2635,29 +2735,6 @@ export declare const ConnectionsApiFactory: (configuration?: Configuration, base
      * @throws {RequiredError}
      */
     getTableInPackage(environmentName: string, packageName: string, connectionName: string, schemaName: string, tablePath: string, options?: RawAxiosRequestConfig): AxiosPromise<Table>;
-    /**
-     * **DEPRECATED**: This endpoint is deprecated and may be removed in future versions. Use the POST version instead for better security and functionality.  Creates a temporary table from a SQL statement using the specified connection. Temporary tables are useful for storing intermediate results during complex queries.
-     * @summary Create temporary table (deprecated)
-     * @param {string} environmentName Name of the environment
-     * @param {string} connectionName Name of the connection
-     * @param {string} [sqlStatement] SQL statement
-     * @param {*} [options] Override http request option.
-     * @deprecated
-     * @throws {RequiredError}
-     */
-    getTemporarytable(environmentName: string, connectionName: string, sqlStatement?: string, options?: RawAxiosRequestConfig): AxiosPromise<TemporaryTable>;
-    /**
-     * **DEPRECATED**: Use the POST version instead.  Creates a temporary table from a SQL statement using the specified connection, resolved in the context of the named package.
-     * @summary Create temporary table (per-package, deprecated)
-     * @param {string} environmentName Name of the environment
-     * @param {string} packageName Name of the package whose connection context to use
-     * @param {string} connectionName Name of the connection
-     * @param {string} [sqlStatement] SQL statement
-     * @param {*} [options] Override http request option.
-     * @deprecated
-     * @throws {RequiredError}
-     */
-    getTemporarytableInPackage(environmentName: string, packageName: string, connectionName: string, sqlStatement?: string, options?: RawAxiosRequestConfig): AxiosPromise<TemporaryTable>;
     /**
      * Retrieves a list of all database connections configured for the specified environment. Each connection includes its configuration, type, and status information. This endpoint is useful for discovering available data sources within an environment.
      * @summary List environment database connections
@@ -2714,11 +2791,10 @@ export declare const ConnectionsApiFactory: (configuration?: Configuration, base
      * @param {string} environmentName Name of the environment
      * @param {string} connectionName Name of the connection
      * @param {PostQuerydataRequest} postQuerydataRequest SQL statement to execute
-     * @param {string} [_options] Options (deprecated; pass in body instead)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    postQuerydata(environmentName: string, connectionName: string, postQuerydataRequest: PostQuerydataRequest, _options?: string, options?: RawAxiosRequestConfig): AxiosPromise<QueryData>;
+    postQuerydata(environmentName: string, connectionName: string, postQuerydataRequest: PostQuerydataRequest, options?: RawAxiosRequestConfig): AxiosPromise<QueryData>;
     /**
      * Executes a SQL statement against the specified database connection, resolved in the context of the named package, and returns the results.  Subject to the same PUBLISHER_MAX_QUERY_ROWS row cap as the environment-level sqlQuery endpoint.
      * @summary Execute SQL query (per-package)
@@ -2726,11 +2802,10 @@ export declare const ConnectionsApiFactory: (configuration?: Configuration, base
      * @param {string} packageName Name of the package whose connection context to use
      * @param {string} connectionName Name of the connection
      * @param {PostQuerydataRequest} postQuerydataRequest SQL statement to execute
-     * @param {string} [_options] Options (deprecated; pass in body instead)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    postQuerydataInPackage(environmentName: string, packageName: string, connectionName: string, postQuerydataRequest: PostQuerydataRequest, _options?: string, options?: RawAxiosRequestConfig): AxiosPromise<QueryData>;
+    postQuerydataInPackage(environmentName: string, packageName: string, connectionName: string, postQuerydataRequest: PostQuerydataRequest, options?: RawAxiosRequestConfig): AxiosPromise<QueryData>;
     /**
      * Creates a Malloy source from a SQL statement using the specified database connection. The SQL statement is executed to generate a source definition that can be used in Malloy models.
      * @summary Create SQL source from statement
@@ -2822,31 +2897,6 @@ export declare class ConnectionsApi extends BaseAPI {
      * @memberof ConnectionsApi
      */
     getConnection(environmentName: string, connectionName: string, options?: RawAxiosRequestConfig): Promise< AxiosResponse<Connection, any, {}>>;
-    /**
-     * **DEPRECATED**: This endpoint is deprecated and may be removed in future versions. Use the POST version instead for better security and functionality.  Creates a Malloy source from a SQL statement using the specified connection. The SQL statement is executed to generate a source definition that can be used in Malloy models.
-     * @summary Get SQL source (deprecated)
-     * @param {string} environmentName Name of the environment
-     * @param {string} connectionName Name of the connection
-     * @param {string} [sqlStatement] SQL statement
-     * @param {*} [options] Override http request option.
-     * @deprecated
-     * @throws {RequiredError}
-     * @memberof ConnectionsApi
-     */
-    getSqlsource(environmentName: string, connectionName: string, sqlStatement?: string, options?: RawAxiosRequestConfig): Promise< AxiosResponse<SqlSource, any, {}>>;
-    /**
-     * **DEPRECATED**: Use the POST version instead.  Creates a Malloy source from a SQL statement using the specified connection, resolved in the context of the named package.
-     * @summary Get SQL source (per-package, deprecated)
-     * @param {string} environmentName Name of the environment
-     * @param {string} packageName Name of the package whose connection context to use
-     * @param {string} connectionName Name of the connection
-     * @param {string} [sqlStatement] SQL statement
-     * @param {*} [options] Override http request option.
-     * @deprecated
-     * @throws {RequiredError}
-     * @memberof ConnectionsApi
-     */
-    getSqlsourceInPackage(environmentName: string, packageName: string, connectionName: string, sqlStatement?: string, options?: RawAxiosRequestConfig): Promise< AxiosResponse<SqlSource, any, {}>>;
     /**
      * Retrieves a table from the specified database schema. This endpoint is useful for discovering available data sources and exploring the database structure. The schema must exist in the connection for this operation to succeed. The tablePath is the full path to the table, including the schema name.
      * @summary Get table details from database
@@ -2872,31 +2922,6 @@ export declare class ConnectionsApi extends BaseAPI {
      * @memberof ConnectionsApi
      */
     getTableInPackage(environmentName: string, packageName: string, connectionName: string, schemaName: string, tablePath: string, options?: RawAxiosRequestConfig): Promise< AxiosResponse<Table, any, {}>>;
-    /**
-     * **DEPRECATED**: This endpoint is deprecated and may be removed in future versions. Use the POST version instead for better security and functionality.  Creates a temporary table from a SQL statement using the specified connection. Temporary tables are useful for storing intermediate results during complex queries.
-     * @summary Create temporary table (deprecated)
-     * @param {string} environmentName Name of the environment
-     * @param {string} connectionName Name of the connection
-     * @param {string} [sqlStatement] SQL statement
-     * @param {*} [options] Override http request option.
-     * @deprecated
-     * @throws {RequiredError}
-     * @memberof ConnectionsApi
-     */
-    getTemporarytable(environmentName: string, connectionName: string, sqlStatement?: string, options?: RawAxiosRequestConfig): Promise< AxiosResponse<TemporaryTable, any, {}>>;
-    /**
-     * **DEPRECATED**: Use the POST version instead.  Creates a temporary table from a SQL statement using the specified connection, resolved in the context of the named package.
-     * @summary Create temporary table (per-package, deprecated)
-     * @param {string} environmentName Name of the environment
-     * @param {string} packageName Name of the package whose connection context to use
-     * @param {string} connectionName Name of the connection
-     * @param {string} [sqlStatement] SQL statement
-     * @param {*} [options] Override http request option.
-     * @deprecated
-     * @throws {RequiredError}
-     * @memberof ConnectionsApi
-     */
-    getTemporarytableInPackage(environmentName: string, packageName: string, connectionName: string, sqlStatement?: string, options?: RawAxiosRequestConfig): Promise< AxiosResponse<TemporaryTable, any, {}>>;
     /**
      * Retrieves a list of all database connections configured for the specified environment. Each connection includes its configuration, type, and status information. This endpoint is useful for discovering available data sources within an environment.
      * @summary List environment database connections
@@ -2958,12 +2983,11 @@ export declare class ConnectionsApi extends BaseAPI {
      * @param {string} environmentName Name of the environment
      * @param {string} connectionName Name of the connection
      * @param {PostQuerydataRequest} postQuerydataRequest SQL statement to execute
-     * @param {string} [_options] Options (deprecated; pass in body instead)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof ConnectionsApi
      */
-    postQuerydata(environmentName: string, connectionName: string, postQuerydataRequest: PostQuerydataRequest, _options?: string, options?: RawAxiosRequestConfig): Promise< AxiosResponse<QueryData, any, {}>>;
+    postQuerydata(environmentName: string, connectionName: string, postQuerydataRequest: PostQuerydataRequest, options?: RawAxiosRequestConfig): Promise< AxiosResponse<QueryData, any, {}>>;
     /**
      * Executes a SQL statement against the specified database connection, resolved in the context of the named package, and returns the results.  Subject to the same PUBLISHER_MAX_QUERY_ROWS row cap as the environment-level sqlQuery endpoint.
      * @summary Execute SQL query (per-package)
@@ -2971,12 +2995,11 @@ export declare class ConnectionsApi extends BaseAPI {
      * @param {string} packageName Name of the package whose connection context to use
      * @param {string} connectionName Name of the connection
      * @param {PostQuerydataRequest} postQuerydataRequest SQL statement to execute
-     * @param {string} [_options] Options (deprecated; pass in body instead)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof ConnectionsApi
      */
-    postQuerydataInPackage(environmentName: string, packageName: string, connectionName: string, postQuerydataRequest: PostQuerydataRequest, _options?: string, options?: RawAxiosRequestConfig): Promise< AxiosResponse<QueryData, any, {}>>;
+    postQuerydataInPackage(environmentName: string, packageName: string, connectionName: string, postQuerydataRequest: PostQuerydataRequest, options?: RawAxiosRequestConfig): Promise< AxiosResponse<QueryData, any, {}>>;
     /**
      * Creates a Malloy source from a SQL statement using the specified database connection. The SQL statement is executed to generate a source definition that can be used in Malloy models.
      * @summary Create SQL source from statement
@@ -3356,125 +3379,14 @@ export declare class EnvironmentsApi extends BaseAPI {
      */
     updateEnvironment(environmentName: string, environment: Environment, options?: RawAxiosRequestConfig): Promise< AxiosResponse<Environment, any, {}>>;
 }
-/**
- * ManifestsApi - axios parameter creator
- * @export
- */
-export declare const ManifestsApiAxiosParamCreator: (configuration?: Configuration) => {
-    /**
-     * Returns the current build manifest containing buildId-to-tableName mappings for all materialized sources in the package.
-     * @summary Get the build manifest for a package
-     * @param {string} environmentName Name of the environment
-     * @param {string} packageName Name of the package
-     * @param {*} [options] Override http request option.
-     * @throws {RequiredError}
-     */
-    getManifest: (environmentName: string, packageName: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
-    /**
-     * Performs an action on the package manifest. The action is specified via the `action` query parameter:   * `reload` - Reads the build manifest from the shared store (DuckLake     in orchestrated mode, local DuckDB in standalone mode) and recompiles     every model in the package so subsequent queries resolve persisted     sources to their materialized tables. Intended for orchestrated     workers that did not themselves run the build; the endpoint does     not write anything *into* storage.
-     * @summary Perform an action on the package manifest
-     * @param {string} environmentName Name of the environment
-     * @param {string} packageName Name of the package
-     * @param {ManifestActionActionEnum} action Action to perform on the manifest
-     * @param {*} [options] Override http request option.
-     * @throws {RequiredError}
-     */
-    manifestAction: (environmentName: string, packageName: string, action: ManifestActionActionEnum, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
-};
-/**
- * ManifestsApi - functional programming interface
- * @export
- */
-export declare const ManifestsApiFp: (configuration?: Configuration) => {
-    /**
-     * Returns the current build manifest containing buildId-to-tableName mappings for all materialized sources in the package.
-     * @summary Get the build manifest for a package
-     * @param {string} environmentName Name of the environment
-     * @param {string} packageName Name of the package
-     * @param {*} [options] Override http request option.
-     * @throws {RequiredError}
-     */
-    getManifest(environmentName: string, packageName: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BuildManifest>>;
-    /**
-     * Performs an action on the package manifest. The action is specified via the `action` query parameter:   * `reload` - Reads the build manifest from the shared store (DuckLake     in orchestrated mode, local DuckDB in standalone mode) and recompiles     every model in the package so subsequent queries resolve persisted     sources to their materialized tables. Intended for orchestrated     workers that did not themselves run the build; the endpoint does     not write anything *into* storage.
-     * @summary Perform an action on the package manifest
-     * @param {string} environmentName Name of the environment
-     * @param {string} packageName Name of the package
-     * @param {ManifestActionActionEnum} action Action to perform on the manifest
-     * @param {*} [options] Override http request option.
-     * @throws {RequiredError}
-     */
-    manifestAction(environmentName: string, packageName: string, action: ManifestActionActionEnum, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<BuildManifest>>;
-};
-/**
- * ManifestsApi - factory interface
- * @export
- */
-export declare const ManifestsApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
-    /**
-     * Returns the current build manifest containing buildId-to-tableName mappings for all materialized sources in the package.
-     * @summary Get the build manifest for a package
-     * @param {string} environmentName Name of the environment
-     * @param {string} packageName Name of the package
-     * @param {*} [options] Override http request option.
-     * @throws {RequiredError}
-     */
-    getManifest(environmentName: string, packageName: string, options?: RawAxiosRequestConfig): AxiosPromise<BuildManifest>;
-    /**
-     * Performs an action on the package manifest. The action is specified via the `action` query parameter:   * `reload` - Reads the build manifest from the shared store (DuckLake     in orchestrated mode, local DuckDB in standalone mode) and recompiles     every model in the package so subsequent queries resolve persisted     sources to their materialized tables. Intended for orchestrated     workers that did not themselves run the build; the endpoint does     not write anything *into* storage.
-     * @summary Perform an action on the package manifest
-     * @param {string} environmentName Name of the environment
-     * @param {string} packageName Name of the package
-     * @param {ManifestActionActionEnum} action Action to perform on the manifest
-     * @param {*} [options] Override http request option.
-     * @throws {RequiredError}
-     */
-    manifestAction(environmentName: string, packageName: string, action: ManifestActionActionEnum, options?: RawAxiosRequestConfig): AxiosPromise<BuildManifest>;
-};
-/**
- * ManifestsApi - object-oriented interface
- * @export
- * @class ManifestsApi
- * @extends {BaseAPI}
- */
-export declare class ManifestsApi extends BaseAPI {
-    /**
-     * Returns the current build manifest containing buildId-to-tableName mappings for all materialized sources in the package.
-     * @summary Get the build manifest for a package
-     * @param {string} environmentName Name of the environment
-     * @param {string} packageName Name of the package
-     * @param {*} [options] Override http request option.
-     * @throws {RequiredError}
-     * @memberof ManifestsApi
-     */
-    getManifest(environmentName: string, packageName: string, options?: RawAxiosRequestConfig): Promise< AxiosResponse<BuildManifest, any, {}>>;
-    /**
-     * Performs an action on the package manifest. The action is specified via the `action` query parameter:   * `reload` - Reads the build manifest from the shared store (DuckLake     in orchestrated mode, local DuckDB in standalone mode) and recompiles     every model in the package so subsequent queries resolve persisted     sources to their materialized tables. Intended for orchestrated     workers that did not themselves run the build; the endpoint does     not write anything *into* storage.
-     * @summary Perform an action on the package manifest
-     * @param {string} environmentName Name of the environment
-     * @param {string} packageName Name of the package
-     * @param {ManifestActionActionEnum} action Action to perform on the manifest
-     * @param {*} [options] Override http request option.
-     * @throws {RequiredError}
-     * @memberof ManifestsApi
-     */
-    manifestAction(environmentName: string, packageName: string, action: ManifestActionActionEnum, options?: RawAxiosRequestConfig): Promise< AxiosResponse<BuildManifest, any, {}>>;
-}
-/**
- * @export
- */
-export declare const ManifestActionActionEnum: {
-    readonly Reload: "reload";
-};
-export type ManifestActionActionEnum = typeof ManifestActionActionEnum[keyof typeof ManifestActionActionEnum];
 /**
  * MaterializationsApi - axios parameter creator
  * @export
  */
 export declare const MaterializationsApiAxiosParamCreator: (configuration?: Configuration) => {
     /**
-     * Creates a new materialization in PENDING state for all persist sources across all models in the package. Use POST .../materializations/{materializationId}?action=start to begin execution.
-     * @summary Create a materialization
+     * Starts Round 1 of the two-round build protocol: asynchronously compiles the package, computes a build plan (per-source buildId, output columns, dependency/column lineage, connection capability), and pauses at BUILD_PLAN_READY without writing any tables. The control plane then issues Round 2 via POST .../materializations/{materializationId}?action=build with build instructions.
+     * @summary Create a materialization (Round 1)
      * @param {string} environmentName Name of the environment
      * @param {string} packageName Name of the package
      * @param {CreateMaterializationRequest} [createMaterializationRequest]
@@ -3483,15 +3395,16 @@ export declare const MaterializationsApiAxiosParamCreator: (configuration?: Conf
      */
     createMaterialization: (environmentName: string, packageName: string, createMaterializationRequest?: CreateMaterializationRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * Deletes a terminal (SUCCESS, FAILED, or CANCELLED) materialization record.
+     * Deletes a terminal (MANIFEST_FILE_READY, FAILED, or CANCELLED) materialization record. By default this removes the publisher\'s record only; the control plane owns table GC. Set dropTables=true to also drop the physical tables this run produced (from the materialization\'s manifest) as a best-effort cleanup.
      * @summary Delete a materialization
      * @param {string} environmentName Name of the environment
      * @param {string} packageName Name of the package
      * @param {string} materializationId ID of the materialization
+     * @param {boolean} [dropTables] When true, also drop the physical tables recorded in the materialization\&#39;s manifest before deleting the record. Defaults to false (record-only delete; the control plane owns table GC).
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    deleteMaterialization: (environmentName: string, packageName: string, materializationId: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    deleteMaterialization: (environmentName: string, packageName: string, materializationId: string, dropTables?: boolean, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      *
      * @summary Get a specific materialization
@@ -3514,16 +3427,17 @@ export declare const MaterializationsApiAxiosParamCreator: (configuration?: Conf
      */
     listMaterializations: (environmentName: string, packageName: string, limit?: number, offset?: number, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * Performs an action on a materialization. The action is specified via the `action` query parameter:   * `start` - Transitions a PENDING materialization to RUNNING and begins execution in the background. Returns 202.   * `stop` - Cancels a PENDING or RUNNING materialization. Returns 200.
+     * Performs an action on a materialization. The action is specified via the `action` query parameter:   * `build` - Round 2. Provide BuildInstructions (CP-assigned table id, physical     table name, and realization per source). Builds only the instructed sources into     the exact names provided and assembles the manifest. Valid only when the     materialization is at BUILD_PLAN_READY. Returns 202.   * `stop` - Cancels a PENDING, BUILD_PLAN_READY, or building materialization. Returns 200.
      * @summary Perform an action on a materialization
      * @param {string} environmentName Name of the environment
      * @param {string} packageName Name of the package
      * @param {string} materializationId ID of the materialization
      * @param {MaterializationActionActionEnum} action Action to perform on the materialization
+     * @param {BuildInstructions} [buildInstructions]
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    materializationAction: (environmentName: string, packageName: string, materializationId: string, action: MaterializationActionActionEnum, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    materializationAction: (environmentName: string, packageName: string, materializationId: string, action: MaterializationActionActionEnum, buildInstructions?: BuildInstructions, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
 };
 /**
  * MaterializationsApi - functional programming interface
@@ -3531,8 +3445,8 @@ export declare const MaterializationsApiAxiosParamCreator: (configuration?: Conf
  */
 export declare const MaterializationsApiFp: (configuration?: Configuration) => {
     /**
-     * Creates a new materialization in PENDING state for all persist sources across all models in the package. Use POST .../materializations/{materializationId}?action=start to begin execution.
-     * @summary Create a materialization
+     * Starts Round 1 of the two-round build protocol: asynchronously compiles the package, computes a build plan (per-source buildId, output columns, dependency/column lineage, connection capability), and pauses at BUILD_PLAN_READY without writing any tables. The control plane then issues Round 2 via POST .../materializations/{materializationId}?action=build with build instructions.
+     * @summary Create a materialization (Round 1)
      * @param {string} environmentName Name of the environment
      * @param {string} packageName Name of the package
      * @param {CreateMaterializationRequest} [createMaterializationRequest]
@@ -3541,15 +3455,16 @@ export declare const MaterializationsApiFp: (configuration?: Configuration) => {
      */
     createMaterialization(environmentName: string, packageName: string, createMaterializationRequest?: CreateMaterializationRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Materialization>>;
     /**
-     * Deletes a terminal (SUCCESS, FAILED, or CANCELLED) materialization record.
+     * Deletes a terminal (MANIFEST_FILE_READY, FAILED, or CANCELLED) materialization record. By default this removes the publisher\'s record only; the control plane owns table GC. Set dropTables=true to also drop the physical tables this run produced (from the materialization\'s manifest) as a best-effort cleanup.
      * @summary Delete a materialization
      * @param {string} environmentName Name of the environment
      * @param {string} packageName Name of the package
      * @param {string} materializationId ID of the materialization
+     * @param {boolean} [dropTables] When true, also drop the physical tables recorded in the materialization\&#39;s manifest before deleting the record. Defaults to false (record-only delete; the control plane owns table GC).
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    deleteMaterialization(environmentName: string, packageName: string, materializationId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    deleteMaterialization(environmentName: string, packageName: string, materializationId: string, dropTables?: boolean, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
     /**
      *
      * @summary Get a specific materialization
@@ -3572,16 +3487,17 @@ export declare const MaterializationsApiFp: (configuration?: Configuration) => {
      */
     listMaterializations(environmentName: string, packageName: string, limit?: number, offset?: number, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<Materialization>>>;
     /**
-     * Performs an action on a materialization. The action is specified via the `action` query parameter:   * `start` - Transitions a PENDING materialization to RUNNING and begins execution in the background. Returns 202.   * `stop` - Cancels a PENDING or RUNNING materialization. Returns 200.
+     * Performs an action on a materialization. The action is specified via the `action` query parameter:   * `build` - Round 2. Provide BuildInstructions (CP-assigned table id, physical     table name, and realization per source). Builds only the instructed sources into     the exact names provided and assembles the manifest. Valid only when the     materialization is at BUILD_PLAN_READY. Returns 202.   * `stop` - Cancels a PENDING, BUILD_PLAN_READY, or building materialization. Returns 200.
      * @summary Perform an action on a materialization
      * @param {string} environmentName Name of the environment
      * @param {string} packageName Name of the package
      * @param {string} materializationId ID of the materialization
      * @param {MaterializationActionActionEnum} action Action to perform on the materialization
+     * @param {BuildInstructions} [buildInstructions]
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    materializationAction(environmentName: string, packageName: string, materializationId: string, action: MaterializationActionActionEnum, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Materialization>>;
+    materializationAction(environmentName: string, packageName: string, materializationId: string, action: MaterializationActionActionEnum, buildInstructions?: BuildInstructions, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Materialization>>;
 };
 /**
  * MaterializationsApi - factory interface
@@ -3589,8 +3505,8 @@ export declare const MaterializationsApiFp: (configuration?: Configuration) => {
  */
 export declare const MaterializationsApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
     /**
-     * Creates a new materialization in PENDING state for all persist sources across all models in the package. Use POST .../materializations/{materializationId}?action=start to begin execution.
-     * @summary Create a materialization
+     * Starts Round 1 of the two-round build protocol: asynchronously compiles the package, computes a build plan (per-source buildId, output columns, dependency/column lineage, connection capability), and pauses at BUILD_PLAN_READY without writing any tables. The control plane then issues Round 2 via POST .../materializations/{materializationId}?action=build with build instructions.
+     * @summary Create a materialization (Round 1)
      * @param {string} environmentName Name of the environment
      * @param {string} packageName Name of the package
      * @param {CreateMaterializationRequest} [createMaterializationRequest]
@@ -3599,15 +3515,16 @@ export declare const MaterializationsApiFactory: (configuration?: Configuration,
      */
     createMaterialization(environmentName: string, packageName: string, createMaterializationRequest?: CreateMaterializationRequest, options?: RawAxiosRequestConfig): AxiosPromise<Materialization>;
     /**
-     * Deletes a terminal (SUCCESS, FAILED, or CANCELLED) materialization record.
+     * Deletes a terminal (MANIFEST_FILE_READY, FAILED, or CANCELLED) materialization record. By default this removes the publisher\'s record only; the control plane owns table GC. Set dropTables=true to also drop the physical tables this run produced (from the materialization\'s manifest) as a best-effort cleanup.
      * @summary Delete a materialization
      * @param {string} environmentName Name of the environment
      * @param {string} packageName Name of the package
      * @param {string} materializationId ID of the materialization
+     * @param {boolean} [dropTables] When true, also drop the physical tables recorded in the materialization\&#39;s manifest before deleting the record. Defaults to false (record-only delete; the control plane owns table GC).
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    deleteMaterialization(environmentName: string, packageName: string, materializationId: string, options?: RawAxiosRequestConfig): AxiosPromise<void>;
+    deleteMaterialization(environmentName: string, packageName: string, materializationId: string, dropTables?: boolean, options?: RawAxiosRequestConfig): AxiosPromise<void>;
     /**
      *
      * @summary Get a specific materialization
@@ -3630,16 +3547,17 @@ export declare const MaterializationsApiFactory: (configuration?: Configuration,
      */
     listMaterializations(environmentName: string, packageName: string, limit?: number, offset?: number, options?: RawAxiosRequestConfig): AxiosPromise<Array<Materialization>>;
     /**
-     * Performs an action on a materialization. The action is specified via the `action` query parameter:   * `start` - Transitions a PENDING materialization to RUNNING and begins execution in the background. Returns 202.   * `stop` - Cancels a PENDING or RUNNING materialization. Returns 200.
+     * Performs an action on a materialization. The action is specified via the `action` query parameter:   * `build` - Round 2. Provide BuildInstructions (CP-assigned table id, physical     table name, and realization per source). Builds only the instructed sources into     the exact names provided and assembles the manifest. Valid only when the     materialization is at BUILD_PLAN_READY. Returns 202.   * `stop` - Cancels a PENDING, BUILD_PLAN_READY, or building materialization. Returns 200.
      * @summary Perform an action on a materialization
      * @param {string} environmentName Name of the environment
      * @param {string} packageName Name of the package
      * @param {string} materializationId ID of the materialization
      * @param {MaterializationActionActionEnum} action Action to perform on the materialization
+     * @param {BuildInstructions} [buildInstructions]
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    materializationAction(environmentName: string, packageName: string, materializationId: string, action: MaterializationActionActionEnum, options?: RawAxiosRequestConfig): AxiosPromise<Materialization>;
+    materializationAction(environmentName: string, packageName: string, materializationId: string, action: MaterializationActionActionEnum, buildInstructions?: BuildInstructions, options?: RawAxiosRequestConfig): AxiosPromise<Materialization>;
 };
 /**
  * MaterializationsApi - object-oriented interface
@@ -3649,8 +3567,8 @@ export declare const MaterializationsApiFactory: (configuration?: Configuration,
  */
 export declare class MaterializationsApi extends BaseAPI {
     /**
-     * Creates a new materialization in PENDING state for all persist sources across all models in the package. Use POST .../materializations/{materializationId}?action=start to begin execution.
-     * @summary Create a materialization
+     * Starts Round 1 of the two-round build protocol: asynchronously compiles the package, computes a build plan (per-source buildId, output columns, dependency/column lineage, connection capability), and pauses at BUILD_PLAN_READY without writing any tables. The control plane then issues Round 2 via POST .../materializations/{materializationId}?action=build with build instructions.
+     * @summary Create a materialization (Round 1)
      * @param {string} environmentName Name of the environment
      * @param {string} packageName Name of the package
      * @param {CreateMaterializationRequest} [createMaterializationRequest]
@@ -3660,16 +3578,17 @@ export declare class MaterializationsApi extends BaseAPI {
      */
     createMaterialization(environmentName: string, packageName: string, createMaterializationRequest?: CreateMaterializationRequest, options?: RawAxiosRequestConfig): Promise< AxiosResponse<Materialization, any, {}>>;
     /**
-     * Deletes a terminal (SUCCESS, FAILED, or CANCELLED) materialization record.
+     * Deletes a terminal (MANIFEST_FILE_READY, FAILED, or CANCELLED) materialization record. By default this removes the publisher\'s record only; the control plane owns table GC. Set dropTables=true to also drop the physical tables this run produced (from the materialization\'s manifest) as a best-effort cleanup.
      * @summary Delete a materialization
      * @param {string} environmentName Name of the environment
      * @param {string} packageName Name of the package
      * @param {string} materializationId ID of the materialization
+     * @param {boolean} [dropTables] When true, also drop the physical tables recorded in the materialization\&#39;s manifest before deleting the record. Defaults to false (record-only delete; the control plane owns table GC).
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof MaterializationsApi
      */
-    deleteMaterialization(environmentName: string, packageName: string, materializationId: string, options?: RawAxiosRequestConfig): Promise< AxiosResponse<void, any, {}>>;
+    deleteMaterialization(environmentName: string, packageName: string, materializationId: string, dropTables?: boolean, options?: RawAxiosRequestConfig): Promise< AxiosResponse<void, any, {}>>;
     /**
      *
      * @summary Get a specific materialization
@@ -3694,23 +3613,24 @@ export declare class MaterializationsApi extends BaseAPI {
      */
     listMaterializations(environmentName: string, packageName: string, limit?: number, offset?: number, options?: RawAxiosRequestConfig): Promise< AxiosResponse<Materialization[], any, {}>>;
     /**
-     * Performs an action on a materialization. The action is specified via the `action` query parameter:   * `start` - Transitions a PENDING materialization to RUNNING and begins execution in the background. Returns 202.   * `stop` - Cancels a PENDING or RUNNING materialization. Returns 200.
+     * Performs an action on a materialization. The action is specified via the `action` query parameter:   * `build` - Round 2. Provide BuildInstructions (CP-assigned table id, physical     table name, and realization per source). Builds only the instructed sources into     the exact names provided and assembles the manifest. Valid only when the     materialization is at BUILD_PLAN_READY. Returns 202.   * `stop` - Cancels a PENDING, BUILD_PLAN_READY, or building materialization. Returns 200.
      * @summary Perform an action on a materialization
      * @param {string} environmentName Name of the environment
      * @param {string} packageName Name of the package
      * @param {string} materializationId ID of the materialization
      * @param {MaterializationActionActionEnum} action Action to perform on the materialization
+     * @param {BuildInstructions} [buildInstructions]
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof MaterializationsApi
      */
-    materializationAction(environmentName: string, packageName: string, materializationId: string, action: MaterializationActionActionEnum, options?: RawAxiosRequestConfig): Promise< AxiosResponse<Materialization, any, {}>>;
+    materializationAction(environmentName: string, packageName: string, materializationId: string, action: MaterializationActionActionEnum, buildInstructions?: BuildInstructions, options?: RawAxiosRequestConfig): Promise< AxiosResponse<Materialization, any, {}>>;
 }
 /**
  * @export
  */
 export declare const MaterializationActionActionEnum: {
-    readonly Start: "start";
+    readonly Build: "build";
     readonly Stop: "stop";
 };
 export type MaterializationActionActionEnum = typeof MaterializationActionActionEnum[keyof typeof MaterializationActionActionEnum];
@@ -4107,11 +4027,10 @@ export declare const PackagesApiAxiosParamCreator: (configuration?: Configuratio
      * @summary Create a new package
      * @param {string} environmentName Name of the environment
      * @param {Package} _package
-     * @param {boolean} [autoLoadManifest] When true, automatically loads any existing build manifest for the package so materialized table references resolve immediately. Defaults to false.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    createPackage: (environmentName: string, _package: Package, autoLoadManifest?: boolean, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    createPackage: (environmentName: string, _package: Package, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Permanently deletes a package and all its associated resources including models, notebooks, databases, and metadata. This operation cannot be undone, so use with caution. The package must exist and be accessible for deletion.
      * @summary Delete a package
@@ -4161,11 +4080,10 @@ export declare const PackagesApiFp: (configuration?: Configuration) => {
      * @summary Create a new package
      * @param {string} environmentName Name of the environment
      * @param {Package} _package
-     * @param {boolean} [autoLoadManifest] When true, automatically loads any existing build manifest for the package so materialized table references resolve immediately. Defaults to false.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    createPackage(environmentName: string, _package: Package, autoLoadManifest?: boolean, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Package>>;
+    createPackage(environmentName: string, _package: Package, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Package>>;
     /**
      * Permanently deletes a package and all its associated resources including models, notebooks, databases, and metadata. This operation cannot be undone, so use with caution. The package must exist and be accessible for deletion.
      * @summary Delete a package
@@ -4215,11 +4133,10 @@ export declare const PackagesApiFactory: (configuration?: Configuration, basePat
      * @summary Create a new package
      * @param {string} environmentName Name of the environment
      * @param {Package} _package
-     * @param {boolean} [autoLoadManifest] When true, automatically loads any existing build manifest for the package so materialized table references resolve immediately. Defaults to false.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    createPackage(environmentName: string, _package: Package, autoLoadManifest?: boolean, options?: RawAxiosRequestConfig): AxiosPromise<Package>;
+    createPackage(environmentName: string, _package: Package, options?: RawAxiosRequestConfig): AxiosPromise<Package>;
     /**
      * Permanently deletes a package and all its associated resources including models, notebooks, databases, and metadata. This operation cannot be undone, so use with caution. The package must exist and be accessible for deletion.
      * @summary Delete a package
@@ -4271,12 +4188,11 @@ export declare class PackagesApi extends BaseAPI {
      * @summary Create a new package
      * @param {string} environmentName Name of the environment
      * @param {Package} _package
-     * @param {boolean} [autoLoadManifest] When true, automatically loads any existing build manifest for the package so materialized table references resolve immediately. Defaults to false.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof PackagesApi
      */
-    createPackage(environmentName: string, _package: Package, autoLoadManifest?: boolean, options?: RawAxiosRequestConfig): Promise< AxiosResponse<Package, any, {}>>;
+    createPackage(environmentName: string, _package: Package, options?: RawAxiosRequestConfig): Promise< AxiosResponse<Package, any, {}>>;
     /**
      * Permanently deletes a package and all its associated resources including models, notebooks, databases, and metadata. This operation cannot be undone, so use with caution. The package must exist and be accessible for deletion.
      * @summary Delete a package