@dbx-tools/shared-search 0.6.9

package/README.md

@@ -0,0 +1,72 @@
+# @dbx-tools/shared-search
+
+Browser-safe AI Search (Databricks Vector Search) schemas and inferred types.
+
+Import this package when a UI, Mastra tool schema, server route, or test needs
+to validate the same search payloads that
+[`@dbx-tools/search`](../../node/search) reads and writes.
+
+Key features:
+
+- Shared `SearchRequest` / `SearchResult` contract with `{ id, score, fields }`
+  hits, so an autocomplete box, a docs lookup, and a Mastra tool speak one shape.
+- `SearchMode` (`hybrid` / `vector` / `keyword`) matching the serving query
+  types, with hybrid as the sensible default.
+- `UniversalSearchRequest` for federated search across several indexes at once.
+- `SearchDocument` / `UpsertResult` for adding and updating direct-access index
+  contents.
+- `SearchIndexInfo` / `SearchClientConfig` for the boot-time index catalogue a
+  search box reads with no server round-trip.
+- Model/tool-friendly schemas that avoid JSON Schema constraints known to cause
+  problems with some serving endpoints.
+
+## Validate A Search Request
+
+```ts
+import { search, type SearchRequest } from "@dbx-tools/shared-search";
+
+const request: SearchRequest = search.searchRequestSchema.parse({
+  query: "reset my password",
+  index: "main.support.docs",
+  limit: 5,
+  mode: "hybrid",
+  filter: { locale: "en", published: true },
+});
+```
+
+## Validate Search Results
+
+```ts
+const result = search.searchResultSchema.parse(await response.json());
+for (const hit of result.hits) {
+  console.log(hit.score, hit.id, hit.fields.title);
+}
+```
+
+`searchHitSchema` returns the requested columns under `fields`, keyed by column
+name, plus the primary-key `id` and a relevance `score`. A federated hit also
+carries the `index` it came from.
+
+## Read The Index Catalogue
+
+```ts
+const config = search.searchClientConfigSchema.parse(
+  await fetch("/api/search/indexes").then((r) => r.json()),
+);
+```
+
+`searchClientConfigSchema` is what a search box reads at boot to know which
+indexes it may query, which is the default, and the page size to request.
+
+## Module
+
+- `search` - `searchModeSchema`, `searchRequestSchema`, `searchHitSchema`,
+  `searchResultSchema`, `universalSearchRequestSchema`, `searchDocumentSchema`,
+  `upsertResultSchema`, `searchIndexInfoSchema`, `searchClientConfigSchema`, and
+  the flat inferred types (`SearchMode`, `SearchRequest`, `SearchHit`,
+  `SearchResult`, `UniversalSearchRequest`, `SearchDocument`, `UpsertResult`,
+  `SearchIndexInfo`, `SearchClientConfig`).
+
+Runtime search, index management, the Mastra tools, and the AppKit plugin live
+in [`@dbx-tools/search`](../../node/search). The React search box lives in
+[`@dbx-tools/ui-search`](../../ui/search).

package/index.ts

@@ -0,0 +1,7 @@
+// GENERATED by projen watch - DO NOT EDIT.
+// Regenerated from the exporting modules in ./src.
+// Hand edits are overwritten on the next watch; this file is read-only.
+
+export * as search from "./src/search.ts";
+export { searchModeSchema, searchRequestSchema, searchHitSchema, searchResultSchema, universalSearchRequestSchema, searchDocumentSchema, upsertResultSchema, searchIndexInfoSchema, searchClientConfigSchema, createIndexRequestSchema, syncIndexRequestSchema, indexInfoSchema } from "./src/search.ts";
+export type { SearchMode, SearchRequest, SearchHit, SearchResult, UniversalSearchRequest, SearchDocument, UpsertResult, SearchIndexInfo, SearchClientConfig, CreateIndexRequest, SyncIndexRequest, IndexInfo } from "./src/search.ts";

package/lib/index.d.ts

@@ -0,0 +1,3 @@
+export * as search from "./src/search.ts";
+export { searchModeSchema, searchRequestSchema, searchHitSchema, searchResultSchema, universalSearchRequestSchema, searchDocumentSchema, upsertResultSchema, searchIndexInfoSchema, searchClientConfigSchema, createIndexRequestSchema, syncIndexRequestSchema, indexInfoSchema } from "./src/search.ts";
+export type { SearchMode, SearchRequest, SearchHit, SearchResult, UniversalSearchRequest, SearchDocument, UpsertResult, SearchIndexInfo, SearchClientConfig, CreateIndexRequest, SyncIndexRequest, IndexInfo } from "./src/search.ts";

package/lib/index.js

@@ -0,0 +1,6 @@
+// GENERATED by projen watch - DO NOT EDIT.
+// Regenerated from the exporting modules in ./src.
+// Hand edits are overwritten on the next watch; this file is read-only.
+export * as search from "./src/search.js";
+export { searchModeSchema, searchRequestSchema, searchHitSchema, searchResultSchema, universalSearchRequestSchema, searchDocumentSchema, upsertResultSchema, searchIndexInfoSchema, searchClientConfigSchema, createIndexRequestSchema, syncIndexRequestSchema, indexInfoSchema } from "./src/search.js";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSwyQ0FBMkM7QUFDM0MsbURBQW1EO0FBQ25ELHdFQUF3RTtBQUV4RSxPQUFPLEtBQUssTUFBTSxNQUFNLGlCQUFpQixDQUFDO0FBQzFDLE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxtQkFBbUIsRUFBRSxlQUFlLEVBQUUsa0JBQWtCLEVBQUUsNEJBQTRCLEVBQUUsb0JBQW9CLEVBQUUsa0JBQWtCLEVBQUUscUJBQXFCLEVBQUUsd0JBQXdCLEVBQUUsd0JBQXdCLEVBQUUsc0JBQXNCLEVBQUUsZUFBZSxFQUFFLE1BQU0saUJBQWlCLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvLyBHRU5FUkFURUQgYnkgcHJvamVuIHdhdGNoIC0gRE8gTk9UIEVESVQuXG4vLyBSZWdlbmVyYXRlZCBmcm9tIHRoZSBleHBvcnRpbmcgbW9kdWxlcyBpbiAuL3NyYy5cbi8vIEhhbmQgZWRpdHMgYXJlIG92ZXJ3cml0dGVuIG9uIHRoZSBuZXh0IHdhdGNoOyB0aGlzIGZpbGUgaXMgcmVhZC1vbmx5LlxuXG5leHBvcnQgKiBhcyBzZWFyY2ggZnJvbSBcIi4vc3JjL3NlYXJjaC50c1wiO1xuZXhwb3J0IHsgc2VhcmNoTW9kZVNjaGVtYSwgc2VhcmNoUmVxdWVzdFNjaGVtYSwgc2VhcmNoSGl0U2NoZW1hLCBzZWFyY2hSZXN1bHRTY2hlbWEsIHVuaXZlcnNhbFNlYXJjaFJlcXVlc3RTY2hlbWEsIHNlYXJjaERvY3VtZW50U2NoZW1hLCB1cHNlcnRSZXN1bHRTY2hlbWEsIHNlYXJjaEluZGV4SW5mb1NjaGVtYSwgc2VhcmNoQ2xpZW50Q29uZmlnU2NoZW1hLCBjcmVhdGVJbmRleFJlcXVlc3RTY2hlbWEsIHN5bmNJbmRleFJlcXVlc3RTY2hlbWEsIGluZGV4SW5mb1NjaGVtYSB9IGZyb20gXCIuL3NyYy9zZWFyY2gudHNcIjtcbmV4cG9ydCB0eXBlIHsgU2VhcmNoTW9kZSwgU2VhcmNoUmVxdWVzdCwgU2VhcmNoSGl0LCBTZWFyY2hSZXN1bHQsIFVuaXZlcnNhbFNlYXJjaFJlcXVlc3QsIFNlYXJjaERvY3VtZW50LCBVcHNlcnRSZXN1bHQsIFNlYXJjaEluZGV4SW5mbywgU2VhcmNoQ2xpZW50Q29uZmlnLCBDcmVhdGVJbmRleFJlcXVlc3QsIFN5bmNJbmRleFJlcXVlc3QsIEluZGV4SW5mbyB9IGZyb20gXCIuL3NyYy9zZWFyY2gudHNcIjtcbiJdfQ==

