@databricks/appkit 0.65.0 → 0.66.0

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 (113) hide show
  1. package/CLAUDE.md +18 -0
  2. package/dist/appkit/package.js +1 -1
  3. package/dist/beta.d.ts +9 -1
  4. package/dist/beta.js +6 -1
  5. package/dist/cli/commands/generate-types.js +12 -3
  6. package/dist/cli/commands/generate-types.js.map +1 -1
  7. package/dist/database/contract/index.js +3 -0
  8. package/dist/database/contract/registry.d.ts +26 -0
  9. package/dist/database/contract/registry.d.ts.map +1 -0
  10. package/dist/database/contract/wire.d.ts +8 -0
  11. package/dist/database/contract/wire.d.ts.map +1 -0
  12. package/dist/database/contract/wire.js +37 -0
  13. package/dist/database/contract/wire.js.map +1 -0
  14. package/dist/database/errors.js +71 -0
  15. package/dist/database/errors.js.map +1 -0
  16. package/dist/database/runtime/data-path.js +39 -0
  17. package/dist/database/runtime/data-path.js.map +1 -0
  18. package/dist/database/runtime/engine/drizzle-data-path.js +194 -0
  19. package/dist/database/runtime/engine/drizzle-data-path.js.map +1 -0
  20. package/dist/database/runtime/engine/translate.js +176 -0
  21. package/dist/database/runtime/engine/translate.js.map +1 -0
  22. package/dist/database/schema-builder/columns.d.ts +39 -0
  23. package/dist/database/schema-builder/columns.d.ts.map +1 -0
  24. package/dist/database/schema-builder/columns.js +162 -0
  25. package/dist/database/schema-builder/columns.js.map +1 -0
  26. package/dist/database/schema-builder/define-schema.d.ts +12 -0
  27. package/dist/database/schema-builder/define-schema.d.ts.map +1 -0
  28. package/dist/database/schema-builder/define-schema.js +207 -0
  29. package/dist/database/schema-builder/define-schema.js.map +1 -0
  30. package/dist/database/schema-builder/engine/relations.js +37 -0
  31. package/dist/database/schema-builder/engine/relations.js.map +1 -0
  32. package/dist/database/schema-builder/engine/tables.js +124 -0
  33. package/dist/database/schema-builder/engine/tables.js.map +1 -0
  34. package/dist/database/schema-builder/fk.d.ts +9 -0
  35. package/dist/database/schema-builder/fk.d.ts.map +1 -0
  36. package/dist/database/schema-builder/fk.js +71 -0
  37. package/dist/database/schema-builder/fk.js.map +1 -0
  38. package/dist/database/schema-builder/index.js +6 -0
  39. package/dist/database/schema-builder/relations.js +51 -0
  40. package/dist/database/schema-builder/relations.js.map +1 -0
  41. package/dist/database/schema-builder/types.d.ts +121 -0
  42. package/dist/database/schema-builder/types.d.ts.map +1 -0
  43. package/dist/database/schema-builder/types.js +43 -0
  44. package/dist/database/schema-builder/types.js.map +1 -0
  45. package/dist/database/schema-builder/validators.js +53 -0
  46. package/dist/database/schema-builder/validators.js.map +1 -0
  47. package/dist/index.d.ts +2 -1
  48. package/dist/plugins/beta-exports.generated.d.ts +3 -1
  49. package/dist/plugins/beta-exports.generated.js +2 -0
  50. package/dist/plugins/database/database.d.ts +37 -0
  51. package/dist/plugins/database/database.d.ts.map +1 -0
  52. package/dist/plugins/database/database.js +68 -0
  53. package/dist/plugins/database/database.js.map +1 -0
  54. package/dist/plugins/database/defaults.js +12 -0
  55. package/dist/plugins/database/defaults.js.map +1 -0
  56. package/dist/plugins/database/entity-client.js +148 -0
  57. package/dist/plugins/database/entity-client.js.map +1 -0
  58. package/dist/plugins/database/entity-types.d.ts +76 -0
  59. package/dist/plugins/database/entity-types.d.ts.map +1 -0
  60. package/dist/plugins/database/index.d.ts +3 -0
  61. package/dist/plugins/database/index.js +3 -0
  62. package/dist/plugins/database/lifecycle.js +107 -0
  63. package/dist/plugins/database/lifecycle.js.map +1 -0
  64. package/dist/plugins/database/manifest.js +84 -0
  65. package/dist/plugins/database/manifest.js.map +1 -0
  66. package/dist/plugins/database/types.d.ts +10 -0
  67. package/dist/plugins/database/types.d.ts.map +1 -0
  68. package/dist/type-generator/database/generate.d.ts +15 -0
  69. package/dist/type-generator/database/generate.d.ts.map +1 -0
  70. package/dist/type-generator/database/generate.js +104 -0
  71. package/dist/type-generator/database/generate.js.map +1 -0
  72. package/dist/type-generator/database/index.js +3 -0
  73. package/dist/type-generator/database/walk-schema.js +65 -0
  74. package/dist/type-generator/database/walk-schema.js.map +1 -0
  75. package/dist/type-generator/index.d.ts +148 -0
  76. package/dist/type-generator/index.d.ts.map +1 -0
  77. package/dist/type-generator/index.js +3 -1
  78. package/dist/type-generator/index.js.map +1 -1
  79. package/dist/type-generator/mv-registry/types.d.ts +99 -0
  80. package/dist/type-generator/mv-registry/types.d.ts.map +1 -0
  81. package/dist/type-generator/preflight.d.ts +16 -0
  82. package/dist/type-generator/preflight.d.ts.map +1 -0
  83. package/dist/type-generator/serving/generator.d.ts +20 -0
  84. package/dist/type-generator/serving/generator.d.ts.map +1 -0
  85. package/dist/type-generator/types.d.ts +72 -0
  86. package/dist/type-generator/types.d.ts.map +1 -0
  87. package/dist/type-generator/vite-plugin.d.ts +1 -0
  88. package/dist/type-generator/vite-plugin.d.ts.map +1 -1
  89. package/dist/type-generator/vite-plugin.js +41 -8
  90. package/dist/type-generator/vite-plugin.js.map +1 -1
  91. package/dist/type-generator/warehouse-status.d.ts +1 -0
  92. package/docs/api/appkit/Function.bigid.md +10 -0
  93. package/docs/api/appkit/Function.bigint.md +10 -0
  94. package/docs/api/appkit/Function.boolean.md +10 -0
  95. package/docs/api/appkit/Function.database.md +56 -0
  96. package/docs/api/appkit/Function.defineSchema.md +17 -0
  97. package/docs/api/appkit/Function.enumColumn.md +17 -0
  98. package/docs/api/appkit/Function.fk.md +18 -0
  99. package/docs/api/appkit/Function.id.md +10 -0
  100. package/docs/api/appkit/Function.integer.md +10 -0
  101. package/docs/api/appkit/Function.jsonb.md +10 -0
  102. package/docs/api/appkit/Function.text.md +10 -0
  103. package/docs/api/appkit/Function.timestamp.md +19 -0
  104. package/docs/api/appkit/Function.uuid.md +10 -0
  105. package/docs/api/appkit/Function.varchar.md +16 -0
  106. package/docs/api/appkit/Interface.DatabaseRegistry.md +3 -0
  107. package/docs/api/appkit/Interface.Schema.md +28 -0
  108. package/docs/api/appkit/TypeAlias.DatabaseExports.md +35 -0
  109. package/docs/api/appkit/TypeAlias.IDatabaseConfig.md +25 -0
  110. package/docs/api/appkit.md +18 -0
  111. package/llms.txt +18 -0
  112. package/package.json +4 -3
  113. package/sbom.cdx.json +1 -1
