@onyx.dev/onyx-database 1.2.0 → 2.0.0

package/README.md

@@ -94,6 +94,7 @@ Set the following environment variables for your database:
 - `ONYX_DATABASE_API_KEY`
 - `ONYX_DATABASE_API_SECRET`
 - `ONYX_AI_BASE_URL` (optional; defaults to `https://ai.onyx.dev`)
+- `ONYX_DEFAULT_MODEL` (optional; used by `db.chat('...')`, defaults to `onyx`)
 
 ```ts
 import { onyx } from '@onyx.dev/onyx-database';
@@ -110,6 +111,7 @@ import { onyx } from '@onyx.dev/onyx-database';
 const db = onyx.init({
   baseUrl: 'https://api.onyx.dev',
   aiBaseUrl: 'https://ai.onyx.dev', // optional: override AI base path
+  defaultModel: 'onyx', // optional: shorthand `db.chat()` model
   databaseId: 'YOUR_DATABASE_ID',
   apiKey: 'YOUR_KEY',
   apiSecret: 'YOUR_SECRET',
@@ -184,7 +186,7 @@ necessary unless you create many short‑lived clients.
 
 ## Onyx AI (chat & models)
 
-AI endpoints are OpenAI-compatible and use the same credentials as database calls. The AI base URL defaults to `https://ai.onyx.dev` and can be overridden with `aiBaseUrl` (or `ONYX_AI_BASE_URL`). The `databaseId` query param is optional; when omitted, the configured databaseId is used for grounding and billing.
+AI endpoints are OpenAI-compatible and use the same credentials as database calls. Use `db.ai` for chat, models, and script approvals; `db.chat()`/`db.chat('...')` remain supported as equivalent entrypoints. A shorthand `db.chat('content')` call is available and uses `config.defaultModel` (defaults to `onyx`). The AI base URL defaults to `https://ai.onyx.dev` and can be overridden with `aiBaseUrl` (or `ONYX_AI_BASE_URL`). The `databaseId` query param is optional; when omitted, the configured databaseId is used for grounding and billing.
 
 ### Chat completions
 
@@ -195,17 +197,27 @@ import { onyx } from '@onyx.dev/onyx-database';
 
 const db = onyx.init();
 