package/lib/src/search.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Wire-format contract for the AI Search add-on: the query a caller (a UI
+ * search box, a Mastra tool, a universal-search route) sends and the hits it
+ * gets back, plus the document shape used to add / update index contents.
+ *
+ * Pure (zod + inferred types, no Node-only imports) so the server-side client
+ * in `@dbx-tools/search`, the Mastra tool, the `POST /api/search` route,
+ * and the React search box all validate / type against ONE definition.
+ *
+ * "AI Search" is Databricks' current name for Vector Search: an index built
+ * from a Delta table (or written directly) that answers a natural-language
+ * query with the most relevant rows, combining vector similarity with BM25
+ * keyword matching (hybrid). This contract is index-agnostic - it names the
+ * index by its Unity Catalog path and returns hits as `{ id, score, fields }`
+ * so the same shape serves an autocomplete box, a docs lookup, and a
+ * federated search across many indexes.
+ *
+ * Array fields intentionally avoid `.min()` / `.nonempty()`: those emit
+ * `minItems` in the JSON schema, which some Model Serving endpoints reject
+ * when the schema is forwarded as a tool definition.
+ *
+ * @module
+ */
+import { z } from "zod";
+/**
+ * How a query is matched. `hybrid` (the default) fuses vector similarity with
+ * BM25 keyword ranking - the right choice for most search boxes and for source
+ * data with exact identifiers (SKUs, error codes). `vector` is pure semantic
+ * similarity; `keyword` is pure BM25 full-text (Beta on Databricks). The
+ * value maps onto the serving API's `query_type` (`ANN` / `HYBRID`).
+ */
+export declare const searchModeSchema: z.ZodEnum<{
+    hybrid: "hybrid";
+    vector: "vector";
+    keyword: "keyword";
+}>;
+/** How a query is matched (see {@link searchModeSchema}). */
+export type SearchMode = z.infer<typeof searchModeSchema>;
+/** Schema for a search request against a single index. */
+export declare const searchRequestSchema: z.ZodObject<{
+    query: z.ZodString;
+    index: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        hybrid: "hybrid";
+        vector: "vector";
+        keyword: "keyword";
+    }>>;
+    columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    scoreThreshold: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/** A validated search request ({@link searchRequestSchema}). */
+export type SearchRequest = z.infer<typeof searchRequestSchema>;
+/** Schema for a single search hit. */
+export declare const searchHitSchema: z.ZodObject<{
+    id: z.ZodString;
+    score: z.ZodNumber;
+    fields: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    index: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** A single search hit ({@link searchHitSchema}). */
+export type SearchHit = z.infer<typeof searchHitSchema>;
+/** Schema for the result of a search. */
+export declare const searchResultSchema: z.ZodObject<{
+    query: z.ZodString;
+    hits: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        score: z.ZodNumber;
+        fields: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        index: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    index: z.ZodOptional<z.ZodString>;
+    count: z.ZodNumber;
+}, z.core.$strip>;
+/** The outcome of a search ({@link searchResultSchema}). */
+export type SearchResult = z.infer<typeof searchResultSchema>;
+/** Schema for a universal (federated) search across several indexes at once. */
+export declare const universalSearchRequestSchema: z.ZodObject<{
+    query: z.ZodString;
+    indexes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        hybrid: "hybrid";
+        vector: "vector";
+        keyword: "keyword";
+    }>>;
+}, z.core.$strip>;
+/** A validated universal-search request ({@link universalSearchRequestSchema}). */
+export type UniversalSearchRequest = z.infer<typeof universalSearchRequestSchema>;
+/** Schema for a document written to a direct-access index. */
+export declare const searchDocumentSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+/** A document written to an index ({@link searchDocumentSchema}). */
+export type SearchDocument = z.infer<typeof searchDocumentSchema>;
+/** Schema for the result of adding / updating documents. */
+export declare const upsertResultSchema: z.ZodObject<{
+    index: z.ZodString;
+    count: z.ZodNumber;
+}, z.core.$strip>;
+/** The outcome of an add-documents call ({@link upsertResultSchema}). */
+export type UpsertResult = z.infer<typeof upsertResultSchema>;
+/**
+ * Schema for the boot-time index catalogue a UI reads to populate a search box
+ * (the payload of the plugin's client config / `GET /api/search/indexes`). An
+ * entry names an index, an optional short alias, and the columns worth
+ * showing, so a search box needs no server round-trip to render.
+ */
+export declare const searchIndexInfoSchema: z.ZodObject<{
+    name: z.ZodString;
+    alias: z.ZodOptional<z.ZodString>;
+    primaryKey: z.ZodOptional<z.ZodString>;
+    columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    isDefault: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/** One entry in the index catalogue ({@link searchIndexInfoSchema}). */
+export type SearchIndexInfo = z.infer<typeof searchIndexInfoSchema>;
+/** Schema for the plugin's client config surfaced to a UI. */
+export declare const searchClientConfigSchema: z.ZodObject<{
+    indexes: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        alias: z.ZodOptional<z.ZodString>;
+        primaryKey: z.ZodOptional<z.ZodString>;
+        columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        isDefault: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    defaultIndex: z.ZodOptional<z.ZodString>;
+    pageSize: z.ZodNumber;
+    basePath: z.ZodString;
+}, z.core.$strip>;
+/** The plugin's client config ({@link searchClientConfigSchema}). */
+export type SearchClientConfig = z.infer<typeof searchClientConfigSchema>;
+/**
+ * Schema for creating an index (the `create_index` tool input / the
+ * `POST /api/search/index` body). Two shapes, both inferring aggressively:
+ * pass `sourceTable` for a Delta Sync index (Databricks computes embeddings and
+ * keeps it synced) or `embeddingDimension` for a direct-access index you write
+ * vectors to yourself.
+ */
+export declare const createIndexRequestSchema: z.ZodObject<{
+    name: z.ZodString;
+    sourceTable: z.ZodOptional<z.ZodString>;
+    primaryKey: z.ZodOptional<z.ZodString>;
+    embeddingSourceColumn: z.ZodOptional<z.ZodString>;
+    embeddingModel: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    embeddingDimension: z.ZodOptional<z.ZodNumber>;
+    pipelineType: z.ZodOptional<z.ZodEnum<{
+        TRIGGERED: "TRIGGERED";
+        CONTINUOUS: "CONTINUOUS";
+    }>>;
+    columnsToSync: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/** A validated create-index request ({@link createIndexRequestSchema}). */
+export type CreateIndexRequest = z.infer<typeof createIndexRequestSchema>;
+/** Schema for the `sync_index` tool input / the `POST /api/search/index/sync` body. */
+export declare const syncIndexRequestSchema: z.ZodObject<{
+    index: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** A validated sync-index request ({@link syncIndexRequestSchema}). */
+export type SyncIndexRequest = z.infer<typeof syncIndexRequestSchema>;
+/** Schema for a resolved index definition (the create/get result). */
+export declare const indexInfoSchema: z.ZodObject<{
+    name: z.ZodString;
+    endpoint: z.ZodOptional<z.ZodString>;
+    primaryKey: z.ZodOptional<z.ZodString>;
+    columns: z.ZodArray<z.ZodString>;
+    ready: z.ZodBoolean;
+    rowCount: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/** A resolved index definition ({@link indexInfoSchema}). */
+export type IndexInfo = z.infer<typeof indexInfoSchema>;

package/lib/src/search.js

@@ -0,0 +1,189 @@
+/**
+ * Wire-format contract for the AI Search add-on: the query a caller (a UI
+ * search box, a Mastra tool, a universal-search route) sends and the hits it
+ * gets back, plus the document shape used to add / update index contents.
+ *
+ * Pure (zod + inferred types, no Node-only imports) so the server-side client
+ * in `@dbx-tools/search`, the Mastra tool, the `POST /api/search` route,
+ * and the React search box all validate / type against ONE definition.
+ *
+ * "AI Search" is Databricks' current name for Vector Search: an index built
+ * from a Delta table (or written directly) that answers a natural-language
+ * query with the most relevant rows, combining vector similarity with BM25
+ * keyword matching (hybrid). This contract is index-agnostic - it names the
+ * index by its Unity Catalog path and returns hits as `{ id, score, fields }`
+ * so the same shape serves an autocomplete box, a docs lookup, and a
+ * federated search across many indexes.
+ *
+ * Array fields intentionally avoid `.min()` / `.nonempty()`: those emit
+ * `minItems` in the JSON schema, which some Model Serving endpoints reject
+ * when the schema is forwarded as a tool definition.
+ *
+ * @module
+ */
+import { z } from "zod";
+/**
+ * How a query is matched. `hybrid` (the default) fuses vector similarity with
+ * BM25 keyword ranking - the right choice for most search boxes and for source
+ * data with exact identifiers (SKUs, error codes). `vector` is pure semantic
+ * similarity; `keyword` is pure BM25 full-text (Beta on Databricks). The
+ * value maps onto the serving API's `query_type` (`ANN` / `HYBRID`).
+ */
+export const searchModeSchema = z
+    .enum(["hybrid", "vector", "keyword"])
+    .describe("Match strategy: 'hybrid' fuses semantic similarity with keyword ranking (default, best for most searches), 'vector' is pure semantic, 'keyword' is pure full-text.");
+/** Schema for a search request against a single index. */
+export const searchRequestSchema = z.object({
+    query: z
+        .string()
+        .describe("What to search for, as natural language or keywords. Prefix fragments work for autocomplete."),
+    index: z
+        .string()
+        .optional()
+        .describe("Unity Catalog name of the index to search (catalog.schema.index). Defaults to the plugin's configured index. Accepts a short alias when one is configured."),
+    limit: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Maximum number of hits to return. Defaults to the plugin's configured page size."),
+    mode: searchModeSchema.optional(),
+    columns: z
+        .array(z.string())
+        .optional()
+        .describe("Which document columns to return per hit. Defaults to the plugin's configured columns (or all indexed columns)."),
+    filter: z
+        .record(z.string(), z.unknown())
+        .optional()
+        .describe('Attribute filters as { column: value } (a value, or an operator map like { ">=": 10 }). Combined with AND. Maps onto the index `filters_json`.'),
+    scoreThreshold: z
+        .number()
+        .optional()
+        .describe("Drop hits whose relevance score is below this value."),
+});
+/** Schema for a single search hit. */
+export const searchHitSchema = z.object({
+    id: z.string().describe("The document's primary-key value."),
+    score: z.number().describe("Relevance score; higher is more relevant."),
+    fields: z
+        .record(z.string(), z.unknown())
+        .describe("The returned columns for this document, keyed by column name."),
+    index: z
+        .string()
+        .optional()
+        .describe("Which index the hit came from (set on universal/federated results)."),
+});
+/** Schema for the result of a search. */
+export const searchResultSchema = z.object({
+    query: z.string().describe("Echo of the query that was searched."),
+    hits: z.array(searchHitSchema).describe("Matching documents, most relevant first."),
+    index: z.string().optional().describe("The index searched (omitted for a universal search)."),
+    count: z.number().int().describe("Number of hits returned."),
+});
+/** Schema for a universal (federated) search across several indexes at once. */
+export const universalSearchRequestSchema = z.object({
+    query: z.string().describe("What to search for across every configured index."),
+    indexes: z
+        .array(z.string())
+        .optional()
+        .describe("Which indexes to search. Defaults to every index the plugin knows about."),
+    limit: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Maximum hits PER index before results are merged and re-ranked."),
+    mode: searchModeSchema.optional(),
+});
+/** Schema for a document written to a direct-access index. */
+export const searchDocumentSchema = z
+    .record(z.string(), z.unknown())
+    .describe("A document as { column: value }. Must include the index primary-key column.");
+/** Schema for the result of adding / updating documents. */
+export const upsertResultSchema = z.object({
+    index: z.string().describe("The index the documents were written to."),
+    count: z.number().int().describe("Number of documents accepted."),
+});
+/**
+ * Schema for the boot-time index catalogue a UI reads to populate a search box
+ * (the payload of the plugin's client config / `GET /api/search/indexes`). An
+ * entry names an index, an optional short alias, and the columns worth
+ * showing, so a search box needs no server round-trip to render.
+ */
+export const searchIndexInfoSchema = z.object({
+    name: z.string().describe("Unity Catalog name of the index (catalog.schema.index)."),
+    alias: z.string().optional().describe("Short alias the plugin accepts in place of `name`."),
+    primaryKey: z.string().optional().describe("The index's primary-key column, when known."),
+    columns: z
+        .array(z.string())
+        .optional()
+        .describe("Columns returned by default, in display order."),
+    isDefault: z.boolean().optional().describe("True for the plugin's default index."),
+});
+/** Schema for the plugin's client config surfaced to a UI. */
+export const searchClientConfigSchema = z.object({
+    indexes: z.array(searchIndexInfoSchema).describe("Indexes the search UI may query."),
+    defaultIndex: z.string().optional().describe("The index a search box selects by default."),
+    pageSize: z.number().int().describe("Default number of hits a search returns."),
+    basePath: z
+        .string()
+        .describe("Base path the search routes are mounted under (e.g. /api/search)."),
+});
+/**
+ * Schema for creating an index (the `create_index` tool input / the
+ * `POST /api/search/index` body). Two shapes, both inferring aggressively:
+ * pass `sourceTable` for a Delta Sync index (Databricks computes embeddings and
+ * keeps it synced) or `embeddingDimension` for a direct-access index you write
+ * vectors to yourself.
+ */
+export const createIndexRequestSchema = z.object({
+    name: z.string().describe("Unity Catalog name for the new index (catalog.schema.index)."),
+    sourceTable: z
+        .string()
+        .optional()
+        .describe("Delta table (catalog.schema.table) to build a synced index from. Provide this OR embeddingDimension."),
+    primaryKey: z.string().optional().describe("Primary-key column. Defaults to 'id'."),
+    embeddingSourceColumn: z
+        .string()
+        .optional()
+        .describe("Text column embeddings are computed from (Delta Sync). Defaults to the first of text/content/body."),
+    embeddingModel: z
+        .string()
+        .optional()
+        .describe("Embedding model endpoint (name or loose name). Defaults to the app's embedding model, or the best embedding endpoint in the workspace."),
+    endpoint: z
+        .string()
+        .optional()
+        .describe("Vector Search endpoint to host the index on. Defaults to the app's configured endpoint."),
+    embeddingDimension: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("For a direct-access index (no source table): the embedding vector dimension."),
+    pipelineType: z
+        .enum(["TRIGGERED", "CONTINUOUS"])
+        .optional()
+        .describe("Delta Sync mode: 'TRIGGERED' (default) syncs on demand; 'CONTINUOUS' keeps the index fresh."),
+    columnsToSync: z
+        .array(z.string())
+        .optional()
+        .describe("Extra columns to sync alongside the embedding source column (Delta Sync)."),
+});
+/** Schema for the `sync_index` tool input / the `POST /api/search/index/sync` body. */
+export const syncIndexRequestSchema = z.object({
+    index: z
+        .string()
+        .describe("The index to sync (name or configured alias). Defaults to the app's default index when omitted.")
+        .optional(),
+});
+/** Schema for a resolved index definition (the create/get result). */
+export const indexInfoSchema = z.object({
+    name: z.string().describe("Unity Catalog name of the index."),
+    endpoint: z.string().optional().describe("The Vector Search endpoint hosting the index."),
+    primaryKey: z.string().optional().describe("The index's primary-key column."),
+    columns: z.array(z.string()).describe("Columns available on the index."),
+    ready: z.boolean().describe("True when the index has finished provisioning and can be queried."),
+    rowCount: z.number().int().optional().describe("Number of indexed rows, when known."),
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VhcmNoLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3NlYXJjaC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQXNCRztBQUVILE9BQU8sRUFBRSxDQUFDLEVBQUUsTUFBTSxLQUFLLENBQUM7QUFFeEI7Ozs7OztHQU1HO0FBQ0gsTUFBTSxDQUFDLE1BQU0sZ0JBQWdCLEdBQUcsQ0FBQztLQUM5QixJQUFJLENBQUMsQ0FBQyxRQUFRLEVBQUUsUUFBUSxFQUFFLFNBQVMsQ0FBQyxDQUFDO0tBQ3JDLFFBQVEsQ0FDUCxvS0FBb0ssQ0FDckssQ0FBQztBQUtKLDBEQUEwRDtBQUMxRCxNQUFNLENBQUMsTUFBTSxtQkFBbUIsR0FBRyxDQUFDLENBQUMsTUFBTSxDQUFDO0lBQzFDLEtBQUssRUFBRSxDQUFDO1NBQ0wsTUFBTSxFQUFFO1NBQ1IsUUFBUSxDQUNQLDhGQUE4RixDQUMvRjtJQUNILEtBQUssRUFBRSxDQUFDO1NBQ0wsTUFBTSxFQUFFO1NBQ1IsUUFBUSxFQUFFO1NBQ1YsUUFBUSxDQUNQLDRKQUE0SixDQUM3SjtJQUNILEtBQUssRUFBRSxDQUFDO1NBQ0wsTUFBTSxFQUFFO1NBQ1IsR0FBRyxFQUFFO1NBQ0wsUUFBUSxFQUFFO1NBQ1YsUUFBUSxFQUFFO1NBQ1YsUUFBUSxDQUFDLGtGQUFrRixDQUFDO0lBQy9GLElBQUksRUFBRSxnQkFBZ0IsQ0FBQyxRQUFRLEVBQUU7SUFDakMsT0FBTyxFQUFFLENBQUM7U0FDUCxLQUFLLENBQUMsQ0FBQyxDQUFDLE1BQU0sRUFBRSxDQUFDO1NBQ2pCLFFBQVEsRUFBRTtTQUNWLFFBQVEsQ0FDUCxpSEFBaUgsQ0FDbEg7SUFDSCxNQUFNLEVBQUUsQ0FBQztTQUNOLE1BQU0sQ0FBQyxDQUFDLENBQUMsTUFBTSxFQUFFLEVBQUUsQ0FBQyxDQUFDLE9BQU8sRUFBRSxDQUFDO1NBQy9CLFFBQVEsRUFBRTtTQUNWLFFBQVEsQ0FDUCxnSkFBZ0os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QUFDLE1BQU0sRUFBRSxDQUFDLFFBQVEsQ0FBQyxrQ0FBa0MsQ0FBQztJQUM3RCxRQUFRLEVBQUUsQ0FBQyxDQUFDLE1BQU0sRUFBRSxDQUFDLFFBQVEsRUFBRSxDQUFDLFFBQVEsQ0FBQywrQ0FBK0MsQ0FBQztJQUN6RixVQUFVLEVBQUUsQ0FBQyxDQUFDLE1BQU0sRUFBRSxDQUFDLFFBQVEsRUFBRSxDQUFDLFFBQVEsQ0FBQyxpQ0FBaUMsQ0FBQztJQUM3RSxPQUFPLEVBQUUsQ0FBQyxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FBQyxRQUFRLENBQUMsaUNBQWlDLENBQUM7SUFDeEUsS0FBSyxFQUFFLENBQUMsQ0FBQyxPQUFPLEVBQUUsQ0FBQyxRQUFRLENBQUMsbUVBQW1FLENBQUM7SUFDaEcsUUFBUSxFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxRQUFRLEVBQUUsQ0FBQyxRQUFRLENBQUMscUNBQXFDLENBQUM7Q0FDdEYsQ0FBQyxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBXaXJlLWZvcm1hdCBjb250cmFjdCBmb3IgdGhlIEFJIFNlYXJjaCBhZGQtb246IHRoZSBxdWVyeSBhIGNhbGxlciAoYSBVSVxuICogc2VhcmNoIGJveCwgYSBNYXN0cmEgdG9vbCwgYSB1bml2ZXJzYWwtc2VhcmNoIHJvdXRlKSBzZW5kcyBhbmQgdGhlIGhpdHMgaXRcbiAqIGdldHMgYmFjaywgcGx1cyB0aGUgZG9jdW1lbnQgc2hhcGUgdXNlZCB0byBhZGQgLyB1cGRhdGUgaW5kZXggY29udGVudHMuXG4gKlxuICogUHVyZSAoem9kICsgaW5mZXJyZWQgdHlwZXMsIG5vIE5vZGUtb25seSBpbXBvcnRzKSBzbyB0aGUgc2VydmVyLXNpZGUgY2xpZW50XG4gKiBpbiBgQGRieC10b29scy9zZWFyY2hgLCB0aGUgTWFzdHJhIHRvb2wsIHRoZSBgUE9TVCAvYXBpL3NlYXJjaGAgcm91dGUsXG4gKiBhbmQgdGhlIFJlYWN0IHNlYXJjaCBib3ggYWxsIHZhbGlkYXRlIC8gdHlwZSBhZ2FpbnN0IE9ORSBkZWZpbml0aW9uLlxuICpcbiAqIFwiQUkgU2VhcmNoXCIgaXMgRGF0YWJyaWNrcycgY3VycmVudCBuYW1lIGZvciBWZWN0b3IgU2VhcmNoOiBhbiBpbmRleCBidWlsdFxuICogZnJvbSBhIERlbHRhIHRhYmxlIChvciB3cml0dGVuIGRpcmVjdGx5KSB0aGF0IGFuc3dlcnMgYSBuYXR1cmFsLWxhbmd1YWdlXG4gKiBxdWVyeSB3aXRoIHRoZSBtb3N0IHJlbGV2YW50IHJvd3MsIGNvbWJpbmluZyB2ZWN0b3Igc2ltaWxhcml0eSB3aXRoIEJNMjVcbiAqIGtleXdvcmQgbWF0Y2hpbmcgKGh5YnJpZCkuIFRoaXMgY29udHJhY3QgaXMgaW5kZXgtYWdub3N0aWMgLSBpdCBuYW1lcyB0aGVcbiAqIGluZGV4IGJ5IGl0cyBVbml0eSBDYXRhbG9nIHBhdGggYW5kIHJldHVybnMgaGl0cyBhcyBgeyBpZCwgc2NvcmUsIGZpZWxkcyB9YFxuICogc28gdGhlIHNhbWUgc2hhcGUgc2VydmVzIGFuIGF1dG9jb21wbGV0ZSBib3gsIGEgZG9jcyBsb29rdXAsIGFuZCBhXG4gKiBmZWRlcmF0ZWQgc2VhcmNoIGFjcm9zcyBtYW55IGluZGV4ZXMuXG4gKlxuICogQXJyYXkgZmllbGRzIGludGVudGlvbmFsbHkgYXZvaWQgYC5taW4oKWAgLyBgLm5vbmVtcHR5KClgOiB0aG9zZSBlbWl0XG4gKiBgbWluSXRlbXNgIGluIHRoZSBKU09OIHNjaGVtYSwgd2hpY2ggc29tZSBNb2RlbCBTZXJ2aW5nIGVuZHBvaW50cyByZWplY3RcbiAqIHdoZW4gdGhlIHNjaGVtYSBpcyBmb3J3YXJkZWQgYXMgYSB0b29sIGRlZmluaXRpb24uXG4gKlxuICogQG1vZHVsZVxuICovXG5cbmltcG9ydCB7IHogfSBmcm9tIFwiem9kXCI7XG5cbi8qKlxuICogSG93IGEgcXVlcnkgaXMgbWF0Y2hlZC4gYGh5YnJpZGAgKHRoZSBkZWZhdWx0KSBmdXNlcyB2ZWN0b3Igc2ltaWxhcml0eSB3aXRoXG4gKiBCTTI1IGtleXdvcmQgcmFua2luZyAtIHRoZSByaWdodCBjaG9pY2UgZm9yIG1vc3Qgc2VhcmNoIGJveGVzIGFuZCBmb3Igc291cmNlXG4gKiBkYXRhIHdpdGggZXhhY3QgaWRlbnRpZmllcnMgKFNLVXMsIGVycm9yIGNvZGVzKS4gYHZlY3RvcmAgaXMgcHVyZSBzZW1hbnRpY1xuICogc2ltaWxhcml0eTsgYGtleXdvcmRgIGlzIHB1cmUgQk0yNSBmdWxsLXRleHQgKEJldGEgb24gRGF0YWJyaWNrcykuIFRoZVxuICogdmFsdWUgbWFwcyBvbnRvIHRoZSBzZXJ2aW5nIEFQSSdzIGBxdWVyeV90eXBlYCAoYEFOTmAgLyBgSFlCUklEYCkuXG4gKi9cbmV4cG9ydCBjb25zdCBzZWFyY2hNb2RlU2NoZW1hID0gelxuICAuZW51bShbXCJoeWJyaWRcIiwgXCJ2ZWN0b3JcIiwgXCJrZXl3b3JkXCJdKVxuICAuZGVzY3JpYmUoXG4gICAgXCJNYXRjaCBzdHJhdGVneTogJ2h5YnJpZCcgZnVzZXMgc2VtYW50aWMgc2ltaWxhcml0eSB3aXRoIGtleXdvcmQgcmFua2luZyAoZGVmYXVsdCwgYmVzdCBmb3IgbW9zdCBzZWFyY2hlcyksICd2ZWN0b3InIGlzIHB1cmUgc2VtYW50aWMsICdrZXl3b3JkJyBpcyBwdXJlIGZ1bGwtdGV4dC5cIixcbiAgKTtcblxuLyoqIEhvdyBhIHF1ZXJ5IGlzIG1hdGNoZWQgKHNlZSB7QGxpbmsgc2VhcmNoTW9kZVNjaGVtYX0pLiAqL1xuZXhwb3J0IHR5cGUgU2VhcmNoTW9kZSA9IHouaW5mZXI8dHlwZW9mIHNlYXJjaE1vZGVTY2hlbWE+O1xuXG4vKiogU2NoZW1hIGZvciBhIHNlYXJjaCByZXF1ZXN0IGFnYWluc3QgYSBzaW5nbGUgaW5kZXguICovXG5leHBvcnQgY29uc3Qgc2VhcmNoUmVxdWVzdFNjaGVtYSA9IHoub2JqZWN0KHtcbiAgcXVlcnk6IHpcbiAgICAuc3RyaW5nKClcbiAgICAuZGVzY3JpYmUoXG4gICAgICBcIldoYXQgdG8gc2VhcmNoIGZvciwgYXMgbmF0dXJhbCBsYW5ndWFnZSBvciBrZXl3b3Jkcy4gUHJlZml4IGZyYWdtZW50cyB3b3JrIGZvciBhdXRvY29tcGxldGUuXCIsXG4gICAgKSxcbiAgaW5kZXg6IHpcbiAgICAuc3RyaW5nKClcbiAgICAub3B0aW9uYWwoKVxuICAgIC5kZXNjcmliZShcbiAgICAgIFwiVW5pdHkgQ2F0YWxvZyBuYW1lIG9mIHRoZSBpbmRleCB0byBzZWFyY2ggKGNhdGFsb2cuc2NoZW1hLmluZGV4KS4gRGVmYXVsdHMgdG8gdGhlIHBsdWdpbidzIGNvbmZpZ3VyZWQgaW5kZXguIEFjY2VwdHMgYSBzaG9ydCBhbGlhcyB3aGVuIG9uZSBpcyBjb25maWd1cmVkLlwiLFxuICAgICksXG4gIGxpbWl0OiB6XG4gICAgLm51bWJlcigpXG4gICAgLmludCgpXG4gICAgLnBvc2l0aXZlKClcbiAgICAub3B0aW9uYWwoKVxuICAgIC5kZXNjcmliZShcIk1heGltdW0gbnVtYmVyIG9mIGhpdHMgdG8gcmV0dXJuLiBEZWZhdWx0cyB0byB0aGUgcGx1Z2luJ3MgY29uZmlndXJlZCBwYWdlIHNpemUuXCIpLFxuICBtb2RlOiBzZWFyY2hNb2RlU2NoZW1hLm9wdGlvbmFsKCksXG4gIGNvbHVtbnM6IHpcbiAgICAuYXJyYXkoei5zdHJpbmcoKSlcbiAgICAub3B0aW9uYWwoKVxuICAgIC5kZXNjcmliZShcbiAgICAgIFwiV2hpY2ggZG9jdW1lbnQgY29sdW1ucyB0byByZXR1cm4gcGVyIGhpdC4gRGVmYXVsdHMgdG8gdGhlIHBsdWdpbidzIGNvbmZpZ3VyZWQgY29sdW1ucyAob3IgYWxsIGluZGV4ZWQgY29sdW1ucykuXCIsXG4gICAgKSxcbiAgZmlsdGVyOiB6XG4gICAgLnJlY29yZCh6LnN0cmluZygpLCB6LnVua25vd24oKSlcbiAgICAub3B0aW9uYWwoKVxuICAgIC5kZXNjcmliZShcbiAgICAgICdBdHRyaWJ1dGUgZmlsdGVycyBhcyB7IGNvbHVtbjogdmFsdWUgfSAoYSB2YWx1ZSwgb3IgYW4gb3BlcmF0b3IgbWFwIGxpa2UgeyBcIj49XCI6IDEwIH0pLiBDb21iaW5lZCB3aXRoIEFORC4gTWFwcyBvbnRvIHRoZSBpbmRleCBgZmlsdGVyc19qc29uYC4nLFxuICAgICksXG4gIHNjb3JlVGhyZXNob2xkOiB6XG4gICAgLm51bWJlcigpXG4gICAgLm9wdGlvbmFsKClcbiAgICAuZGVzY3JpYmUoXCJEcm9wIGhpdHMgd2hvc2UgcmVsZXZhbmNlIHNjb3JlIGlzIGJlbG93IHRoaXMgdmFsdWUuXCIpLFxufSk7XG5cbi8qKiBBIHZhbGlkYXRlZCBzZWFyY2ggcmVxdWVzdCAoe0BsaW5rIHNlYXJjaFJlcXVlc3RTY2hlbWF9KS4gKi9cbmV4cG9ydCB0eXBlIFNlYXJjaFJlcXVlc3QgPSB6LmluZmVyPHR5cGVvZiBzZWFyY2hSZXF1ZXN0U2NoZW1hPjtcblxuLyoqIFNjaGVtYSBmb3IgYSBzaW5nbGUgc2VhcmNoIGhpdC4gKi9cbmV4cG9ydCBjb25zdCBzZWFyY2hIaXRTY2hlbWEgPSB6Lm9iamVjdCh7XG4gIGlkOiB6LnN0cmluZygpLmRlc2NyaWJlKFwiVGhlIGRvY3VtZW50J3MgcHJpbWFyeS1rZXkgdmFsdWUuXCIpLFxuICBzY29yZTogei5udW1iZXIoKS5kZXNjcmliZShcIlJlbGV2YW5jZSBzY29yZTsgaGlnaGVyIGlzIG1vcmUgcmVsZXZhbnQuXCIpLFxuICBmaWVsZHM6IHpcbiAgICAucmVjb3JkKHouc3RyaW5nKCksIHoudW5rbm93bigpKVxuICAgIC5kZXNjcmliZShcIlRoZSByZXR1cm5lZCBjb2x1bW5zIGZvciB0aGlzIGRvY3VtZW50LCBrZXllZCBieSBjb2x1bW4gbmFtZS5cIiksXG4gIGluZGV4OiB6XG4gICAgLnN0cmluZygpXG4gICAgLm9wdGlvbmFsKClcbiAgICAuZGVzY3JpYmUoXCJXaGljaCBpbmRleCB0aGUgaGl0IGNhbWUgZnJvbSAoc2V0IG9uIHVuaXZlcnNhbC9mZWRlcmF0ZWQgcmVzdWx0cykuXCIpLFxufSk7XG5cbi8qKiBBIHNpbmdsZSBzZWFyY2ggaGl0ICh7QGxpbmsgc2VhcmNoSGl0U2NoZW1hfSkuICovXG5leHBvcnQgdHlwZSBTZWFyY2hIaXQgPSB6LmluZmVyPHR5cGVvZiBzZWFyY2hIaXRTY2hlbWE+O1xuXG4vKiogU2NoZW1hIGZvciB0aGUgcmVzdWx0IG9mIGEgc2VhcmNoLiAqL1xuZXhwb3J0IGNvbnN0IHNlYXJjaFJlc3VsdFNjaGVtYSA9IHoub2JqZWN0KHtcbiAgcXVlcnk6IHouc3RyaW5nKCkuZGVzY3JpYmUoXCJFY2hvIG9mIHRoZSBxdWVyeSB0aGF0IHdhcyBzZWFyY2hlZC5cIiksXG4gIGhpdHM6IHouYXJyYXkoc2VhcmNoSGl0U2NoZW1hKS5kZXNjcmliZShcIk1hdGNoaW5nIGRvY3VtZW50cywgbW9zdCByZWxldmFudCBmaXJzdC5cIiksXG4gIGluZGV4OiB6LnN0cmluZygpLm9wdGlvbmFsKCkuZGVzY3JpYmUoXCJUaGUgaW5kZXggc2VhcmNoZWQgKG9taXR0ZWQgZm9yIGEgdW5pdmVyc2FsIHNlYXJjaCkuXCIpLFxuICBjb3VudDogei5udW1iZXIoKS5pbnQoKS5kZXNjcmliZShcIk51bWJlciBvZiBoaXRzIHJldHVybmVkLlwiKSxcbn0pO1xuXG4vKiogVGhlIG91dGNvbWUgb2YgYSBzZWFyY2ggKHtAbGluayBzZWFyY2hSZXN1bHRTY2hlbWF9KS4gKi9cbmV4cG9ydCB0eXBlIFNlYXJjaFJlc3VsdCA9IHouaW5mZXI8dHlwZW9mIHNlYXJjaFJlc3VsdFNjaGVtYT47XG5cbi8qKiBTY2hlbWEgZm9yIGEgdW5pdmVyc2FsIChmZWRlcmF0ZWQpIHNlYXJjaCBhY3Jvc3Mgc2V2ZXJhbCBpbmRleGVzIGF0IG9uY2UuICovXG5leHBvcnQgY29uc3QgdW5pdmVyc2FsU2VhcmNoUmVxdWVzdFNjaGVtYSA9IHoub2JqZWN0KHtcbiAgcXVlcnk6IHouc3RyaW5nKCkuZGVzY3JpYmUoXCJXaGF0IHRvIHNlYXJjaCBmb3IgYWNyb3NzIGV2ZXJ5IGNvbmZpZ3VyZWQgaW5kZXguXCIpLFxuICBpbmRleGVzOiB6XG4gICAgLmFycmF5KHouc3RyaW5nKCkpXG4gICAgLm9wdGlvbmFsKClcbiAgICAuZGVzY3JpYmUoXCJXaGljaCBpbmRleGVzIHRvIHNlYXJjaC4gRGVmYXVsdHMgdG8gZXZlcnkgaW5kZXggdGhlIHBsdWdpbiBrbm93cyBhYm91dC5cIiksXG4gIGxpbWl0OiB6XG4gICAgLm51bWJlcigpXG4gICAgLmludCgpXG4gICAgLnBvc2l0aXZlKClcbiAgICAub3B0aW9uYWwoKVxuICAgIC5kZXNjcmliZShcIk1heGltdW0gaGl0cyBQRVIgaW5kZXggYmVmb3JlIHJlc3VsdHMgYXJlIG1lcmdlZCBhbmQgcmUtcmFua2VkLlwiKSxcbiAgbW9kZTogc2VhcmNoTW9kZVNjaGVtYS5vcHRpb25hbCgpLFxufSk7XG5cbi8qKiBBIHZhbGlkYXRlZCB1bml2ZXJzYWwtc2VhcmNoIHJlcXVlc3QgKHtAbGluayB1bml2ZXJzYWxTZWFyY2hSZXF1ZXN0U2NoZW1hfSkuICovXG5leHBvcnQgdHlwZSBVbml2ZXJzYWxTZWFyY2hSZXF1ZXN0ID0gei5pbmZlcjx0eXBlb2YgdW5pdmVyc2FsU2VhcmNoUmVxdWVzdFNjaGVtYT47XG5cbi8qKiBTY2hlbWEgZm9yIGEgZG9jdW1lbnQgd3JpdHRlbiB0byBhIGRpcmVjdC1hY2Nlc3MgaW5kZXguICovXG5leHBvcnQgY29uc3Qgc2VhcmNoRG9jdW1lbnRTY2hlbWEgPSB6XG4gIC5yZWNvcmQoei5zdHJpbmcoKSwgei51bmtub3duKCkpXG4gIC5kZXNjcmliZShcIkEgZG9jdW1lbnQgYXMgeyBjb2x1bW46IHZhbHVlIH0uIE11c3QgaW5jbHVkZSB0aGUgaW5kZXggcHJpbWFyeS1rZXkgY29sdW1uLlwiKTtcblxuLyoqIEEgZG9jdW1lbnQgd3JpdHRlbiB0byBhbiBpbmRleCAoe0BsaW5rIHNlYXJjaERvY3VtZW50U2NoZW1hfSkuICovXG5leHBvcnQgdHlwZSBTZWFyY2hEb2N1bWVudCA9IHouaW5mZXI8dHlwZW9mIHNlYXJjaERvY3VtZW50U2NoZW1hPjtcblxuLyoqIFNjaGVtYSBmb3IgdGhlIHJlc3VsdCBvZiBhZGRpbmcgLyB1cGRhdGluZyBkb2N1bWVudHMuICovXG5leHBvcnQgY29uc3QgdXBzZXJ0UmVzdWx0U2NoZW1hID0gei5vYmplY3Qoe1xuICBpbmRleDogei5zdHJpbmcoKS5kZXNjcmliZShcIlRoZSBpbmRleCB0aGUgZG9jdW1lbnRzIHdlcmUgd3JpdHRlbiB0by5cIiksXG4gIGNvdW50OiB6Lm51bWJlcigpLmludCgpLmRlc2NyaWJlKFwiTnVtYmVyIG9mIGRvY3VtZW50cyBhY2NlcHRlZC5cIiksXG59KTtcblxuLyoqIFRoZSBvdXRjb21lIG9mIGFuIGFkZC1kb2N1bWVudHMgY2FsbCAoe0BsaW5rIHVwc2VydFJlc3VsdFNjaGVtYX0pLiAqL1xuZXhwb3J0IHR5cGUgVXBzZXJ0UmVzdWx0ID0gei5pbmZlcjx0eXBlb2YgdXBzZXJ0UmVzdWx0U2NoZW1hPjtcblxuLyoqXG4gKiBTY2hlbWEgZm9yIHRoZSBib290LXRpbWUgaW5kZXggY2F0YWxvZ3VlIGEgVUkgcmVhZHMgdG8gcG9wdWxhdGUgYSBzZWFyY2ggYm94XG4gKiAodGhlIHBheWxvYWQgb2YgdGhlIHBsdWdpbidzIGNsaWVudCBjb25maWcgLyBgR0VUIC9hcGkvc2VhcmNoL2luZGV4ZXNgKS4gQW5cbiAqIGVudHJ5IG5hbWVzIGFuIGluZGV4LCBhbiBvcHRpb25hbCBzaG9ydCBhbGlhcywgYW5kIHRoZSBjb2x1bW5zIHdvcnRoXG4gKiBzaG93aW5nLCBzbyBhIHNlYXJjaCBib3ggbmVlZHMgbm8gc2VydmVyIHJvdW5kLXRyaXAgdG8gcmVuZGVyLlxuICovXG5leHBvcnQgY29uc3Qgc2VhcmNoSW5kZXhJbmZvU2NoZW1hID0gei5vYmplY3Qoe1xuICBuYW1lOiB6LnN0cmluZygpLmRlc2NyaWJlKFwiVW5pdHkgQ2F0YWxvZyBuYW1lIG9mIHRoZSBpbmRleCAoY2F0YWxvZy5zY2hlbWEuaW5kZXgpLlwiKSxcbiAgYWxpYXM6IHouc3RyaW5nKCkub3B0aW9uYWwoKS5kZXNjcmliZShcIlNob3J0IGFsaWFzIHRoZSBwbHVnaW4gYWNjZXB0cyBpbiBwbGFjZSBvZiBgbmFtZWAuXCIpLFxuICBwcmltYXJ5S2V5OiB6LnN0cmluZygpLm9wdGlvbmFsKCkuZGVzY3JpYmUoXCJUaGUgaW5kZXgncyBwcmltYXJ5LWtleSBjb2x1bW4sIHdoZW4ga25vd24uXCIpLFxuICBjb2x1bW5zOiB6XG4gICAgLmFycmF5KHouc3RyaW5nKCkpXG4gICAgLm9wdGlvbmFsKClcbiAgICAuZGVzY3JpYmUoXCJDb2x1bW5zIHJldHVybmVkIGJ5IGRlZmF1bHQsIGluIGRpc3BsYXkgb3JkZXIuXCIpLFxuICBpc0RlZmF1bHQ6IHouYm9vbGVhbigpLm9wdGlvbmFsKCkuZGVzY3JpYmUoXCJUcnVlIGZvciB0aGUgcGx1Z2luJ3MgZGVmYXVsdCBpbmRleC5cIiksXG59KTtcblxuLyoqIE9uZSBlbnRyeSBpbiB0aGUgaW5kZXggY2F0YWxvZ3VlICh7QGxpbmsgc2VhcmNoSW5kZXhJbmZvU2NoZW1hfSkuICovXG5leHBvcnQgdHlwZSBTZWFyY2hJbmRleEluZm8gPSB6LmluZmVyPHR5cGVvZiBzZWFyY2hJbmRleEluZm9TY2hlbWE+O1xuXG4vKiogU2NoZW1hIGZvciB0aGUgcGx1Z2luJ3MgY2xpZW50IGNvbmZpZyBzdXJmYWNlZCB0byBhIFVJLiAqL1xuZXhwb3J0IGNvbnN0IHNlYXJjaENsaWVudENvbmZpZ1NjaGVtYSA9IHoub2JqZWN0KHtcbiAgaW5kZXhlczogei5hcnJheShzZWFyY2hJbmRleEluZm9TY2hlbWEpLmRlc2NyaWJlKFwiSW5kZXhlcyB0aGUgc2VhcmNoIFVJIG1heSBxdWVyeS5cIiksXG4gIGRlZmF1bHRJbmRleDogei5zdHJpbmcoKS5vcHRpb25hbCgpLmRlc2NyaWJlKFwiVGhlIGluZGV4IGEgc2VhcmNoIGJveCBzZWxlY3RzIGJ5IGRlZmF1bHQuXCIpLFxuICBwYWdlU2l6ZTogei5udW1iZXIoKS5pbnQoKS5kZXNjcmliZShcIkRlZmF1bHQgbnVtYmVyIG9mIGhpdHMgYSBzZWFyY2ggcmV0dXJucy5cIiksXG4gIGJhc2VQYXRoOiB6XG4gICAgLnN0cmluZygpXG4gICAgLmRlc2NyaWJlKFwiQmFzZSBwYXRoIHRoZSBzZWFyY2ggcm91dGVzIGFyZSBtb3VudGVkIHVuZGVyIChlLmcuIC9hcGkvc2VhcmNoKS5cIiksXG59KTtcblxuLyoqIFRoZSBwbHVnaW4ncyBjbGllbnQgY29uZmlnICh7QGxpbmsgc2VhcmNoQ2xpZW50Q29uZmlnU2NoZW1hfSkuICovXG5leHBvcnQgdHlwZSBTZWFyY2hDbGllbnRDb25maWcgPSB6LmluZmVyPHR5cGVvZiBzZWFyY2hDbGllbnRDb25maWdTY2hlbWE+O1xuXG4vKipcbiAqIFNjaGVtYSBmb3IgY3JlYXRpbmcgYW4gaW5kZXggKHRoZSBgY3JlYXRlX2luZGV4YCB0b29sIGlucHV0IC8gdGhlXG4gKiBgUE9TVCAvYXBpL3NlYXJjaC9pbmRleGAgYm9keSkuIFR3byBzaGFwZXMsIGJvdGggaW5mZXJyaW5nIGFnZ3Jlc3NpdmVseTpcbiAqIHBhc3MgYHNvdXJjZVRhYmxlYCBmb3IgYSBEZWx0YSBTeW5jIGluZGV4IChEYXRhYnJpY2tzIGNvbXB1dGVzIGVtYmVkZGluZ3MgYW5kXG4gKiBrZWVwcyBpdCBzeW5jZWQpIG9yIGBlbWJlZGRpbmdEaW1lbnNpb25gIGZvciBhIGRpcmVjdC1hY2Nlc3MgaW5kZXggeW91IHdyaXRlXG4gKiB2ZWN0b3JzIHRvIHlvdXJzZWxmLlxuICovXG5leHBvcnQgY29uc3QgY3JlYXRlSW5kZXhSZXF1ZXN0U2NoZW1hID0gei5vYmplY3Qoe1xuICBuYW1lOiB6LnN0cmluZygpLmRlc2NyaWJlKFwiVW5pdHkgQ2F0YWxvZyBuYW1lIGZvciB0aGUgbmV3IGluZGV4IChjYXRhbG9nLnNjaGVtYS5pbmRleCkuXCIpLFxuICBzb3VyY2VUYWJsZTogelxuICAgIC5zdHJpbmcoKVxuICAgIC5vcHRpb25hbCgpXG4gICAgLmRlc2NyaWJlKFxuICAgICAgXCJEZWx0YSB0YWJsZSAoY2F0YWxvZy5zY2hlbWEudGFibGUpIHRvIGJ1aWxkIGEgc3luY2VkIGluZGV4IGZyb20uIFByb3ZpZGUgdGhpcyBPUiBlbWJlZGRpbmdEaW1lbnNpb24uXCIsXG4gICAgKSxcbiAgcHJpbWFyeUtleTogei5zdHJpbmcoKS5vcHRpb25hbCgpLmRlc2NyaWJlKFwiUHJpbWFyeS1rZXkgY29sdW1uLiBEZWZhdWx0cyB0byAnaWQnLlwiKSxcbiAgZW1iZWRkaW5nU291cmNlQ29sdW1uOiB6XG4gICAgLnN0cmluZygpXG4gICAgLm9wdGlvbmFsKClcbiAgICAuZGVzY3JpYmUoXG4gICAgICBcIlRleHQgY29sdW1uIGVtYmVkZGluZ3MgYXJlIGNvbXB1dGVkIGZyb20gKERlbHRhIFN5bmMpLiBEZWZhdWx0cyB0byB0aGUgZmlyc3Qgb2YgdGV4dC9jb250ZW50L2JvZHkuXCIsXG4gICAgKSxcbiAgZW1iZWRkaW5nTW9kZWw6IHpcbiAgICAuc3RyaW5nKClcbiAgICAub3B0aW9uYWwoKVxuICAgIC5kZXNjcmliZShcbiAgICAgIFwiRW1iZWRkaW5nIG1vZGVsIGVuZHBvaW50IChuYW1lIG9yIGxvb3NlIG5hbWUpLiBEZWZhdWx0cyB0byB0aGUgYXBwJ3MgZW1iZWRkaW5nIG1vZGVsLCBvciB0aGUgYmVzdCBlbWJlZGRpbmcgZW5kcG9pbnQgaW4gdGhlIHdvcmtzcGFjZS5cIixcbiAgICApLFxuICBlbmRwb2ludDogelxuICAgIC5zdHJpbmcoKVxuICAgIC5vcHRpb25hbCgpXG4gICAgLmRlc2NyaWJlKFxuICAgICAgXCJWZWN0b3IgU2VhcmNoIGVuZHBvaW50IHRvIGhvc3QgdGhlIGluZGV4IG9uLiBEZWZhdWx0cyB0byB0aGUgYXBwJ3MgY29uZmlndXJlZCBlbmRwb2ludC5cIixcbiAgICApLFxuICBlbWJlZGRpbmdEaW1lbnNpb246IHpcbiAgICAubnVtYmVyKClcbiAgICAuaW50KClcbiAgICAucG9zaXRpdmUoKVxuICAgIC5vcHRpb25hbCgpXG4gICAgLmRlc2NyaWJlKFwiRm9yIGEgZGlyZWN0LWFjY2VzcyBpbmRleCAobm8gc291cmNlIHRhYmxlKTogdGhlIGVtYmVkZGluZyB2ZWN0b3IgZGltZW5zaW9uLlwiKSxcbiAgcGlwZWxpbmVUeXBlOiB6XG4gICAgLmVudW0oW1wiVFJJR0dFUkVEXCIsIFwiQ09OVElOVU9VU1wiXSlcbiAgICAub3B0aW9uYWwoKVxuICAgIC5kZXNjcmliZShcbiAgICAgIFwiRGVsdGEgU3luYyBtb2RlOiAnVFJJR0dFUkVEJyAoZGVmYXVsdCkgc3luY3Mgb24gZGVtYW5kOyAnQ09OVElOVU9VUycga2VlcHMgdGhlIGluZGV4IGZyZXNoLlwiLFxuICAgICksXG4gIGNvbHVtbnNUb1N5bmM6IHpcbiAgICAuYXJyYXkoei5zdHJpbmcoKSlcbiAgICAub3B0aW9uYWwoKVxuICAgIC5kZXNjcmliZShcIkV4dHJhIGNvbHVtbnMgdG8gc3luYyBhbG9uZ3NpZGUgdGhlIGVtYmVkZGluZyBzb3VyY2UgY29sdW1uIChEZWx0YSBTeW5jKS5cIiksXG59KTtcblxuLyoqIEEgdmFsaWRhdGVkIGNyZWF0ZS1pbmRleCByZXF1ZXN0ICh7QGxpbmsgY3JlYXRlSW5kZXhSZXF1ZXN0U2NoZW1hfSkuICovXG5leHBvcnQgdHlwZSBDcmVhdGVJbmRleFJlcXVlc3QgPSB6LmluZmVyPHR5cGVvZiBjcmVhdGVJbmRleFJlcXVlc3RTY2hlbWE+O1xuXG4vKiogU2NoZW1hIGZvciB0aGUgYHN5bmNfaW5kZXhgIHRvb2wgaW5wdXQgLyB0aGUgYFBPU1QgL2FwaS9zZWFyY2gvaW5kZXgvc3luY2AgYm9keS4gKi9cbmV4cG9ydCBjb25zdCBzeW5jSW5kZXhSZXF1ZXN0U2NoZW1hID0gei5vYmplY3Qoe1xuICBpbmRleDogelxuICAgIC5zdHJpbmcoKVxuICAgIC5kZXNjcmliZShcbiAgICAgIFwiVGhlIGluZGV4IHRvIHN5bmMgKG5hbWUgb3IgY29uZmlndXJlZCBhbGlhcykuIERlZmF1bHRzIHRvIHRoZSBhcHAncyBkZWZhdWx0IGluZGV4IHdoZW4gb21pdHRlZC5cIixcbiAgICApXG4gICAgLm9wdGlvbmFsKCksXG59KTtcblxuLyoqIEEgdmFsaWRhdGVkIHN5bmMtaW5kZXggcmVxdWVzdCAoe0BsaW5rIHN5bmNJbmRleFJlcXVlc3RTY2hlbWF9KS4gKi9cbmV4cG9ydCB0eXBlIFN5bmNJbmRleFJlcXVlc3QgPSB6LmluZmVyPHR5cGVvZiBzeW5jSW5kZXhSZXF1ZXN0U2NoZW1hPjtcblxuLyoqIFNjaGVtYSBmb3IgYSByZXNvbHZlZCBpbmRleCBkZWZpbml0aW9uICh0aGUgY3JlYXRlL2dldCByZXN1bHQpLiAqL1xuZXhwb3J0IGNvbnN0IGluZGV4SW5mb1NjaGVtYSA9IHoub2JqZWN0KHtcbiAgbmFtZTogei5zdHJpbmcoKS5kZXNjcmliZShcIlVuaXR5IENhdGFsb2cgbmFtZSBvZiB0aGUgaW5kZXguXCIpLFxuICBlbmRwb2ludDogei5zdHJpbmcoKS5vcHRpb25hbCgpLmRlc2NyaWJlKFwiVGhlIFZlY3RvciBTZWFyY2ggZW5kcG9pbnQgaG9zdGluZyB0aGUgaW5kZXguXCIpLFxuICBwcmltYXJ5S2V5OiB6LnN0cmluZygpLm9wdGlvbmFsKCkuZGVzY3JpYmUoXCJUaGUgaW5kZXgncyBwcmltYXJ5LWtleSBjb2x1bW4uXCIpLFxuICBjb2x1bW5zOiB6LmFycmF5KHouc3RyaW5nKCkpLmRlc2NyaWJlKFwiQ29sdW1ucyBhdmFpbGFibGUgb24gdGhlIGluZGV4LlwiKSxcbiAgcmVhZHk6IHouYm9vbGVhbigpLmRlc2NyaWJlKFwiVHJ1ZSB3aGVuIHRoZSBpbmRleCBoYXMgZmluaXNoZWQgcHJvdmlzaW9uaW5nIGFuZCBjYW4gYmUgcXVlcmllZC5cIiksXG4gIHJvd0NvdW50OiB6Lm51bWJlcigpLmludCgpLm9wdGlvbmFsKCkuZGVzY3JpYmUoXCJOdW1iZXIgb2YgaW5kZXhlZCByb3dzLCB3aGVuIGtub3duLlwiKSxcbn0pO1xuXG4vKiogQSByZXNvbHZlZCBpbmRleCBkZWZpbml0aW9uICh7QGxpbmsgaW5kZXhJbmZvU2NoZW1hfSkuICovXG5leHBvcnQgdHlwZSBJbmRleEluZm8gPSB6LmluZmVyPHR5cGVvZiBpbmRleEluZm9TY2hlbWE+O1xuIl19

package/lib/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../src/search.ts","../index.ts"],"version":"5.9.3"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@dbx-tools/shared-search",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/reggie-db/dbx-tools.git",
+    "directory": "packages/shared/search"
+  },
+  "devDependencies": {
+    "@types/node": "^24.6.0",
+    "tsx": "^4.23.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "zod": "4.3.6",
+    "@dbx-tools/shared-core": "0.6.9"
+  },
+  "main": "./lib/index.js",
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "0.6.9",
+  "types": "./lib/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.ts",
+    "src",
+    "lib"
+  ],
+  "dbxToolsConfig": {
+    "tags": [
+      "shared"
+    ]
+  },
+  "//": "~~ Generated by projen. To modify, edit .projenrc.js and run \"pnpm exec projen\".",
+  "scripts": {
+    "build": "projen build",
+    "compile": "projen compile",
+    "default": "projen default",
+    "package": "projen package",
+    "post-compile": "projen post-compile",
+    "pre-compile": "projen pre-compile",
+    "test": "projen test",
+    "watch": "projen watch",
+    "projen": "projen"
+  }
+}

package/src/search.ts

@@ -0,0 +1,259 @@
+/**
+ * Wire-format contract for the AI Search add-on: the query a caller (a UI
+ * search box, a Mastra tool, a universal-search route) sends and the hits it
+ * gets back, plus the document shape used to add / update index contents.
+ *
+ * Pure (zod + inferred types, no Node-only imports) so the server-side client
+ * in `@dbx-tools/search`, the Mastra tool, the `POST /api/search` route,
+ * and the React search box all validate / type against ONE definition.
+ *
+ * "AI Search" is Databricks' current name for Vector Search: an index built
+ * from a Delta table (or written directly) that answers a natural-language
+ * query with the most relevant rows, combining vector similarity with BM25
+ * keyword matching (hybrid). This contract is index-agnostic - it names the
+ * index by its Unity Catalog path and returns hits as `{ id, score, fields }`
+ * so the same shape serves an autocomplete box, a docs lookup, and a
+ * federated search across many indexes.
+ *
+ * Array fields intentionally avoid `.min()` / `.nonempty()`: those emit
+ * `minItems` in the JSON schema, which some Model Serving endpoints reject
+ * when the schema is forwarded as a tool definition.
+ *
+ * @module
+ */
+
+import { z } from "zod";
+
+/**
+ * How a query is matched. `hybrid` (the default) fuses vector similarity with
+ * BM25 keyword ranking - the right choice for most search boxes and for source
+ * data with exact identifiers (SKUs, error codes). `vector` is pure semantic
+ * similarity; `keyword` is pure BM25 full-text (Beta on Databricks). The
+ * value maps onto the serving API's `query_type` (`ANN` / `HYBRID`).
+ */
+export const searchModeSchema = z
+  .enum(["hybrid", "vector", "keyword"])
+  .describe(
+    "Match strategy: 'hybrid' fuses semantic similarity with keyword ranking (default, best for most searches), 'vector' is pure semantic, 'keyword' is pure full-text.",
+  );
+
+/** How a query is matched (see {@link searchModeSchema}). */
+export type SearchMode = z.infer<typeof searchModeSchema>;
+
+/** Schema for a search request against a single index. */
+export const searchRequestSchema = z.object({
+  query: z
+    .string()
+    .describe(
+      "What to search for, as natural language or keywords. Prefix fragments work for autocomplete.",
+    ),
+  index: z
+    .string()
+    .optional()
+    .describe(
+      "Unity Catalog name of the index to search (catalog.schema.index). Defaults to the plugin's configured index. Accepts a short alias when one is configured.",
+    ),
+  limit: z
+    .number()
+    .int()
+    .positive()
+    .optional()
+    .describe("Maximum number of hits to return. Defaults to the plugin's configured page size."),
+  mode: searchModeSchema.optional(),
+  columns: z
+    .array(z.string())
+    .optional()
+    .describe(
+      "Which document columns to return per hit. Defaults to the plugin's configured columns (or all indexed columns).",
+    ),
+  filter: z
+    .record(z.string(), z.unknown())
+    .optional()
+    .describe(
+      'Attribute filters as { column: value } (a value, or an operator map like { ">=": 10 }). Combined with AND. Maps onto the index `filters_json`.',
+    ),
+  scoreThreshold: z
+    .number()
+    .optional()
+    .describe("Drop hits whose relevance score is below this value."),
+});
+
+/** A validated search request ({@link searchRequestSchema}). */
+export type SearchRequest = z.infer<typeof searchRequestSchema>;
+
+/** Schema for a single search hit. */
+export const searchHitSchema = z.object({
+  id: z.string().describe("The document's primary-key value."),
+  score: z.number().describe("Relevance score; higher is more relevant."),
+  fields: z
+    .record(z.string(), z.unknown())
+    .describe("The returned columns for this document, keyed by column name."),
+  index: z
+    .string()
+    .optional()
+    .describe("Which index the hit came from (set on universal/federated results)."),
+});
+
+/** A single search hit ({@link searchHitSchema}). */
+export type SearchHit = z.infer<typeof searchHitSchema>;
+
+/** Schema for the result of a search. */
+export const searchResultSchema = z.object({
+  query: z.string().describe("Echo of the query that was searched."),
+  hits: z.array(searchHitSchema).describe("Matching documents, most relevant first."),
+  index: z.string().optional().describe("The index searched (omitted for a universal search)."),
+  count: z.number().int().describe("Number of hits returned."),
+});
+
+/** The outcome of a search ({@link searchResultSchema}). */
+export type SearchResult = z.infer<typeof searchResultSchema>;
+
+/** Schema for a universal (federated) search across several indexes at once. */
+export const universalSearchRequestSchema = z.object({
+  query: z.string().describe("What to search for across every configured index."),
+  indexes: z
+    .array(z.string())
+    .optional()
+    .describe("Which indexes to search. Defaults to every index the plugin knows about."),
+  limit: z
+    .number()
+    .int()
+    .positive()
+    .optional()
+    .describe("Maximum hits PER index before results are merged and re-ranked."),
+  mode: searchModeSchema.optional(),
+});
+
+/** A validated universal-search request ({@link universalSearchRequestSchema}). */
+export type UniversalSearchRequest = z.infer<typeof universalSearchRequestSchema>;
+
+/** Schema for a document written to a direct-access index. */
+export const searchDocumentSchema = z
+  .record(z.string(), z.unknown())
+  .describe("A document as { column: value }. Must include the index primary-key column.");
+
+/** A document written to an index ({@link searchDocumentSchema}). */
+export type SearchDocument = z.infer<typeof searchDocumentSchema>;
+
+/** Schema for the result of adding / updating documents. */
+export const upsertResultSchema = z.object({
+  index: z.string().describe("The index the documents were written to."),
+  count: z.number().int().describe("Number of documents accepted."),
+});
+
+/** The outcome of an add-documents call ({@link upsertResultSchema}). */
+export type UpsertResult = z.infer<typeof upsertResultSchema>;
+
+/**
+ * Schema for the boot-time index catalogue a UI reads to populate a search box
+ * (the payload of the plugin's client config / `GET /api/search/indexes`). An
+ * entry names an index, an optional short alias, and the columns worth
+ * showing, so a search box needs no server round-trip to render.
+ */
+export const searchIndexInfoSchema = z.object({
+  name: z.string().describe("Unity Catalog name of the index (catalog.schema.index)."),
+  alias: z.string().optional().describe("Short alias the plugin accepts in place of `name`."),
+  primaryKey: z.string().optional().describe("The index's primary-key column, when known."),
+  columns: z
+    .array(z.string())
+    .optional()
+    .describe("Columns returned by default, in display order."),
+  isDefault: z.boolean().optional().describe("True for the plugin's default index."),
+});
+
+/** One entry in the index catalogue ({@link searchIndexInfoSchema}). */
+export type SearchIndexInfo = z.infer<typeof searchIndexInfoSchema>;
+
+/** Schema for the plugin's client config surfaced to a UI. */
+export const searchClientConfigSchema = z.object({
+  indexes: z.array(searchIndexInfoSchema).describe("Indexes the search UI may query."),
+  defaultIndex: z.string().optional().describe("The index a search box selects by default."),
+  pageSize: z.number().int().describe("Default number of hits a search returns."),
+  basePath: z
+    .string()
+    .describe("Base path the search routes are mounted under (e.g. /api/search)."),
+});
+
+/** The plugin's client config ({@link searchClientConfigSchema}). */
+export type SearchClientConfig = z.infer<typeof searchClientConfigSchema>;
+
+/**
+ * Schema for creating an index (the `create_index` tool input / the
+ * `POST /api/search/index` body). Two shapes, both inferring aggressively:
+ * pass `sourceTable` for a Delta Sync index (Databricks computes embeddings and
+ * keeps it synced) or `embeddingDimension` for a direct-access index you write
+ * vectors to yourself.
+ */
+export const createIndexRequestSchema = z.object({
+  name: z.string().describe("Unity Catalog name for the new index (catalog.schema.index)."),
+  sourceTable: z
+    .string()
+    .optional()
+    .describe(
+      "Delta table (catalog.schema.table) to build a synced index from. Provide this OR embeddingDimension.",
+    ),
+  primaryKey: z.string().optional().describe("Primary-key column. Defaults to 'id'."),
+  embeddingSourceColumn: z
+    .string()
+    .optional()
+    .describe(
+      "Text column embeddings are computed from (Delta Sync). Defaults to the first of text/content/body.",
+    ),
+  embeddingModel: z
+    .string()
+    .optional()
+    .describe(
+      "Embedding model endpoint (name or loose name). Defaults to the app's embedding model, or the best embedding endpoint in the workspace.",
+    ),
+  endpoint: z
+    .string()
+    .optional()
+    .describe(
+      "Vector Search endpoint to host the index on. Defaults to the app's configured endpoint.",
+    ),
+  embeddingDimension: z
+    .number()
+    .int()
+    .positive()
+    .optional()
+    .describe("For a direct-access index (no source table): the embedding vector dimension."),
+  pipelineType: z
+    .enum(["TRIGGERED", "CONTINUOUS"])
+    .optional()
+    .describe(
+      "Delta Sync mode: 'TRIGGERED' (default) syncs on demand; 'CONTINUOUS' keeps the index fresh.",
+    ),
+  columnsToSync: z
+    .array(z.string())
+    .optional()
+    .describe("Extra columns to sync alongside the embedding source column (Delta Sync)."),
+});
+
+/** A validated create-index request ({@link createIndexRequestSchema}). */
+export type CreateIndexRequest = z.infer<typeof createIndexRequestSchema>;
+
+/** Schema for the `sync_index` tool input / the `POST /api/search/index/sync` body. */
+export const syncIndexRequestSchema = z.object({
+  index: z
+    .string()
+    .describe(
+      "The index to sync (name or configured alias). Defaults to the app's default index when omitted.",
+    )
+    .optional(),
+});
+
+/** A validated sync-index request ({@link syncIndexRequestSchema}). */
+export type SyncIndexRequest = z.infer<typeof syncIndexRequestSchema>;
+
+/** Schema for a resolved index definition (the create/get result). */
+export const indexInfoSchema = z.object({
+  name: z.string().describe("Unity Catalog name of the index."),
+  endpoint: z.string().optional().describe("The Vector Search endpoint hosting the index."),
+  primaryKey: z.string().optional().describe("The index's primary-key column."),
+  columns: z.array(z.string()).describe("Columns available on the index."),
+  ready: z.boolean().describe("True when the index has finished provisioning and can be queried."),
+  rowCount: z.number().int().optional().describe("Number of indexed rows, when known."),
+});
+
+/** A resolved index definition ({@link indexInfoSchema}). */
+export type IndexInfo = z.infer<typeof indexInfoSchema>;