@@ -0,0 +1,25 @@
1
+ # Type Alias: IDatabaseConfig\<TSchema>
2
+
3
+ ```ts
4
+ type IDatabaseConfig<TSchema> = {
5
+ schema: TSchema;
6
+ };
7
+
8
+ ```
9
+
10
+ Configuration for one schema-bound DatabasePlugin instance.
11
+
12
+ ## Type Parameters[​](#type-parameters "Direct link to Type Parameters")
13
+
14
+ | Type Parameter |
15
+ | --------------------------------------------------------------------------- |
16
+ | `TSchema` *extends* [`Schema`](./docs/api/appkit/Interface.Schema.md) |
17
+
18
+ ## Properties[​](#properties "Direct link to Properties")
19
+
20
+ ### schema[​](#schema "Direct link to schema")
21
+
22
+ ```ts
23
+ readonly schema: TSchema;
24
+
25
+ ```
@@ -43,6 +43,7 @@ Documentation merge entry for Typedoc — combines the stable `@databricks/appki
43
43
  | [BasePluginConfig](./docs/api/appkit/Interface.BasePluginConfig.md) | Base configuration interface for AppKit plugins |
44
44
  | [CacheConfig](./docs/api/appkit/Interface.CacheConfig.md) | Configuration for the CacheInterceptor. Controls TTL, size limits, storage backend, and probabilistic cleanup. |
45
45
  | [DatabaseCredential](./docs/api/appkit/Interface.DatabaseCredential.md) | Database credentials with OAuth token for Postgres connection |
46
+ | [DatabaseRegistry](./docs/api/appkit/Interface.DatabaseRegistry.md) | CANONICAL augmentation target. Empty by default; the generated `database.d.ts` augments it via `declare module "@databricks/appkit" { interface DatabaseRegistry { ... } }`. |
46
47
  | [EndpointConfig](./docs/api/appkit/Interface.EndpointConfig.md) | - |
47
48
  | [FilePolicyUser](./docs/api/appkit/Interface.FilePolicyUser.md) | Minimal user identity passed to the policy function. |
48
49
  | [FileResource](./docs/api/appkit/Interface.FileResource.md) | Describes the file or directory being acted upon. |
@@ -73,6 +74,7 @@ Documentation merge entry for Typedoc — combines the stable `@databricks/appki
73
74
  | [ResourceRequirement](./docs/api/appkit/Interface.ResourceRequirement.md) | Declares a resource requirement for a plugin. Can be defined statically in a manifest or dynamically via getResourceRequirements(). |
