@databricks/appkit-ui 0.54.0 → 0.55.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (37) hide show
  1. package/CLAUDE.md +9 -2
  2. package/dist/cli/commands/plugin/create/create.js +12 -14
  3. package/dist/cli/commands/plugin/create/create.js.map +1 -1
  4. package/dist/cli/commands/plugin/promote/promote.js +2 -12
  5. package/dist/cli/commands/plugin/promote/promote.js.map +1 -1
  6. package/dist/naming.js +29 -0
  7. package/dist/react/beta.d.ts +3 -1
  8. package/dist/react/beta.js +3 -0
  9. package/dist/react/hooks/types.d.ts +32 -1
  10. package/dist/react/hooks/types.d.ts.map +1 -1
  11. package/dist/react/hooks/use-ai-search-query.d.ts +33 -0
  12. package/dist/react/hooks/use-ai-search-query.d.ts.map +1 -0
  13. package/dist/react/hooks/use-ai-search-query.js +75 -0
  14. package/dist/react/hooks/use-ai-search-query.js.map +1 -0
  15. package/dist/react/hooks/use-chart-data.d.ts +1 -1
  16. package/dist/react/index.d.ts +1 -1
  17. package/dist/schemas/manifest.d.ts.map +1 -1
  18. package/dist/schemas/manifest.js +3 -2
  19. package/dist/schemas/manifest.js.map +1 -1
  20. package/dist/shared/src/plugin.d.ts.map +1 -1
  21. package/docs/api/appkit/Interface.BasePluginConfig.md +1 -0
  22. package/docs/api/appkit/Interface.IAiSearchConfig.md +71 -0
  23. package/docs/api/appkit/Interface.IndexConfig.md +110 -0
  24. package/docs/api/appkit/Interface.RerankerConfig.md +10 -0
  25. package/docs/api/appkit/Interface.SearchRequest.md +64 -0
  26. package/docs/api/appkit/Interface.SearchResponse.md +52 -0
  27. package/docs/api/appkit/Interface.SearchResult.md +25 -0
  28. package/docs/api/appkit/TypeAlias.JobsExport.md +2 -5
  29. package/docs/api/appkit/TypeAlias.SearchFilters.md +6 -0
  30. package/docs/api/appkit/Variable.aiSearch.md +6 -0
  31. package/docs/api/appkit.md +8 -1
  32. package/docs/plugins/{vector-search.md → ai-search.md} +70 -27
  33. package/docs/plugins/jobs.md +1 -14
  34. package/llms.txt +9 -2
  35. package/package.json +1 -1
  36. package/sbom.cdx.json +1 -1
  37. package/docs/api/appkit/TypeAlias.JobHandle.md +0 -29
package/llms.txt CHANGED
@@ -44,6 +44,7 @@ npx @databricks/appkit docs <query>
44
44
  ## Plugins
45
45
 
46
46
  - [Agents](./docs/plugins/agents.md): This plugin is currently beta. APIs may change between minor releases. Import from @databricks/appkit/beta. See Plugin Stability Tiers.
47
+ - [AI Search plugin](./docs/plugins/ai-search.md): This plugin is currently beta. APIs may change between minor releases. Import from @databricks/appkit/beta. See Plugin Stability Tiers.
47
48
  - [Analytics plugin](./docs/plugins/analytics.md): Enables SQL query execution against Databricks SQL Warehouses.
48
49
  - [Caching](./docs/plugins/caching.md): AppKit provides both global and plugin-level caching capabilities.
49
50
  - [Creating custom plugins](./docs/plugins/custom-plugins.md): If you need custom API routes or background logic, implement an AppKit plugin. The fastest way is to use the CLI:
@@ -57,7 +58,6 @@ npx @databricks/appkit docs <query>
57
58
  - [Plugin management](./docs/plugins/plugin-management.md): AppKit includes a CLI for managing plugins. All commands are available under npx @databricks/appkit plugin.
58
59
  - [Server plugin](./docs/plugins/server.md): Provides HTTP server capabilities with development and production modes.
59
60
  - [Plugin Stability Tiers](./docs/plugins/stability.md): AppKit plugins have a two-tier stability system that communicates API maturity and breaking-change expectations.
60
- - [Vector Search plugin](./docs/plugins/vector-search.md): Query Databricks Vector Search indexes with hybrid search, reranking, and cursor pagination from your AppKit application.
61
61
 
62
62
  ## appkit API reference [collapsed]
63
63
 
@@ -131,7 +131,9 @@ npx @databricks/appkit docs <query>
131
131
  - [Interface: GenerateDatabaseCredentialRequest](./docs/api/appkit/Interface.GenerateDatabaseCredentialRequest.md): Request parameters for generating database OAuth credentials
132
132
  - [Interface: GenerationParams](./docs/api/appkit/Interface.GenerationParams.md): Optional generation parameters forwarded to the OpenAI-compatible serving
133
133
  - [Interface: HostedSupervisorTool](./docs/api/appkit/Interface.HostedSupervisorTool.md): Tagged record returned by every supervisorTools factory. The
134
+ - [Interface: IAiSearchConfig](./docs/api/appkit/Interface.IAiSearchConfig.md): Base configuration interface for AppKit plugins
134
135
  - [Interface: IJobsConfig](./docs/api/appkit/Interface.IJobsConfig.md): Configuration for the Jobs plugin.
136
+ - [Interface: IndexConfig](./docs/api/appkit/Interface.IndexConfig.md): Properties
135
137
  - [Interface: ITelemetry](./docs/api/appkit/Interface.ITelemetry.md): Plugin-facing interface for OpenTelemetry instrumentation.
136
138
  - [Interface: JobAPI](./docs/api/appkit/Interface.JobAPI.md): User-facing API for a single configured job.