-const completion = await db.chat().create({
+const quick = await db.chat('Reply with exactly one short greeting sentence.'); // returns first message content
+
+const completion = await db.ai.chat({
   model: 'onyx-chat',
   messages: [{ role: 'user', content: 'Summarize last week’s traffic.' }],
 });
 console.log(completion.choices[0]?.message?.content);
+
+// Override defaults (model/role/temperature/stream) in shorthand form
+const custom = await db.chat('List three colors.', {
+  model: 'onyx-chat',
+  role: 'user',
+  temperature: 0.2,
+  stream: false, // set raw: true to receive full completion response instead of the first message content
+});
 ```
 
 Streaming works as an async iterable:
 
 ```ts
-const stream = await db.chat().create({
+const stream = await db.ai.chat({
   model: 'onyx-chat',
   stream: true,
   messages: [{ role: 'user', content: 'Write a short onboarding checklist.' }],
@@ -242,12 +254,12 @@ const prompt = {
   ],
 };
 
-const first = await db.chat().create(prompt);
+const first = await db.ai.chat(prompt);
 const toolCall = first.choices[0]?.message?.tool_calls?.[0];
 
 if (toolCall) {
   const toolResult = await getRevenue(JSON.parse(toolCall.function.arguments)); // your impl
-  const followup = await db.chat().create({
+  const followup = await db.ai.chat({
     model: prompt.model,
     messages: [
       ...prompt.messages,
@@ -264,14 +276,14 @@ if (toolCall) {
 Example: `examples/ai/models.ts`.
 
 ```ts
-const models = await db.getModels();
-const chatModel = await db.getModel('onyx-chat');
+const models = await db.ai.getModels();
+const chatModel = await db.ai.getModel('onyx-chat');
 ```
 
 ### Script mutation approvals
 
 ```ts
-const approval = await db.requestScriptApproval({
+const approval = await db.ai.requestScriptApproval({
   script: "db.save({ id: 'u1', email: 'a@b.com' })",
 });
 if (approval.requiresApproval) {

package/dist/{aggregates-LoteczVS.d.cts → aggregates-BJT5DGGX.d.cts}

@@ -822,6 +822,10 @@ interface OnyxConfig {
     apiKey?: string;
     apiSecret?: string;
     fetch?: FetchImpl;
+    /**
+     * Default AI model when using shorthand chat calls (`db.chat('...')`). Defaults to `onyx`.
+     */
+    defaultModel?: string;
     /**
      * Default partition for queries, `findById`, and deletes when removing by
      * primary key. Saves rely on the entity's partition field instead.
@@ -934,6 +938,28 @@ interface AiChatCompletionChunk {
 interface AiChatCompletionStream extends AsyncIterable<AiChatCompletionChunk> {
     cancel(): void;
 }
+interface AiChatOptions extends AiRequestOptions {
+    /**
+     * Model to use for the shorthand `db.chat()` call. Defaults to config.defaultModel or `onyx`.
+     */
+    model?: string;
+    /**
+     * Role for the constructed message. Defaults to `user`.
+     */
+    role?: AiChatRole;
+    /**
+     * Temperature for the completion. Omit to use the service default.
+     */
+    temperature?: number | null;
+    /**
+     * Enable SSE streaming. Defaults to `false`.
+     */
+    stream?: boolean;
+    /**
+     * When true, return the raw completion response instead of the first message content.
+     */
+    raw?: boolean;
+}
 interface AiChatClient {
     create(request: AiChatCompletionRequest & {
         stream?: false;
@@ -968,9 +994,90 @@ interface AiErrorResponse {
         [key: string]: unknown;
     } | null;
 }
+interface AiClient {
+    /**
+     * Run a chat completion. Accepts shorthand strings or full requests.
+     *
+     * @example
+     * ```ts
+     * const quick = await db.ai.chat('Summarize last week.'); // returns first message content
+     * const completion = await db.ai.chat(
+     *   { model: 'onyx-chat', messages: [{ role: 'user', content: 'Summarize last week.' }] },
+     *   { databaseId: 'db1', raw: true }, // returns full response
+     * );
+     * ```
+     */
+    chat(content: string, options?: AiChatOptions & {
+        stream?: false;
+        raw?: false | undefined;
+    }): Promise<string>;
+    chat(content: string, options: AiChatOptions & {
+        stream: true;
+    }): Promise<AiChatCompletionStream>;
+    chat(content: string, options: AiChatOptions & {
+        raw: true;
+    }): Promise<AiChatCompletionResponse | AiChatCompletionStream>;
+    chat(request: AiChatCompletionRequest & {
+        stream?: false;
+    }, options?: AiRequestOptions): Promise<AiChatCompletionResponse>;
+    chat(request: AiChatCompletionRequest & {
+        stream: true;
+    }, options?: AiRequestOptions): Promise<AiChatCompletionStream>;
+    chat(request: AiChatCompletionRequest, options?: AiRequestOptions): Promise<AiChatCompletionResponse | AiChatCompletionStream>;
+    /**
+     * Access the chat client for more control over streaming and cancellation.
+     */
+    chatClient(): AiChatClient;
+    /**
+     * List available AI models.
+     *
+     * @example
+     * ```ts
+     * const models = await db.ai.getModels();
+     * ```
+     */
+    getModels(): Promise<AiModelsResponse>;
+    /**
+     * Retrieve a single AI model by ID.
+     *
+     * @example
+     * ```ts
+     * const model = await db.ai.getModel('onyx-chat');
+     * ```
+     */
+    getModel(modelId: string): Promise<AiModel>;
+    /**
+     * Request mutation approval for a script.
+     *
+     * @example
+     * ```ts
+     * const approval = await db.ai.requestScriptApproval({
+     *   script: "db.save({ id: 'u1', email: 'a@b.com' })"
+     * });
+     * ```
+     */
+    requestScriptApproval(input: AiScriptApprovalRequest): Promise<AiScriptApprovalResponse>;
+}
 interface IOnyxDatabase<Schema = Record<string, unknown>> {
     /**
-     * Access OpenAI-compatible chat completions.
+     * AI helpers (chat, models, script approvals) grouped under `db.ai`.
+     *
+     * @example
+     * ```ts
+     * const completion = await db.ai.chat({
+     *   model: 'onyx-chat',
+     *   messages: [{ role: 'user', content: 'Summarize last week.' }],
+     * });
+     * ```
+     */
+    ai: AiClient;
+    /**
+     * Access OpenAI-compatible chat completions via `db.chat('...')` or `db.chat().create(...)`.
+     *
+     * @example
+     * ```ts
+     * const completion = await db.chat('Summarize last week.'); // returns first message content
+     * ```
      *
      * @example
      * ```ts
@@ -995,10 +1102,22 @@ interface IOnyxDatabase<Schema = Record<string, unknown>> {
      * }
      * ```
      */
+    chat(content: string, options?: AiChatOptions & {
+        stream?: false;
+        raw?: false | undefined;
+    }): Promise<string>;
+    chat(content: string, options: AiChatOptions & {
+        stream: true;
+    }): Promise<AiChatCompletionStream>;
+    chat(content: string, options: AiChatOptions & {
+        raw: true;
+    }): Promise<AiChatCompletionResponse | AiChatCompletionStream>;
     chat(): AiChatClient;
     /**
      * List available AI models.
      *
+     * @deprecated Prefer `db.ai.getModels()`.
+     *
      * @example
      * ```ts
      * const models = await db.getModels();
@@ -1008,6 +1127,8 @@ interface IOnyxDatabase<Schema = Record<string, unknown>> {
     /**
      * Retrieve a single AI model by ID.
      *
+     * @deprecated Prefer `db.ai.getModel(...)`.
+     *
      * @example
      * ```ts
      * const model = await db.getModel('onyx-chat');
@@ -1017,6 +1138,8 @@ interface IOnyxDatabase<Schema = Record<string, unknown>> {
     /**
      * Request mutation approval for a script.
      *
+     * @deprecated Prefer `db.ai.requestScriptApproval(...)`.
+     *
      * @example
      * ```ts
      * const approval = await db.requestScriptApproval({
@@ -1634,4 +1757,4 @@ declare const substring: (attribute: string, from: number, length: number) => st
 declare const replace: (attribute: string, pattern: string, repl: string) => string;
 declare const percentile: (attribute: string, p: number) => string;
 
-export { type SchemaDiff as $, type AiRequestOptions as A, type SchemaDataType as B, type SchemaIdentifierGenerator as C, type SchemaIdentifier as D, type SchemaAttribute as E, type FullTextQuery as F, type SchemaIndexType as G, type SchemaIndex as H, type IOnyxDatabase as I, type SchemaResolver as J, type SchemaTriggerEvent as K, type SchemaTrigger as L, type SchemaEntity as M, type SchemaRevisionMetadata as N, type OnyxFacade as O, type SchemaRevision as P, QueryResults as Q, type RetryOptions as R, type SecretMetadata as S, type SchemaHistoryEntry as T, type SchemaUpsertRequest as U, type SchemaValidationResult as V, type SchemaAttributeChange as W, type SchemaIndexChange as X, type SchemaResolverChange as Y, type SchemaTriggerChange as Z, type SchemaTableDiff as _, type QueryResultsPromise as a, type QueryCriteriaOperator as a0, type LogicalOperator as a1, type Sort as a2, type StreamAction as a3, type OnyxDocument as a4, type FetchResponse as a5, type FetchImpl as a6, type QueryCriteria as a7, type QueryCondition as a8, type SelectQuery as a9, containsIgnoreCase as aA, notContains as aB, notContainsIgnoreCase as aC, startsWith as aD, notStartsWith as aE, isNull as aF, notNull as aG, avg as aH, sum as aI, count as aJ, min as aK, max as aL, std as aM, variance as aN, median as aO, upper as aP, lower as aQ, substring as aR, replace as aS, percentile as aT, type UpdateQuery as aa, type QueryPage as ab, type IConditionBuilder as ac, type IQueryBuilder as ad, type ISaveBuilder as ae, type ICascadeBuilder as af, type ICascadeRelationshipBuilder as ag, asc as ah, desc as ai, eq as aj, neq as ak, inOp as al, within as am, notIn as an, notWithin as ao, between as ap, gt as aq, gte as ar, lt as as, lte as at, matches as au, search as av, notMatches as aw, like as ax, notLike as ay, contains as az, type OnyxConfig as b, type AiChatRole as c, type AiToolCallFunction as d, type AiToolCall as e, type AiChatMessage as f, type AiToolFunction as g, type AiTool as h, type AiToolChoice as i, type AiChatCompletionRequest as j, type AiChatCompletionUsage as k, type AiChatCompletionChoice as l, type AiChatCompletionResponse as m, type AiChatCompletionChunkDelta as n, type AiChatCompletionChunkChoice as o, type AiChatCompletionChunk as p, type AiChatCompletionStream as q, type AiChatClient as r, type AiScriptApprovalRequest as s, type AiScriptApprovalResponse as t, type AiModelsResponse as u, type AiModel as v, type AiErrorResponse as w, type SecretRecord as x, type SecretsListResponse as y, type SecretSaveRequest as z };
+export { type SchemaTriggerChange as $, type AiRequestOptions as A, type SecretsListResponse as B, type SecretSaveRequest as C, type SchemaDataType as D, type SchemaIdentifierGenerator as E, type FullTextQuery as F, type SchemaIdentifier as G, type SchemaAttribute as H, type IOnyxDatabase as I, type SchemaIndexType as J, type SchemaIndex as K, type SchemaResolver as L, type SchemaTriggerEvent as M, type SchemaTrigger as N, type OnyxFacade as O, type SchemaEntity as P, QueryResults as Q, type RetryOptions as R, type SecretMetadata as S, type SchemaRevisionMetadata as T, type SchemaRevision as U, type SchemaHistoryEntry as V, type SchemaUpsertRequest as W, type SchemaValidationResult as X, type SchemaAttributeChange as Y, type SchemaIndexChange as Z, type SchemaResolverChange as _, type QueryResultsPromise as a, type SchemaTableDiff as a0, type SchemaDiff as a1, type QueryCriteriaOperator as a2, type LogicalOperator as a3, type Sort as a4, type StreamAction as a5, type OnyxDocument as a6, type FetchResponse as a7, type FetchImpl as a8, type QueryCriteria as a9, notLike as aA, contains as aB, containsIgnoreCase as aC, notContains as aD, notContainsIgnoreCase as aE, startsWith as aF, notStartsWith as aG, isNull as aH, notNull as aI, avg as aJ, sum as aK, count as aL, min as aM, max as aN, std as aO, variance as aP, median as aQ, upper as aR, lower as aS, substring as aT, replace as aU, percentile as aV, type QueryCondition as aa, type SelectQuery as ab, type UpdateQuery as ac, type QueryPage as ad, type IConditionBuilder as ae, type IQueryBuilder as af, type ISaveBuilder as ag, type ICascadeBuilder as ah, type ICascadeRelationshipBuilder as ai, asc as aj, desc as ak, eq as al, neq as am, inOp as an, within as ao, notIn as ap, notWithin as aq, between as ar, gt as as, gte as at, lt as au, lte as av, matches as aw, search as ax, notMatches as ay, like as az, type OnyxConfig as b, type AiChatRole as c, type AiToolCallFunction as d, type AiToolCall as e, type AiChatMessage as f, type AiToolFunction as g, type AiTool as h, type AiToolChoice as i, type AiChatCompletionRequest as j, type AiChatCompletionUsage as k, type AiChatCompletionChoice as l, type AiChatCompletionResponse as m, type AiChatCompletionChunkDelta as n, type AiChatCompletionChunkChoice as o, type AiChatCompletionChunk as p, type AiChatCompletionStream as q, type AiChatOptions as r, type AiChatClient as s, type AiScriptApprovalRequest as t, type AiScriptApprovalResponse as u, type AiModelsResponse as v, type AiModel as w, type AiErrorResponse as x, type AiClient as y, type SecretRecord as z };

package/dist/{aggregates-LoteczVS.d.ts → aggregates-BJT5DGGX.d.ts}

@@ -822,6 +822,10 @@ interface OnyxConfig {
     apiKey?: string;
     apiSecret?: string;
     fetch?: FetchImpl;
+    /**
+     * Default AI model when using shorthand chat calls (`db.chat('...')`). Defaults to `onyx`.
+     */
+    defaultModel?: string;
     /**
      * Default partition for queries, `findById`, and deletes when removing by
      * primary key. Saves rely on the entity's partition field instead.
@@ -934,6 +938,28 @@ interface AiChatCompletionChunk {
 interface AiChatCompletionStream extends AsyncIterable<AiChatCompletionChunk> {
     cancel(): void;
 }
+interface AiChatOptions extends AiRequestOptions {
+    /**
+     * Model to use for the shorthand `db.chat()` call. Defaults to config.defaultModel or `onyx`.
+     */
+    model?: string;
+    /**
+     * Role for the constructed message. Defaults to `user`.
+     */
+    role?: AiChatRole;
+    /**
+     * Temperature for the completion. Omit to use the service default.
+     */
+    temperature?: number | null;
+    /**
+     * Enable SSE streaming. Defaults to `false`.
+     */
+    stream?: boolean;
+    /**
+     * When true, return the raw completion response instead of the first message content.
+     */
+    raw?: boolean;
+}
 interface AiChatClient {
     create(request: AiChatCompletionRequest & {
         stream?: false;
@@ -968,9 +994,90 @@ interface AiErrorResponse {
         [key: string]: unknown;
     } | null;
 }
+interface AiClient {
+    /**
+     * Run a chat completion. Accepts shorthand strings or full requests.
+     *
+     * @example
+     * ```ts
+     * const quick = await db.ai.chat('Summarize last week.'); // returns first message content
+     * const completion = await db.ai.chat(
+     *   { model: 'onyx-chat', messages: [{ role: 'user', content: 'Summarize last week.' }] },
+     *   { databaseId: 'db1', raw: true }, // returns full response
+     * );
+     * ```
+     */
+    chat(content: string, options?: AiChatOptions & {
+        stream?: false;
+        raw?: false | undefined;
+    }): Promise<string>;
+    chat(content: string, options: AiChatOptions & {
+        stream: true;
+    }): Promise<AiChatCompletionStream>;
+    chat(content: string, options: AiChatOptions & {
+        raw: true;
+    }): Promise<AiChatCompletionResponse | AiChatCompletionStream>;
+    chat(request: AiChatCompletionRequest & {
+        stream?: false;
+    }, options?: AiRequestOptions): Promise<AiChatCompletionResponse>;
+    chat(request: AiChatCompletionRequest & {
+        stream: true;
+    }, options?: AiRequestOptions): Promise<AiChatCompletionStream>;
+    chat(request: AiChatCompletionRequest, options?: AiRequestOptions): Promise<AiChatCompletionResponse | AiChatCompletionStream>;
+    /**
+     * Access the chat client for more control over streaming and cancellation.
+     */
+    chatClient(): AiChatClient;
+    /**
+     * List available AI models.
+     *
+     * @example
+     * ```ts
+     * const models = await db.ai.getModels();
+     * ```
+     */
+    getModels(): Promise<AiModelsResponse>;
+    /**
+     * Retrieve a single AI model by ID.
+     *
+     * @example
+     * ```ts
+     * const model = await db.ai.getModel('onyx-chat');
+     * ```
+     */
+    getModel(modelId: string): Promise<AiModel>;
+    /**
+     * Request mutation approval for a script.
+     *
+     * @example
+     * ```ts
+     * const approval = await db.ai.requestScriptApproval({
+     *   script: "db.save({ id: 'u1', email: 'a@b.com' })"
+     * });
+     * ```
+     */
+    requestScriptApproval(input: AiScriptApprovalRequest): Promise<AiScriptApprovalResponse>;
+}
 interface IOnyxDatabase<Schema = Record<string, unknown>> {
     /**
-     * Access OpenAI-compatible chat completions.
+     * AI helpers (chat, models, script approvals) grouped under `db.ai`.
+     *
+     * @example
+     * ```ts
+     * const completion = await db.ai.chat({
+     *   model: 'onyx-chat',
+     *   messages: [{ role: 'user', content: 'Summarize last week.' }],
+     * });
+     * ```
+     */
+    ai: AiClient;
+    /**
+     * Access OpenAI-compatible chat completions via `db.chat('...')` or `db.chat().create(...)`.
+     *
+     * @example
+     * ```ts
+     * const completion = await db.chat('Summarize last week.'); // returns first message content
+     * ```
      *
      * @example
      * ```ts
@@ -995,10 +1102,22 @@ interface IOnyxDatabase<Schema = Record<string, unknown>> {
      * }
      * ```
      */
+    chat(content: string, options?: AiChatOptions & {
+        stream?: false;
+        raw?: false | undefined;
+    }): Promise<string>;
+    chat(content: string, options: AiChatOptions & {
+        stream: true;
+    }): Promise<AiChatCompletionStream>;
+    chat(content: string, options: AiChatOptions & {
+        raw: true;
+    }): Promise<AiChatCompletionResponse | AiChatCompletionStream>;
     chat(): AiChatClient;
     /**
      * List available AI models.
      *
+     * @deprecated Prefer `db.ai.getModels()`.
+     *
      * @example
      * ```ts
      * const models = await db.getModels();
@@ -1008,6 +1127,8 @@ interface IOnyxDatabase<Schema = Record<string, unknown>> {
     /**
      * Retrieve a single AI model by ID.
      *
+     * @deprecated Prefer `db.ai.getModel(...)`.
+     *
      * @example
      * ```ts
      * const model = await db.getModel('onyx-chat');
@@ -1017,6 +1138,8 @@ interface IOnyxDatabase<Schema = Record<string, unknown>> {
     /**
      * Request mutation approval for a script.
      *
+     * @deprecated Prefer `db.ai.requestScriptApproval(...)`.
+     *
      * @example
      * ```ts
      * const approval = await db.requestScriptApproval({
@@ -1634,4 +1757,4 @@ declare const substring: (attribute: string, from: number, length: number) => st
 declare const replace: (attribute: string, pattern: string, repl: string) => string;
 declare const percentile: (attribute: string, p: number) => string;
 
-export { type SchemaDiff as $, type AiRequestOptions as A, type SchemaDataType as B, type SchemaIdentifierGenerator as C, type SchemaIdentifier as D, type SchemaAttribute as E, type FullTextQuery as F, type SchemaIndexType as G, type SchemaIndex as H, type IOnyxDatabase as I, type SchemaResolver as J, type SchemaTriggerEvent as K, type SchemaTrigger as L, type SchemaEntity as M, type SchemaRevisionMetadata as N, type OnyxFacade as O, type SchemaRevision as P, QueryResults as Q, type RetryOptions as R, type SecretMetadata as S, type SchemaHistoryEntry as T, type SchemaUpsertRequest as U, type SchemaValidationResult as V, type SchemaAttributeChange as W, type SchemaIndexChange as X, type SchemaResolverChange as Y, type SchemaTriggerChange as Z, type SchemaTableDiff as _, type QueryResultsPromise as a, type QueryCriteriaOperator as a0, type LogicalOperator as a1, type Sort as a2, type StreamAction as a3, type OnyxDocument as a4, type FetchResponse as a5, type FetchImpl as a6, type QueryCriteria as a7, type QueryCondition as a8, type SelectQuery as a9, containsIgnoreCase as aA, notContains as aB, notContainsIgnoreCase as aC, startsWith as aD, notStartsWith as aE, isNull as aF, notNull as aG, avg as aH, sum as aI, count as aJ, min as aK, max as aL, std as aM, variance as aN, median as aO, upper as aP, lower as aQ, substring as aR, replace as aS, percentile as aT, type UpdateQuery as aa, type QueryPage as ab, type IConditionBuilder as ac, type IQueryBuilder as ad, type ISaveBuilder as ae, type ICascadeBuilder as af, type ICascadeRelationshipBuilder as ag, asc as ah, desc as ai, eq as aj, neq as ak, inOp as al, within as am, notIn as an, notWithin as ao, between as ap, gt as aq, gte as ar, lt as as, lte as at, matches as au, search as av, notMatches as aw, like as ax, notLike as ay, contains as az, type OnyxConfig as b, type AiChatRole as c, type AiToolCallFunction as d, type AiToolCall as e, type AiChatMessage as f, type AiToolFunction as g, type AiTool as h, type AiToolChoice as i, type AiChatCompletionRequest as j, type AiChatCompletionUsage as k, type AiChatCompletionChoice as l, type AiChatCompletionResponse as m, type AiChatCompletionChunkDelta as n, type AiChatCompletionChunkChoice as o, type AiChatCompletionChunk as p, type AiChatCompletionStream as q, type AiChatClient as r, type AiScriptApprovalRequest as s, type AiScriptApprovalResponse as t, type AiModelsResponse as u, type AiModel as v, type AiErrorResponse as w, type SecretRecord as x, type SecretsListResponse as y, type SecretSaveRequest as z };
+export { type SchemaTriggerChange as $, type AiRequestOptions as A, type SecretsListResponse as B, type SecretSaveRequest as C, type SchemaDataType as D, type SchemaIdentifierGenerator as E, type FullTextQuery as F, type SchemaIdentifier as G, type SchemaAttribute as H, type IOnyxDatabase as I, type SchemaIndexType as J, type SchemaIndex as K, type SchemaResolver as L, type SchemaTriggerEvent as M, type SchemaTrigger as N, type OnyxFacade as O, type SchemaEntity as P, QueryResults as Q, type RetryOptions as R, type SecretMetadata as S, type SchemaRevisionMetadata as T, type SchemaRevision as U, type SchemaHistoryEntry as V, type SchemaUpsertRequest as W, type SchemaValidationResult as X, type SchemaAttributeChange as Y, type SchemaIndexChange as Z, type SchemaResolverChange as _, type QueryResultsPromise as a, type SchemaTableDiff as a0, type SchemaDiff as a1, type QueryCriteriaOperator as a2, type LogicalOperator as a3, type Sort as a4, type StreamAction as a5, type OnyxDocument as a6, type FetchResponse as a7, type FetchImpl as a8, type QueryCriteria as a9, notLike as aA, contains as aB, containsIgnoreCase as aC, notContains as aD, notContainsIgnoreCase as aE, startsWith as aF, notStartsWith as aG, isNull as aH, notNull as aI, avg as aJ, sum as aK, count as aL, min as aM, max as aN, std as aO, variance as aP, median as aQ, upper as aR, lower as aS, substring as aT, replace as aU, percentile as aV, type QueryCondition as aa, type SelectQuery as ab, type UpdateQuery as ac, type QueryPage as ad, type IConditionBuilder as ae, type IQueryBuilder as af, type ISaveBuilder as ag, type ICascadeBuilder as ah, type ICascadeRelationshipBuilder as ai, asc as aj, desc as ak, eq as al, neq as am, inOp as an, within as ao, notIn as ap, notWithin as aq, between as ar, gt as as, gte as at, lt as au, lte as av, matches as aw, search as ax, notMatches as ay, like as az, type OnyxConfig as b, type AiChatRole as c, type AiToolCallFunction as d, type AiToolCall as e, type AiChatMessage as f, type AiToolFunction as g, type AiTool as h, type AiToolChoice as i, type AiChatCompletionRequest as j, type AiChatCompletionUsage as k, type AiChatCompletionChoice as l, type AiChatCompletionResponse as m, type AiChatCompletionChunkDelta as n, type AiChatCompletionChunkChoice as o, type AiChatCompletionChunk as p, type AiChatCompletionStream as q, type AiChatOptions as r, type AiChatClient as s, type AiScriptApprovalRequest as t, type AiScriptApprovalResponse as u, type AiModelsResponse as v, type AiModel as w, type AiErrorResponse as x, type AiClient as y, type SecretRecord as z };

package/dist/edge.cjs

@@ -3,6 +3,7 @@
 // src/config/defaults.ts
 var DEFAULT_BASE_URL = "https://api.onyx.dev";
 var DEFAULT_AI_BASE_URL = "https://ai.onyx.dev";
+var DEFAULT_AI_MODEL = "onyx";
 var sanitizeBaseUrl = (u) => u.replace(/\/+$/, "");
 
 // src/errors/config-error.ts
@@ -55,6 +56,7 @@ function readEnv(targetId) {
   const res = dropUndefined({
     baseUrl: pick("ONYX_DATABASE_BASE_URL"),
     aiBaseUrl: pick("ONYX_AI_BASE_URL"),
+    defaultModel: pick("ONYX_DEFAULT_MODEL"),
     databaseId: envId,
     apiKey: pick("ONYX_DATABASE_API_KEY"),
     apiSecret: pick("ONYX_DATABASE_API_SECRET")
@@ -74,12 +76,14 @@ async function resolveConfig(input) {
   const merged = {
     baseUrl: DEFAULT_BASE_URL,
     aiBaseUrl: DEFAULT_AI_BASE_URL,
+    defaultModel: DEFAULT_AI_MODEL,
     ...dropUndefined(env),
     ...dropUndefined(input)
   };
   dbg("merged (pre-validate):", mask(merged));
   const baseUrl = sanitizeBaseUrl(merged.baseUrl ?? DEFAULT_BASE_URL);
   const aiBaseUrl = sanitizeBaseUrl(merged.aiBaseUrl ?? DEFAULT_AI_BASE_URL);
+  const defaultModel = typeof merged.defaultModel === "string" && merged.defaultModel.trim() ? merged.defaultModel.trim() : DEFAULT_AI_MODEL;
   const databaseId = merged.databaseId ?? "";
   const apiKey = merged.apiKey ?? "";
   const apiSecret = merged.apiSecret ?? "";
@@ -105,6 +109,7 @@ async function resolveConfig(input) {
   const resolved = {
     baseUrl,
     aiBaseUrl,
+    defaultModel,
     databaseId,
     apiKey,
     apiSecret,
@@ -1130,58 +1135,64 @@ var OnyxDatabaseImpl = class {
   requestLoggingEnabled;
   responseLoggingEnabled;
   defaultPartition;
+  ai;
   constructor(config, resolveConfigWithCache) {
     this.requestLoggingEnabled = !!config?.requestLoggingEnabled;
     this.responseLoggingEnabled = !!config?.responseLoggingEnabled;
     this.defaultPartition = config?.partition;
     this.cfgPromise = resolveConfigWithCache(config);
+    this.ai = this.createAiFacade();
   }
-  async ensureClient() {
+  async resolveConfig() {
     if (!this.resolved) {
       this.resolved = await this.cfgPromise;
     }
+    return this.resolved;
+  }
+  async ensureClient() {
+    const cfg = await this.resolveConfig();
     if (!this.http) {
       this.http = new HttpClient({
-        baseUrl: this.resolved.baseUrl,
-        apiKey: this.resolved.apiKey,
-        apiSecret: this.resolved.apiSecret,
-        fetchImpl: this.resolved.fetch,
+        baseUrl: cfg.baseUrl,
+        apiKey: cfg.apiKey,
+        apiSecret: cfg.apiSecret,
+        fetchImpl: cfg.fetch,
         requestLoggingEnabled: this.requestLoggingEnabled,
         responseLoggingEnabled: this.responseLoggingEnabled,
-        retryEnabled: this.resolved.retryEnabled,
-        maxRetries: this.resolved.maxRetries,
-        retryInitialDelayMs: this.resolved.retryInitialDelayMs
+        retryEnabled: cfg.retryEnabled,
+        maxRetries: cfg.maxRetries,
+        retryInitialDelayMs: cfg.retryInitialDelayMs
       });
     }
     return {
       http: this.http,
-      fetchImpl: this.resolved.fetch,
-      baseUrl: this.resolved.baseUrl,
-      databaseId: this.resolved.databaseId
+      fetchImpl: cfg.fetch,
+      baseUrl: cfg.baseUrl,
+      databaseId: cfg.databaseId,
+      defaultModel: cfg.defaultModel ?? DEFAULT_AI_MODEL
     };
   }
   async ensureAiClient() {
-    if (!this.resolved) {
-      this.resolved = await this.cfgPromise;
-    }
+    const cfg = await this.resolveConfig();
     if (!this.aiHttp) {
       this.aiHttp = new HttpClient({
-        baseUrl: this.resolved.aiBaseUrl,
-        apiKey: this.resolved.apiKey,
-        apiSecret: this.resolved.apiSecret,
-        fetchImpl: this.resolved.fetch,
+        baseUrl: cfg.aiBaseUrl,
+        apiKey: cfg.apiKey,
+        apiSecret: cfg.apiSecret,
+        fetchImpl: cfg.fetch,
         requestLoggingEnabled: this.requestLoggingEnabled,
         responseLoggingEnabled: this.responseLoggingEnabled,
-        retryEnabled: this.resolved.retryEnabled,
-        maxRetries: this.resolved.maxRetries,
-        retryInitialDelayMs: this.resolved.retryInitialDelayMs
+        retryEnabled: cfg.retryEnabled,
+        maxRetries: cfg.maxRetries,
+        retryInitialDelayMs: cfg.retryInitialDelayMs
       });
     }
     return {
       http: this.aiHttp,
-      fetchImpl: this.resolved.fetch,
-      aiBaseUrl: this.resolved.aiBaseUrl,
-      databaseId: this.resolved.databaseId
+      fetchImpl: cfg.fetch,
+      aiBaseUrl: cfg.aiBaseUrl,
+      databaseId: cfg.databaseId,
+      defaultModel: cfg.defaultModel ?? DEFAULT_AI_MODEL
     };
   }
   registerStream(handle) {
@@ -1196,6 +1207,21 @@ var OnyxDatabaseImpl = class {
       }
     };
   }
+  createAiFacade() {
+    const chat = ((contentOrRequest, options) => {
+      if (typeof contentOrRequest === "string") {
+        return this.chatWithContent(contentOrRequest, options);
+      }
+      return this.getAiChatClient().create(contentOrRequest, options);
+    });
+    return {
+      chat,
+      chatClient: () => this.getAiChatClient(),
+      getModels: () => this.getModels(),
+      getModel: (modelId) => this.getModel(modelId),
+      requestScriptApproval: (input) => this.requestScriptApproval(input)
+    };
+  }
   getRequestLoggingEnabled() {
     return this.requestLoggingEnabled;
   }
@@ -1203,7 +1229,7 @@ var OnyxDatabaseImpl = class {
     return this.responseLoggingEnabled;
   }
   /** -------- IOnyxDatabase -------- */
-  chat() {
+  getAiChatClient() {
     return new AiChatClientImpl(
       () => this.ensureAiClient(),
       (handle) => this.registerStream(handle),
@@ -1211,6 +1237,32 @@ var OnyxDatabaseImpl = class {
       () => this.responseLoggingEnabled
     );
   }
+  async chatWithContent(content, options) {
+    const { defaultModel } = await this.ensureAiClient();
+    const stream = options?.stream ?? false;
+    const request = {
+      model: options?.model ?? defaultModel,
+      messages: [{ role: options?.role ?? "user", content }],
+      stream
+    };
+    if (options && "temperature" in options) {
+      request.temperature = options.temperature ?? null;
+    }
+    const result = await this.getAiChatClient().create(request, options);
+    if (stream) return result;
+    if (options?.raw) return result;
+    const first = result.choices?.[0]?.message?.content;
+    if (typeof first === "string" && first.trim().length > 0) {
+      return first;
+    }
+    throw new Error("Chat completion response is missing message content");
+  }
+  chat(content, options) {
+    if (typeof content === "string") {
+      return this.chatWithContent(content, options);
+    }
+    return this.getAiChatClient();
+  }
   async getModels() {
     const { http } = await this.ensureAiClient();
     return http.request("GET", "/v1/models");