74
75
  | [RunAgentInput](./docs/api/appkit/Interface.RunAgentInput.md) | - |
75
76
  | [RunAgentResult](./docs/api/appkit/Interface.RunAgentResult.md) | - |
77
+ | [Schema](./docs/api/appkit/Interface.Schema.md) | - |
76
78
  | [SearchRequest](./docs/api/appkit/Interface.SearchRequest.md) | - |
77
79
  | [SearchResponse](./docs/api/appkit/Interface.SearchResponse.md) | - |
78
80
  | [SearchResult](./docs/api/appkit/Interface.SearchResult.md) | - |
@@ -105,11 +107,13 @@ Documentation merge entry for Typedoc — combines the stable `@databricks/appki
105
107
  | [AgentToolsFn](./docs/api/appkit/TypeAlias.AgentToolsFn.md) | Function form of `AgentDefinition.tools`. Receives the typed [Plugins](./docs/api/appkit/TypeAlias.Plugins.md) map and returns a tool record. Invoked exactly once at setup (or once per `runAgent` call in standalone mode); the result is cached as the agent's resolved tool record. |
106
108
  | [BaseSystemPromptOption](./docs/api/appkit/TypeAlias.BaseSystemPromptOption.md) | - |
107
109
  | [ConfigSchema](./docs/api/appkit/TypeAlias.ConfigSchema.md) | Configuration schema definition for plugin config. Re-exported from the standard JSON Schema Draft 7 types. |
110
+ | [DatabaseExports](./docs/api/appkit/TypeAlias.DatabaseExports.md) | Typed database API published by the plugin. |
108
111
  | [ExecutionResult](./docs/api/appkit/TypeAlias.ExecutionResult.md) | Discriminated union for plugin execution results. |
109
112
  | [FileAction](./docs/api/appkit/TypeAlias.FileAction.md) | Every action the files plugin can perform. |
110
113
  | [FilePolicy](./docs/api/appkit/TypeAlias.FilePolicy.md) | A policy function that decides whether `user` may perform `action` on `resource`. Return `true` to allow, `false` to deny. |
111
114
  | [HostedTool](./docs/api/appkit/TypeAlias.HostedTool.md) | - |
112
115
  | [IAppRouter](./docs/api/appkit/TypeAlias.IAppRouter.md) | Express router type for plugin route registration |
116
+ | [IDatabaseConfig](./docs/api/appkit/TypeAlias.IDatabaseConfig.md) | Configuration for one schema-bound DatabasePlugin instance. |
113
117
  | [JobsExport](./docs/api/appkit/TypeAlias.JobsExport.md) | Public API shape of the jobs plugin. Callable to select a job by key. |
114
118
  | [PluginData](./docs/api/appkit/TypeAlias.PluginData.md) | Tuple of plugin class, config, and name. Created by `toPlugin()` and passed to `createApp()`. |
115
119
  | [Plugins](./docs/api/appkit/TypeAlias.Plugins.md) | Plugin map passed to the function form of [AgentDefinition.tools](./docs/api/appkit/Interface.AgentDefinition.md#tools). Each entry exposes a `.toolkit(opts?)` method that returns a record of [ToolkitEntry](./docs/api/appkit/Interface.ToolkitEntry.md) markers ready to be spread into a tool record. |
@@ -141,16 +145,23 @@ Documentation merge entry for Typedoc — combines the stable `@databricks/appki
141
145
  | [agentIdFromMarkdownPath](./docs/api/appkit/Function.agentIdFromMarkdownPath.md) | Derives the logical agent id from a markdown path. When the file is named `agent.md`, the id is the parent directory name (folder-based layout); otherwise the id is the file stem (e.g. legacy single-file paths). |
