@askdb/client 0.1.0-beta.1 → 1.0.0-beta.10

package/README.md

@@ -1,13 +1,11 @@
 # @askdb/client
 
-Config-aware AskDB facade. Resolves schema, model, and dialect from your runtime config so callers only pass a question.
+Config-aware AskDB facade. Resolves schema, model, dialect, and mode from your runtime config so callers only pass a question.
 
 ## Quick start
 
 ```ts
 import { bootstrapAskDbEnv, getAskDbRuntimeConfig } from "@askdb/config";
-import { createAiRegistry } from "@askdb/ai";
-import { openaiProvider } from "@askdb/ai-openai";
 import { createAskDb } from "@askdb/client";
 
 // bootstrapAskDbEnv() reads .env and askdb.config.* into an in-memory snapshot.
@@ -15,22 +13,28 @@ import { createAskDb } from "@askdb/client";
 // Both calls are needed: bootstrap populates the store; getAskDbRuntimeConfig reads it.
 bootstrapAskDbEnv();
 const askdb = createAskDb({
-  config: getAskDbRuntimeConfig(),
-  registry: createAiRegistry([openaiProvider]),
+  config: getAskDbRuntimeConfig(), // ai.provider in askdb.config.* picks the model
 });
 
 const { sql } = await askdb.ask("top 10 customers by revenue");
 ```
 