137
139
  - [Interface: JobConfig](./docs/api/appkit/Interface.JobConfig.md): Per-job configuration options.
@@ -147,10 +149,14 @@ npx @databricks/appkit docs <query>
147
149
  - [Interface: RegisteredAgent](./docs/api/appkit/Interface.RegisteredAgent.md): Properties
148
150
  - [Interface: RequestedClaims](./docs/api/appkit/Interface.RequestedClaims.md): Optional claims for fine-grained Unity Catalog table permissions
149
151
  - [Interface: RequestedResource](./docs/api/appkit/Interface.RequestedResource.md): Resource to request permissions for in Unity Catalog
152
+ - [Interface: RerankerConfig](./docs/api/appkit/Interface.RerankerConfig.md): Properties
150
153
  - [Interface: ResourceEntry](./docs/api/appkit/Interface.ResourceEntry.md): Internal representation of a resource in the registry.
151
154
  - [Interface: ResourceRequirement](./docs/api/appkit/Interface.ResourceRequirement.md): Declares a resource requirement for a plugin.
152
155
  - [Interface: RunAgentInput](./docs/api/appkit/Interface.RunAgentInput.md): Properties
153
156
  - [Interface: RunAgentResult](./docs/api/appkit/Interface.RunAgentResult.md): Properties
157
+ - [Interface: SearchRequest](./docs/api/appkit/Interface.SearchRequest.md): Properties
158
+ - [Interface: SearchResponse<T>](./docs/api/appkit/Interface.SearchResponse.md): Type Parameters
159
+ - [Interface: SearchResult<T>](./docs/api/appkit/Interface.SearchResult.md): Type Parameters
154
160
  - [Interface: ServingEndpointEntry](./docs/api/appkit/Interface.ServingEndpointEntry.md): Shape of a single registry entry.
155
161
  - [Interface: ServingEndpointRegistry](./docs/api/appkit/Interface.ServingEndpointRegistry.md): Registry interface for serving endpoint type generation.
156
162
  - [Interface: StreamExecutionSettings](./docs/api/appkit/Interface.StreamExecutionSettings.md): Execution settings for streaming endpoints. Extends PluginExecutionSettings with SSE stream configuration.
@@ -180,18 +186,19 @@ npx @databricks/appkit docs <query>
180
186
  - [Type Alias: FilePolicy()](./docs/api/appkit/TypeAlias.FilePolicy.md): A policy function that decides whether user may perform action on
181
187
  - [Type Alias: HostedTool](./docs/api/appkit/TypeAlias.HostedTool.md)
182
188
  - [Type Alias: IAppRouter](./docs/api/appkit/TypeAlias.IAppRouter.md): Express router type for plugin route registration
183
- - [Type Alias: JobHandle](./docs/api/appkit/TypeAlias.JobHandle.md): Job handle returned by appkit.jobs("etl").
184
189
  - [Type Alias: JobsExport()](./docs/api/appkit/TypeAlias.JobsExport.md): Public API shape of the jobs plugin.
185
190
  - [Type Alias: PluginData<T, U, N>](./docs/api/appkit/TypeAlias.PluginData.md): Tuple of plugin class, config, and name. Created by toPlugin() and passed to createApp().
186
191
  - [Type Alias: Plugins](./docs/api/appkit/TypeAlias.Plugins.md): Plugin map passed to the function form of AgentDefinition.tools.
187
192
  - [Type Alias: ResolvedToolEntry](./docs/api/appkit/TypeAlias.ResolvedToolEntry.md): Internal tool-index entry after a tool record has been resolved to a dispatchable form.
188
193
  - [Type Alias: ResourceFieldEntry](./docs/api/appkit/TypeAlias.ResourceFieldEntry.md)
189
194
  - [Type Alias: ResourcePermission](./docs/api/appkit/TypeAlias.ResourcePermission.md): Union of all possible permission levels across all resource types.
195
+ - [Type Alias: SearchFilters](./docs/api/appkit/TypeAlias.SearchFilters.md)
190
196
  - [Type Alias: ServingFactory](./docs/api/appkit/TypeAlias.ServingFactory.md): Factory function returned by AppKit.serving.
191
197
  - [Type Alias: SupervisorTool](./docs/api/appkit/TypeAlias.SupervisorTool.md): Tools supported by the Databricks AI Gateway Responses API. The shapes match
192
198
  - [Type Alias: ToolRegistry](./docs/api/appkit/TypeAlias.ToolRegistry.md)
193
199
  - [Type Alias: ToPlugin()<T, U, N>](./docs/api/appkit/TypeAlias.ToPlugin.md): Factory function type returned by toPlugin(). Accepts optional config and returns a PluginData tuple.
194
200
  - [Variable: agents](./docs/api/appkit/Variable.agents.md): Plugin factory for the agents plugin. Reads config/agents/*.md by default,
201
+ - [Variable: aiSearch](./docs/api/appkit/Variable.aiSearch.md)
195
202
  - [Variable: READ_ACTIONS](./docs/api/appkit/Variable.READ_ACTIONS.md): Actions that only read data.
196
203
  - [Variable: sql](./docs/api/appkit/Variable.sql.md): SQL helper namespace
197
204
  - [Variable: SUPERVISOR_EXTENSION_KEY](./docs/api/appkit/Variable.SUPERVISOR_EXTENSION_KEY.md): Namespace key under which the adapter reads its hosted-tool payload
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@databricks/appkit-ui",
3
3
  "type": "module",
4
- "version": "0.54.0",
4
+ "version": "0.55.1",
5
5
  "license": "Apache-2.0",
6
6
  "sideEffects": [
7
7
  "**/*.css"