142
146
  | [appKitServingTypesPlugin](./docs/api/appkit/Function.appKitServingTypesPlugin.md) | Vite plugin to generate TypeScript types for AppKit serving endpoints. Fetches OpenAPI schemas from Databricks and generates a .d.ts with ServingEndpointRegistry module augmentation. |
143
147
  | [appKitTypesPlugin](./docs/api/appkit/Function.appKitTypesPlugin.md) | Vite plugin to generate types for AppKit queries. Calls generateFromEntryPoint under the hood. |
148
+ | [bigid](./docs/api/appkit/Function.bigid.md) | - |
149
+ | [bigint](./docs/api/appkit/Function.bigint.md) | - |
150
+ | [boolean](./docs/api/appkit/Function.boolean.md) | - |
144
151
  | [createAgent](./docs/api/appkit/Function.createAgent.md) | Pure factory for agent definitions: cycle-detects the sub-agent graph and returns the same object, stamped with a non-enumerable AGENT\_BRAND so discovery recognizes it. Safe at module top-level; no adapter is built. Don't `Object.freeze` the definition before passing it in — the brand is written onto the argument. |
145
152
  | [createApp](./docs/api/appkit/Function.createApp.md) | Bootstraps AppKit with the provided configuration. |
146
153
  | [createLakebasePool](./docs/api/appkit/Function.createLakebasePool.md) | Create a Lakebase pool with appkit's logger integration. Telemetry automatically uses appkit's OpenTelemetry configuration via global registry. |
147
154
  | [createLakebasePoolManager](./docs/api/appkit/Function.createLakebasePoolManager.md) | Create a pool manager that maintains per-key Lakebase connection pools. |
148
155
  | [createWorkspaceClient](./docs/api/appkit/Function.createWorkspaceClient.md) | Construct an AppKit workspace client. |
156
+ | [database](./docs/api/appkit/Function.database.md) | Create a typed database plugin registration for a finalized schema. |
149
157
  | [defineManifest](./docs/api/appkit/Function.defineManifest.md) | Validates a raw manifest (typically a `manifest.json` import) against the canonical Zod schema and returns it as a strict [PluginManifest](./docs/api/appkit/Interface.PluginManifest.md). |
158
+ | [defineSchema](./docs/api/appkit/Function.defineSchema.md) | - |
150
159
  | [defineTool](./docs/api/appkit/Function.defineTool.md) | Defines a single tool entry for a plugin's internal registry. |
160
+ | [enumColumn](./docs/api/appkit/Function.enumColumn.md) | - |
151
161
  | [executeFromRegistry](./docs/api/appkit/Function.executeFromRegistry.md) | Validates tool-call arguments against the entry's schema and invokes its handler. On validation failure, returns an LLM-friendly error string (matching the behavior of `tool()`) rather than throwing, so the model can self-correct on its next turn. |