+Install the AI SDK package for whichever `ai.provider` your config selects — e.g. `npm i @askdb/client @askdb/core @askdb/config ai @ai-sdk/openai` (`@askdb/core` and `ai`, AI SDK 7, are required peers of the client; npm adds them for you, Yarn doesn't). With no `providers`/`registry` option, the client registers every provider built into `@askdb/ai` (OpenAI, Azure/Foundry, Google, Anthropic, Vercel AI Gateway); each loads its `@ai-sdk/*` package only when first used, and a missing one fails with an `npm i @ai-sdk/<provider>` hint.
+
+Options: `providers: ["openai"]` restricts the set to named built-ins, and `AiProviderAdapter` objects add custom providers (`providers: ["openai", myAdapter]`). Advanced alternative: build a registry yourself with `createAiRegistry` from `@askdb/ai` and pass it as `registry` (e.g. to share one registry across several clients). Pass at most one of `providers` or `registry`.
+
+To bypass config-driven model selection entirely, pass an AI SDK `LanguageModel` per call (`askdb.ask(q, { model })`) or call `ask()` from `@askdb/core` directly.
+
 ## Per-call overrides
 
-All three resolution axes accept optional per-call overrides:
+Each resolution axis accepts an optional per-call override:
 
 | Override | Type | Default |
 |---|---|---|
 | `schema` | `{ path }` \| `{ json }` \| `{ schema }` \| `NormalizedSchema` | From `createAskDb({ schema })` → config `host.schemaPath`/`host.schemaJson` → env |
 | `model` | `AskDbLanguageModel` | From registry via config `ai.aiEnv` |
 | `dialect` | `AskDialectInput` | Config `dialect` → schema `provider` → `"postgres"` |
+| `mode` | `AskDbModeV1` | Config `modes.askdbMode` → `"schema_only"`. A per-call mode can only tighten it: `"bounded_results"` runs the config mode (ADR 0025). |
 
 ```ts
 const { sql } = await askdb.ask("count active users", {
@@ -39,6 +43,26 @@ const { sql } = await askdb.ask("count active users", {
 });
 ```
 
+## Parameterized output
+
+`askdb.ask()` returns the same `AskPipelineResult` as `@askdb/core`'s `ask()`, including optional `unboundSql`, `params`, `parameters`, and `preparedQuery` when the model complies (default `parameterize: true`). The facade forwards options and returns the core result verbatim, `verdict` included.
+
+```ts
+const result = await askdb.ask("How many cities does Colorado have?", { tenantScope });
+
+// Tenant IDs are driver parameters by default (tenantSqlMode: "sql-params").
+await pool.query(result.sql, result.tenantParams);
+await pool.query(result.unboundSql!, result.params);
+
+// A new value, no model call.
+const rebound = await askdb.bind(result.preparedQuery!, { state_name: "Utah" }, { tenantScope });
+await pool.query(rebound.sql, rebound.tenantParams ?? []);
+```
+
+Every `ask()` is still one model call. Set `{ parameterize: false }` to opt out of the extra output tokens. Each SQL form runs with its own array: `sql` with `tenantParams`, `unboundSql` with `params` (which already holds the tenant IDs); never concatenate them. Set `tenantSqlMode: "sql-only"` to get the tenant IDs inlined in `sql` instead.
+
+`askdb.bind(prepared, values, options?)` wraps `@askdb/core`'s `bindPreparedQuery()`: it checks the stored template under the client's schema (or `options.schema`), the `tenantScope` you pass and the modes (`sensitiveGuardrailMode`, `acceptWarnings`), under the `dialect` you pass when `ask()` ran with your own `DialectSpec`, expands a `subtree` scope with `options.resolveTenantDescendants`, and renders the tenant IDs from the scope. Authorizing that scope remains the host's job, as for `ask()`.
+
 ## Multi-tenant usage
 
 The schema and model caches are **per-client-instance**. For multi-tenant servers where each tenant has a different schema, either:
@@ -47,7 +71,7 @@ The schema and model caches are **per-client-instance**. For multi-tenant server
 
 ## `reload()`
 
-Drops the cached schema and model so the next `ask()` re-resolves them from config:
+Drops the cached schema, model and AI config, so the next call resolves them again from the config snapshot the client was created with. To pick up a changed `askdb.config.*`, create a new client.
 
 ```ts
 askdb.reload();
@@ -60,7 +84,6 @@ Inspect how schema, model, and dialect resolved on each call — useful for logg
 ```ts
 const askdb = createAskDb({
   config,
-  registry,
   onResolve: ({ dialect, modelSource }) => {
     console.log(`dialect=${dialect.dialect} (${dialect.source}), model=${modelSource}`);
   },

package/dist/client.d.ts

@@ -1,7 +1,6 @@
-import type { AiRegistry } from "@askdb/ai";
+import { type AiProviderAdapters, type AiRegistry, type ReasoningEffort } from "@askdb/ai";
 import type { AskDbRuntimeConfig } from "@askdb/config";
-import { type AnyNormalizedSchema, type AskDbLanguageModel, type AskDialectInput, type AskPipelineOptions, type AskPipelineResult } from "@askdb/core";
-import type { BuiltInDialectId } from "@askdb/core";
+import { type AnyNormalizedSchema, type AskDbLanguageModel, type AskDbModeV1, type AskDialectInput, type AskPipelineOptions, type AskPipelineResult, type BindGuardrails, type BuiltInDialectId, type BoundQuery, type PreparedQuery, type QueryParameterValue, type ResolveTenantDescendants } from "@askdb/core";
 /** Where a schema comes from. A pre-loaded object short-circuits loading. */
 export type SchemaSource = {
     path: string;
@@ -10,11 +9,32 @@ export type SchemaSource = {
 } | {
     schema: AnyNormalizedSchema;
 };
-/** Per-call options. Everything is optional; anything set overrides the client default. */
-export type AskOverrides = Omit<AskPipelineOptions, "question" | "schema" | "model" | "dialect"> & {
+/**
+ * Per-call options. Everything is optional; anything set overrides the client default,
+ * except the two config `modes` settings, which a call can only tighten.
+ */
+export type AskOverrides = Omit<AskPipelineOptions, "question" | "schema" | "model" | "dialect" | "mode"> & {
+    /**
+     * Trust boundary for this call. Config `modes.askdbMode` (unset: `"schema_only"`) is the
+     * loosest mode a call gets: `"schema_only"` tightens it, `"bounded_results"` can't loosen it.
+     */
+    mode?: AskDbModeV1;
     schema?: SchemaSource | AnyNormalizedSchema;
     model?: AskDbLanguageModel;
     dialect?: AskDialectInput;
+    /**
+     * Provider-portable reasoning/latency effort for this call, overriding the
+     * client default and `askdb.config.ts`'s `ai.reasoning.nlToSql`/`effort`.
+     * Ignored when `model` or `deps.generateText` is also set (BYO paths).
+     */
+    reasoningEffort?: ReasoningEffort;
+};
+/** Options for {@link AskDbClient.bind}. Everything is optional; `schema` overrides the client's schema. */
+export type BindOptions = Omit<BindGuardrails, "schema"> & {
+    /** The schema to check the template under. Defaults to the schema `ask()` resolves. */
+    schema?: SchemaSource | AnyNormalizedSchema;
+    /** Expands a `subtree` `tenantScope` before binding, as in `ask()`. */
+    resolveTenantDescendants?: ResolveTenantDescendants;
 };
 export type DialectResolution = {
     dialect: AskDialectInput;
@@ -25,8 +45,22 @@ export type DialectResolution = {
 export type CreateAskDbOptions = {
     /** Runtime snapshot, e.g. from `getAskDbRuntimeConfig()`. */
     config: AskDbRuntimeConfig;
-    /** AI registry built from host-registered adapters via `createAiRegistry(...)`. */
-    registry: AiRegistry;
+    /**
+     * Which AI providers the client can build models for. Optional: when neither
+     * `providers` nor `registry` is passed, every provider built into `@askdb/ai`
+     * is registered and `ai.provider` in your config picks one — install the
+     * matching SDK (e.g. `@ai-sdk/openai`), which is loaded on first use.
+     *
+     * Pass built-in names to restrict the set (`providers: ["openai"]`), or
+     * `AiProviderAdapter` objects for custom providers (mixable with names).
+     * Pass at most one of `providers` or `registry`.
+     */
+    providers?: AiProviderAdapters;
+    /**
+     * Prebuilt AI registry from `createAiRegistry(...)` — advanced alternative
+     * to `providers`, e.g. to share one registry across several clients.
+     */
+    registry?: AiRegistry;
     /** Default schema source. Falls back to config `host.schemaJson`/`host.schemaPath`/env. */
     schema?: SchemaSource;
     /** Default dialect override. Falls back to config.dialect → schema.provider → "postgres". */
@@ -41,9 +75,23 @@ export type CreateAskDbOptions = {
         dialect: DialectResolution;
         modelSource: "override" | "registry" | "mock";
     }) => void;
+    /**
+     * Client-level default reasoning/latency effort for NL→SQL generation
+     * (`ask()`). When set, takes precedence over `askdb.config.ts`'s
+     * `ai.reasoning.nlToSql`/`effort` env resolution; overridden per-call by
+     * `AskOverrides.reasoningEffort`.
+     */
+    reasoningEffort?: ReasoningEffort;
 };
 export type AskDbClient = {
     ask(question: string, overrides?: AskOverrides): Promise<AskPipelineResult>;
+    /**
+     * Rebind a stored `preparedQuery` with new values, without calling the model. Checks the
+     * template under the client's schema (the one `ask()` resolves, unless `options.schema`
+     * is set), the given tenant scope and modes, expands a `subtree` scope with
+     * `options.resolveTenantDescendants`, and forwards to `@askdb/core`'s `bindPreparedQuery()`.
+     */
+    bind(prepared: PreparedQuery, values: Record<string, QueryParameterValue | readonly QueryParameterValue[]>, options?: BindOptions): Promise<BoundQuery>;
     /** Drop cached schema + model so the next ask() re-resolves them. */
     reload(): void;
 };

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAML,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EAEpB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAQpD,6EAA6E;AAC7E,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,MAAM,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAEpC,2FAA2F;AAC3F,MAAM,MAAM,YAAY,GAAG,IAAI,CAC7B,kBAAkB,EAClB,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAC5C,GAAG;IACF,MAAM,CAAC,EAAE,YAAY,GAAG,mBAAmB,CAAC;IAC5C,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACrD,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,6DAA6D;IAC7D,MAAM,EAAE,kBAAkB,CAAC;IAC3B,mFAAmF;IACnF,QAAQ,EAAE,UAAU,CAAC;IACrB,2FAA2F;IAC3F,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,6FAA6F;IAC7F,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,mBAAmB,CAAC;IAC/C,gGAAgG;IAChG,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,iBAAiB,CAAC;QAAC,WAAW,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC3G,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC5E,qEAAqE;IACrE,MAAM,IAAI,IAAI,CAAC;CAChB,CAAC;AAEF,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAyIpE"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -1,12 +1,23 @@
-import { ask, isBuiltInDialectId, loadSchema, loadSchemaFromJson, SUPPORTED_DIALECT_IDS, } from "@askdb/core";
+import { createAiRegistry, resolveReasoningEffort, } from "@askdb/ai";
+import { ask, bindPreparedQuery, expandTenantScope, isBuiltInDialectId, loadSchema, loadSchemaFromJson, parseAskDbModeV1, SUPPORTED_DIALECT_IDS, } from "@askdb/core";
 import { DialectNotSupportedError, ModelNotConfiguredError, SchemaLoadError, SchemaNotConfiguredError, } from "./errors.js";
+function resolveRegistry(options) {
+    if (options.registry && options.providers) {
+        throw new Error("createAskDb: pass either `providers` or `registry`, not both.");
+    }
+    if (options.registry)
+        return options.registry;
+    // No providers/registry: register every built-in provider (each loads its
+    // @ai-sdk/* package lazily), so `createAskDb({ config })` is enough.
+    return createAiRegistry(options.providers);
+}
 export function createAskDb(options) {
-    const { config, registry } = options;
+    const { config } = options;
+    const registry = resolveRegistry(options);
     let cachedSchema;
     let cachedModel;
+    let cachedAiConfig;
     function schemaSourceLabel(src) {
-        if ("schemaId" in src)
-            return "schema";
         if ("schema" in src)
             return "schema";
         if ("json" in src)
@@ -14,7 +25,8 @@ export function createAskDb(options) {
         return `path (${src.path})`;
     }
     function loadFromSource(src, label) {
-        if ("schemaId" in src)
+        // A normalized schema, v1 or v2, passed as is: every one has `tables`, no SchemaSource does.
+        if ("tables" in src)
             return src;
         if ("schema" in src)
             return src.schema;
@@ -36,12 +48,12 @@ export function createAskDb(options) {
         }
         const host = config.structured.host;
         const env = config.ai.aiEnv;
-        const json = (host?.schemaJson?.trim() || env["ASKDB_SCHEMA_JSON"]?.trim()) || undefined;
+        const json = host?.schemaJson?.trim() || env["ASKDB_SCHEMA_JSON"]?.trim();
         if (json) {
             cachedSchema = loadFromSource({ json }, host?.schemaJson?.trim() ? "host.schemaJson" : "ASKDB_SCHEMA_JSON");
             return cachedSchema;
         }
-        const path = (host?.schemaPath?.trim() || env["ASKDB_SCHEMA_PATH"]?.trim()) || undefined;
+        const path = host?.schemaPath?.trim() || env["ASKDB_SCHEMA_PATH"]?.trim();
         if (path) {
             cachedSchema = loadFromSource({ path }, host?.schemaPath?.trim() ? `host.schemaPath (${path})` : `ASKDB_SCHEMA_PATH (${path})`);
             return cachedSchema;
@@ -49,9 +61,7 @@ export function createAskDb(options) {
         throw new SchemaNotConfiguredError("No schema configured. Pass `schema` to createAskDb() or per-call, or set host.schemaPath / host.schemaJson in askdb.config.*.");
     }
     function schemaProviderOf(schema) {
-        return "provider" in schema && typeof schema["provider"] === "string"
-            ? schema["provider"]
-            : undefined;
+        return "provider" in schema && typeof schema.provider === "string" ? schema.provider : undefined;
     }
     function resolveDialect(schema, override) {
         if (override)
@@ -85,46 +95,83 @@ export function createAskDb(options) {
         }
         return { dialect: "postgres", source: "default" };
     }
-    async function resolveModel(override, deps) {
+    async function resolveModel(override, deps, reasoningEffortOverride) {
         if (override)
             return { model: override, source: "override" };
         if (deps?.generateText) {
-            return { model: undefined, deps, source: "mock" };
+            return { model: undefined, source: "mock", mockDeps: deps };
         }
         const mockSql = config.dev.mockSql;
         if (mockSql !== undefined) {
             return {
                 model: undefined,
-                deps: { generateText: (async () => ({ text: mockSql })) },
                 source: "mock",
+                mockDeps: { generateText: (async () => ({ text: mockSql })) },
             };
         }
-        if (cachedModel)
-            return { model: cachedModel, source: "registry" };
-        const model = await registry.createLanguageModelFromEnv(config.ai.aiEnv);
-        if (!model)
-            throw new ModelNotConfiguredError(registry.keyMissingMessage("NL→SQL generation"));
-        cachedModel = model;
-        return { model: cachedModel, source: "registry" };
+        if (!cachedAiConfig) {
+            cachedAiConfig = registry.resolveAiConfig(config.ai.aiEnv);
+            if (!cachedAiConfig)
+                throw new ModelNotConfiguredError(registry.keyMissingMessage("NL→SQL generation"));
+        }
+        if (!cachedModel) {
+            cachedModel = await registry.createLanguageModel(cachedAiConfig);
+        }
+        const reasoningEffort = resolveReasoningEffort(config.ai.aiEnv, "nlToSql", reasoningEffortOverride ?? options.reasoningEffort);
+        const providerOptions = reasoningEffort
+            ? registry.resolveProviderOptions(cachedAiConfig, { reasoningEffort })
+            : undefined;
+        return { model: cachedModel, source: "registry", providerOptions };
     }
     return {
         reload() {
             cachedSchema = undefined;
             cachedModel = undefined;
+            cachedAiConfig = undefined;
+        },
+        async bind(prepared, values, options = {}) {
+            const { schema: schemaOverride, resolveTenantDescendants, tenantScope, ...guardrails } = options;
+            const schema = schemaOverride ? loadFromSource(schemaOverride, "request") : resolveDefaultSchema();
+            const tenantPolicy = "schemaId" in schema ? schema.tenantPolicy : undefined;
+            // The same subtree expansion ask() runs, so a host never builds it by hand (ADR 0014).
+            const scope = tenantPolicy && tenantScope
+                ? await expandTenantScope(tenantPolicy, tenantScope, resolveTenantDescendants)
+                : tenantScope;
+            return bindPreparedQuery(prepared, values, { ...guardrails, schema, ...(scope ? { tenantScope: scope } : {}) });
         },
         async ask(question, overrides = {}) {
-            const { schema: schemaOverride, model: modelOverride, dialect: dialectOverride, deps, ...rest } = overrides;
+            const { schema: schemaOverride, model: modelOverride, dialect: dialectOverride, deps, reasoningEffort, omitSensitiveIdentifiersFromNlToSqlPrompt, mode: callMode, ...rest } = overrides;
             const schema = schemaOverride ? loadFromSource(schemaOverride, "request") : resolveDefaultSchema();
             const dialect = resolveDialect(schema, dialectOverride);
-            const resolvedModel = await resolveModel(modelOverride, deps);
+            const resolvedModel = await resolveModel(modelOverride, deps, reasoningEffort);
             options.onResolve?.({ dialect, modelSource: resolvedModel.source });
+            // An explicit `deps.providerOptions` from the caller always wins over
+            // the computed one; otherwise merge the resolved reasoning effort in.
+            const finalDeps = resolvedModel.mockDeps ??
+                (deps?.providerOptions !== undefined
+                    ? deps
+                    : resolvedModel.providerOptions !== undefined
+                        ? { ...deps, providerOptions: resolvedModel.providerOptions }
+                        : deps);
+            // Config `modes.omitSensitiveFromPrompt` is a floor: a per-call override can
+            // tighten it (true) but never loosen it (false) when the operator enabled it.
+            const omitSensitive = omitSensitiveIdentifiersFromNlToSqlPrompt === true ||
+                config.modes?.omitSensitiveFromPrompt === true;
+            // Config `modes.askdbMode` (unset: `schema_only`) is the loosest mode a call gets:
+            // a per-call `mode` can tighten it to `schema_only`, never loosen it (ADR 0025). Both go
+            // through the same parser, so any accepted spelling tightens and an unknown mode throws.
+            const configMode = parseAskDbModeV1(config.modes?.askdbMode);
+            const requested = callMode == null ? undefined : parseAskDbModeV1(callMode);
+            const mode = requested === "schema_only" ? requested : configMode;
             return ask({
                 ...rest,
+                mode,
+                ...(omitSensitive ? { omitSensitiveIdentifiersFromNlToSqlPrompt: true } : {}),
                 question,
                 schema,
                 model: resolvedModel.model,
                 dialect: dialect.dialect,
-                ...(resolvedModel.deps ? { deps: resolvedModel.deps } : deps ? { deps } : {}),
+                ...(finalDeps ? { deps: finalDeps } : {}),
             });
         },
     };

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { createAskDb, type AskDbClient, type CreateAskDbOptions, type AskOverrides, type SchemaSource, type DialectResolution, } from "./client.js";
+export { createAskDb, type AskDbClient, type CreateAskDbOptions, type AskOverrides, type BindOptions, type SchemaSource, type DialectResolution, } from "./client.js";
 export { DialectNotSupportedError, ModelNotConfiguredError, SchemaLoadError, SchemaNotConfiguredError, } from "./errors.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,wBAAwB,GACzB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,wBAAwB,GACzB,MAAM,aAAa,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,GAMZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,wBAAwB,GACzB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,GAOZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,wBAAwB,GACzB,MAAM,aAAa,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askdb/client",
-  "version": "0.1.0-beta.1",
+  "version": "1.0.0-beta.10",
   "description": "Config-aware AskDB facade: resolves schema, model, and dialect from config so callers only pass a question.",
   "keywords": [
     "askdb",
@@ -8,7 +8,7 @@
     "facade",
     "client"
   ],
-  "homepage": "https://github.com/Ygilany/AskDB#readme",
+  "homepage": "https://askdb.tools/reference/client-api/",
   "bugs": {
     "url": "https://github.com/Ygilany/AskDB/issues"
   },
@@ -20,12 +20,14 @@
   "license": "Apache-2.0",
   "author": "Yahya Gilany",
   "type": "module",
+  "sideEffects": false,
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     }
   },
   "files": [
@@ -35,21 +37,40 @@
     "NOTICE"
   ],
   "engines": {
-    "node": ">=20"
+    "node": ">=22.23.4"
   },
   "peerDependencies": {
-    "ai": "^6.0.205",
-    "@askdb/config": "^1.0.0-beta.8",
-    "@askdb/ai": "^0.1.0-beta.3",
-    "@askdb/core": "^1.0.0-beta.26"
+    "@ai-sdk/anthropic": "^4.0.0",
+    "@ai-sdk/azure": "^4.0.0",
+    "@ai-sdk/google": "^4.0.0",
+    "@ai-sdk/openai": "^4.0.0",
+    "@askdb/config": "^1.0.0-beta.16",
+    "@askdb/core": "^1.0.0-beta.47",
+    "ai": "^7.0.51"
+  },
+  "peerDependenciesMeta": {
+    "@ai-sdk/anthropic": {
+      "optional": true
+    },
+    "@ai-sdk/azure": {
+      "optional": true
+    },
+    "@ai-sdk/google": {
+      "optional": true
+    },
+    "@ai-sdk/openai": {
+      "optional": true
+    }
   },
   "devDependencies": {
-    "ai": "^6.0.205",
+    "@askdb/config": "1.0.0-beta.16",
+    "@askdb/core": "1.0.0-beta.47",
+    "ai": "^7.0.127",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.8",
-    "@askdb/ai": "0.1.0-beta.3",
-    "@askdb/core": "1.0.0-beta.26",
-    "@askdb/config": "1.0.0-beta.8"
+    "vitest": "^5.0.5"
+  },
+  "dependencies": {
+    "@askdb/ai": "^0.1.0-beta.10"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",