152
162
  | [extractServingEndpoints](./docs/api/appkit/Function.extractServingEndpoints.md) | Extract serving endpoint config from a server file by AST-parsing it. Looks for `serving({ endpoints: { alias: { env: "..." }, ... } })` calls and extracts the endpoint alias names and their environment variable mappings. |
153
163
  | [findServerFile](./docs/api/appkit/Function.findServerFile.md) | Find the server entry file by checking candidate paths in order. |
164
+ | [fk](./docs/api/appkit/Function.fk.md) | Declare foreign-key to another column. |
154
165
  | [fromSupervisorApi](./docs/api/appkit/Function.fromSupervisorApi.md) | Creates an [AgentAdapter](./docs/api/appkit/Interface.AgentAdapter.md) backed by the Databricks AI Gateway Responses API (`/ai-gateway/mlflow/v1/responses`). |
155
166
  | [functionToolToDefinition](./docs/api/appkit/Function.functionToolToDefinition.md) | - |
156
167
  | [generateDatabaseCredential](./docs/api/appkit/Function.generateDatabaseCredential.md) | Generate OAuth credentials for Postgres database connection using the proper Postgres API. |
@@ -161,16 +172,23 @@ Documentation merge entry for Typedoc — combines the stable `@databricks/appki
161
172
  | [getResourceRequirements](./docs/api/appkit/Function.getResourceRequirements.md) | Gets the resource requirements from a plugin's manifest. |
162
173
  | [getUsernameWithApiLookup](./docs/api/appkit/Function.getUsernameWithApiLookup.md) | Resolves the PostgreSQL username for a Lakebase connection. |
163
174
  | [getWorkspaceClient](./docs/api/appkit/Function.getWorkspaceClient.md) | Get workspace client from config or SDK default auth chain |
175
+ | [id](./docs/api/appkit/Function.id.md) | - |
176
+ | [integer](./docs/api/appkit/Function.integer.md) | - |
164
177
  | [isFunctionTool](./docs/api/appkit/Function.isFunctionTool.md) | - |
165
178
  | [isHostedTool](./docs/api/appkit/Function.isHostedTool.md) | - |
166
179
  | [isSQLTypeMarker](./docs/api/appkit/Function.isSQLTypeMarker.md) | Type guard to check if a value is a SQL type marker |
167
180
  | [isSupervisorTool](./docs/api/appkit/Function.isSupervisorTool.md) | Type guard for [HostedSupervisorTool](./docs/api/appkit/Interface.HostedSupervisorTool.md). Used by the agents plugin (`buildToolIndex`) and standalone `runAgent` (`classifyTool`) to route supervisor-hosted tools to the extensions payload rather than the adapter's `tools` array. |
168
181
  | [isToolkitEntry](./docs/api/appkit/Function.isToolkitEntry.md) | Type guard for `ToolkitEntry` — used by the agents plugin to differentiate toolkit references from inline tools in a mixed `tools` record. |
182
+ | [jsonb](./docs/api/appkit/Function.jsonb.md) | - |
169
183
  | [loadAgentFromFile](./docs/api/appkit/Function.loadAgentFromFile.md) | Loads a single markdown agent file and resolves its frontmatter against registered plugin toolkits + ambient tool library. |
170
184
  | [loadAgentsFromDir](./docs/api/appkit/Function.loadAgentsFromDir.md) | Scans a directory for one subdirectory per agent, each containing `agent.md` (frontmatter + body). Produces an `AgentDefinition` record keyed by agent id (folder name). Throws on frontmatter errors or unresolved references. Returns an empty map if the directory does not exist. |
171
185
  | [mcpServer](./docs/api/appkit/Function.mcpServer.md) | Factory for declaring a custom MCP server tool. |
172
186
  | [parseTextToolCalls](./docs/api/appkit/Function.parseTextToolCalls.md) | Parses text-based tool calls from model output. |
173
187
  | [resolveHostedTools](./docs/api/appkit/Function.resolveHostedTools.md) | - |
174
188
  | [runAgent](./docs/api/appkit/Function.runAgent.md) | Standalone agent execution without `createApp`. Resolves the adapter, binds inline tools, and drives the adapter's `run()` loop to completion. |
189
+ | [text](./docs/api/appkit/Function.text.md) | - |
190
+ | [timestamp](./docs/api/appkit/Function.timestamp.md) | - |
175
191
  | [tool](./docs/api/appkit/Function.tool.md) | Factory for defining function tools with Zod schemas. |
176
192
  | [toolsFromRegistry](./docs/api/appkit/Function.toolsFromRegistry.md) | Produces the `AgentToolDefinition[]` a ToolProvider exposes to the LLM, deriving `parameters` JSON Schema from each entry's Zod schema. |
193
+ | [uuid](./docs/api/appkit/Function.uuid.md) | - |
194
+ | [varchar](./docs/api/appkit/Function.varchar.md) | - |
package/llms.txt CHANGED
@@ -83,16 +83,23 @@ npx @databricks/appkit docs <query>
83
83
  - [Function: agentIdFromMarkdownPath()](./docs/api/appkit/Function.agentIdFromMarkdownPath.md): Derives the logical agent id from a markdown path. When the file is named
84
84
  - [Function: appKitServingTypesPlugin()](./docs/api/appkit/Function.appKitServingTypesPlugin.md): Vite plugin to generate TypeScript types for AppKit serving endpoints.
85
85
  - [Function: appKitTypesPlugin()](./docs/api/appkit/Function.appKitTypesPlugin.md): Vite plugin to generate types for AppKit queries.
86
+ - [Function: bigid()](./docs/api/appkit/Function.bigid.md): Returns
87
+ - [Function: bigint()](./docs/api/appkit/Function.bigint.md): Returns
88
+ - [Function: boolean()](./docs/api/appkit/Function.boolean.md): Returns
86
89
  - [Function: createAgent()](./docs/api/appkit/Function.createAgent.md): Pure factory for agent definitions: cycle-detects the sub-agent graph and
87
90
  - [Function: createApp()](./docs/api/appkit/Function.createApp.md): Bootstraps AppKit with the provided configuration.
88
91
  - [Function: createLakebasePool()](./docs/api/appkit/Function.createLakebasePool.md): Create a Lakebase pool with appkit's logger integration.
89
92
  - [Function: createLakebasePoolManager()](./docs/api/appkit/Function.createLakebasePoolManager.md): Create a pool manager that maintains per-key Lakebase connection pools.
90
93
  - [Function: createWorkspaceClient()](./docs/api/appkit/Function.createWorkspaceClient.md): Construct an AppKit workspace client.
94
+ - [Function: database()](./docs/api/appkit/Function.database.md): Create a typed database plugin registration for a finalized schema.
91
95
  - [Function: defineManifest()](./docs/api/appkit/Function.defineManifest.md): Validates a raw manifest (typically a manifest.json import) against the
96
+ - [Function: defineSchema()](./docs/api/appkit/Function.defineSchema.md): Parameters
92
97
  - [Function: defineTool()](./docs/api/appkit/Function.defineTool.md): Defines a single tool entry for a plugin's internal registry.
98
+ - [Function: enumColumn()](./docs/api/appkit/Function.enumColumn.md): Parameters
93
99
  - [Function: executeFromRegistry()](./docs/api/appkit/Function.executeFromRegistry.md): Validates tool-call arguments against the entry's schema and invokes its
94
100
  - [Function: extractServingEndpoints()](./docs/api/appkit/Function.extractServingEndpoints.md): Extract serving endpoint config from a server file by AST-parsing it.
95
101
  - [Function: findServerFile()](./docs/api/appkit/Function.findServerFile.md): Find the server entry file by checking candidate paths in order.
102
+ - [Function: fk()](./docs/api/appkit/Function.fk.md): Declare foreign-key to another column.
96
103
  - [Function: fromSupervisorApi()](./docs/api/appkit/Function.fromSupervisorApi.md): Creates an AgentAdapter backed by the Databricks AI Gateway
97
104
  - [Function: functionToolToDefinition()](./docs/api/appkit/Function.functionToolToDefinition.md): Parameters
98
105
  - [Function: generateDatabaseCredential()](./docs/api/appkit/Function.generateDatabaseCredential.md): Generate OAuth credentials for Postgres database connection using the proper Postgres API.
@@ -103,19 +110,26 @@ npx @databricks/appkit docs <query>
103
110
  - [Function: getResourceRequirements()](./docs/api/appkit/Function.getResourceRequirements.md): Gets the resource requirements from a plugin's manifest.
104
111
  - [Function: getUsernameWithApiLookup()](./docs/api/appkit/Function.getUsernameWithApiLookup.md): Resolves the PostgreSQL username for a Lakebase connection.
105
112
  - [Function: getWorkspaceClient()](./docs/api/appkit/Function.getWorkspaceClient.md): Get workspace client from config or SDK default auth chain
113
+ - [Function: id()](./docs/api/appkit/Function.id.md): Returns
114
+ - [Function: integer()](./docs/api/appkit/Function.integer.md): Returns
106
115
  - [Function: isFunctionTool()](./docs/api/appkit/Function.isFunctionTool.md): Parameters
107
116
  - [Function: isHostedTool()](./docs/api/appkit/Function.isHostedTool.md): Parameters
108
117
  - [Function: isSQLTypeMarker()](./docs/api/appkit/Function.isSQLTypeMarker.md): Type guard to check if a value is a SQL type marker
109
118
  - [Function: isSupervisorTool()](./docs/api/appkit/Function.isSupervisorTool.md): Type guard for HostedSupervisorTool. Used by the agents plugin
110
119
  - [Function: isToolkitEntry()](./docs/api/appkit/Function.isToolkitEntry.md): Type guard for ToolkitEntry — used by the agents plugin to differentiate
120
+ - [Function: jsonb()](./docs/api/appkit/Function.jsonb.md): Returns
111
121
  - [Function: loadAgentFromFile()](./docs/api/appkit/Function.loadAgentFromFile.md): Loads a single markdown agent file and resolves its frontmatter against
112
122
  - [Function: loadAgentsFromDir()](./docs/api/appkit/Function.loadAgentsFromDir.md): Scans a directory for one subdirectory per agent, each containing
113
123
  - [Function: mcpServer()](./docs/api/appkit/Function.mcpServer.md): Factory for declaring a custom MCP server tool.
114
124
  - [Function: parseTextToolCalls()](./docs/api/appkit/Function.parseTextToolCalls.md): Parses text-based tool calls from model output.
115
125
  - [Function: resolveHostedTools()](./docs/api/appkit/Function.resolveHostedTools.md): Parameters
116
126
  - [Function: runAgent()](./docs/api/appkit/Function.runAgent.md): Standalone agent execution without createApp. Resolves the adapter, binds
127
+ - [Function: text()](./docs/api/appkit/Function.text.md): Returns
128
+ - [Function: timestamp()](./docs/api/appkit/Function.timestamp.md): Parameters
117
129
  - [Function: tool()](./docs/api/appkit/Function.tool.md): Factory for defining function tools with Zod schemas.
118
130
  - [Function: toolsFromRegistry()](./docs/api/appkit/Function.toolsFromRegistry.md): Produces the AgentToolDefinition[] a ToolProvider exposes to the LLM,
131
+ - [Function: uuid()](./docs/api/appkit/Function.uuid.md): Returns
132
+ - [Function: varchar()](./docs/api/appkit/Function.varchar.md): Parameters
119
133
  - [Interface: AgentAdapter](./docs/api/appkit/Interface.AgentAdapter.md): Properties
120
134
  - [Interface: AgentDefinition](./docs/api/appkit/Interface.AgentDefinition.md): Properties
121
135
  - [Interface: AgentInput](./docs/api/appkit/Interface.AgentInput.md): Properties
@@ -126,6 +140,7 @@ npx @databricks/appkit docs <query>
126
140
  - [Interface: BasePluginConfig](./docs/api/appkit/Interface.BasePluginConfig.md): Base configuration interface for AppKit plugins
127
141
  - [Interface: CacheConfig](./docs/api/appkit/Interface.CacheConfig.md): Configuration for the CacheInterceptor. Controls TTL, size limits, storage backend, and probabilistic cleanup.
128
142
  - [Interface: DatabaseCredential](./docs/api/appkit/Interface.DatabaseCredential.md): Database credentials with OAuth token for Postgres connection
143
+ - [Interface: DatabaseRegistry](./docs/api/appkit/Interface.DatabaseRegistry.md): CANONICAL augmentation target. Empty by default; the generated database.d.ts
129
144
  - [Interface: EndpointConfig](./docs/api/appkit/Interface.EndpointConfig.md): Properties
130
145
  - [Interface: FilePolicyUser](./docs/api/appkit/Interface.FilePolicyUser.md): Minimal user identity passed to the policy function.
131
146
  - [Interface: FileResource](./docs/api/appkit/Interface.FileResource.md): Describes the file or directory being acted upon.
@@ -156,6 +171,7 @@ npx @databricks/appkit docs <query>
156
171
  - [Interface: ResourceRequirement](./docs/api/appkit/Interface.ResourceRequirement.md): Declares a resource requirement for a plugin.
157
172
  - [Interface: RunAgentInput](./docs/api/appkit/Interface.RunAgentInput.md): Properties
158
173
  - [Interface: RunAgentResult](./docs/api/appkit/Interface.RunAgentResult.md): Properties
174
+ - [Interface: Schema](./docs/api/appkit/Interface.Schema.md): Properties
159
175
  - [Interface: SearchRequest](./docs/api/appkit/Interface.SearchRequest.md): Properties
160
176
  - [Interface: SearchResponse<T>](./docs/api/appkit/Interface.SearchResponse.md): Type Parameters
161
177
  - [Interface: SearchResult<T>](./docs/api/appkit/Interface.SearchResult.md): Type Parameters
@@ -183,11 +199,13 @@ npx @databricks/appkit docs <query>
183
199
  - [Type Alias: AgentToolsFn()](./docs/api/appkit/TypeAlias.AgentToolsFn.md): Function form of AgentDefinition.tools. Receives the typed
184
200
  - [Type Alias: BaseSystemPromptOption](./docs/api/appkit/TypeAlias.BaseSystemPromptOption.md)
185
201
  - [Type Alias: ConfigSchema](./docs/api/appkit/TypeAlias.ConfigSchema.md): Configuration schema definition for plugin config.
202
+ - [Type Alias: DatabaseExports](./docs/api/appkit/TypeAlias.DatabaseExports.md): Typed database API published by the plugin.
186
203
  - [Type Alias: ExecutionResult<T>](./docs/api/appkit/TypeAlias.ExecutionResult.md): Discriminated union for plugin execution results.
187
204
  - [Type Alias: FileAction](./docs/api/appkit/TypeAlias.FileAction.md): Every action the files plugin can perform.
188
205
  - [Type Alias: FilePolicy()](./docs/api/appkit/TypeAlias.FilePolicy.md): A policy function that decides whether user may perform action on
189
206
  - [Type Alias: HostedTool](./docs/api/appkit/TypeAlias.HostedTool.md)
190
207
  - [Type Alias: IAppRouter](./docs/api/appkit/TypeAlias.IAppRouter.md): Express router type for plugin route registration
208
+ - [Type Alias: IDatabaseConfig<TSchema>](./docs/api/appkit/TypeAlias.IDatabaseConfig.md): Configuration for one schema-bound DatabasePlugin instance.
191
209
  - [Type Alias: JobsExport()](./docs/api/appkit/TypeAlias.JobsExport.md): Public API shape of the jobs plugin.
192
210
  - [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().
193
211
  - [Type Alias: Plugins](./docs/api/appkit/TypeAlias.Plugins.md): Plugin map passed to the function form of AgentDefinition.tools.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@databricks/appkit",
3
3
  "type": "module",
4
- "version": "0.65.0",
4
+ "version": "0.66.0",
5
5
  "main": "./dist/index.js",
6
6
  "types": "./dist/index.d.ts",
7
7
  "bin": {
@@ -75,10 +75,11 @@
75
75
  "@types/semver": "7.7.1",
76
76
  "apache-arrow": "21.1.0",
77
77
  "dotenv": "16.6.1",
78
- "drizzle-orm": "0.45.1",
78
+ "drizzle-orm": "0.45.2",
79
79
  "express": "4.22.2",
80
80
  "get-port": "7.2.0",
81
- "js-yaml": "4.2.0",
81
+ "jiti": "2.6.1",
82
+ "js-yaml": "4.3.1",
82
83
  "magic-string": "0.30.21",
83
84
  "mlflow-tracing": "0.1.3",
84
85
  "obug": "2.1.1",