@scalix-world/sdk 1.0.0 → 1.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Scalix World Private Limited
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,215 +1,137 @@
 # Scalix SDK — TypeScript
 
-TypeScript client for the Scalix API. Provides typed access to chat, research, audio, images, text, RAG, document generation, database, storage, and account management.
+One SDK, one API key. `scalix.completions` gives you full OpenAI-compatible chat (tools, vision, streaming). The rest of the SDK gives you Audio, Images, Storage, Database, Functions, KV and more — plus Research, RAG, DocGen and Text service classes (see the wiring note under Platform Services).
 
 ## Installation
 
 ```bash
-npm install @scalix-world/sdk
+npm install @scalix-world/sdk openai
 ```
 
 ## Quick Start
 
 ```typescript
-import { ScalixClient } from '@scalix-world/sdk';
+import { Scalix } from '@scalix-world/sdk';
 
-const scalix = new ScalixClient({ apiKey: 'sk_scalix_...' });
+const scalix = new Scalix('scalix_sk_...');
 
-// Chat completion (OpenAI-compatible)
-const reply = await scalix.chat.complete({
-  model: 'scalix-world-ai',
+// Chat completions — full OpenAI-compatible (tools, vision, streaming)
+const response = await scalix.completions.create({
+  model: 'scalix-lumio-lite',
   messages: [{ role: 'user', content: 'Hello!' }],
 });
 
-// Streaming chat
-for await (const chunk of scalix.chat.stream({
-  model: 'scalix-world-ai',
+// Streaming
+const stream = await scalix.completions.create({
+  model: 'scalix-lumio-lite',
   messages: [{ role: 'user', content: 'Tell me a story' }],
-})) {
-  process.stdout.write(chunk);
+  stream: true,
+});
+for await (const chunk of stream) {
+  process.stdout.write(chunk.choices[0]?.delta?.content ?? '');
 }
+```
+
+## Platform Services
 
-// Web search
-const results = await scalix.research.search('quantum computing');
+These are Scalix-only services — no other SDK can reach them. The services wired
+onto the `Scalix` client are listed below.
 
-// Audio transcription
+### Audio — transcription and text-to-speech
+
+```typescript
 const transcript = await scalix.audio.transcribe(audioBlob);
+// speak() returns the raw audio Response — read .arrayBuffer()/.blob() yourself
+const audio = await scalix.audio.speak('Hello world', { voice: 'alloy' });
+```
 
-// Text-to-speech
-const audio = await scalix.audio.speak('Hello world');
+### Images — OpenAI-compatible generation
 
-// Image generation
+```typescript
 const image = await scalix.images.generate('A sunset over mountains');
-const job = await scalix.images.generateAsync('A detailed cityscape');
+// image.data[0].url  (OpenAI-compatible response shape)
+```
 
-// Text utilities
-const sentiment = await scalix.text.sentiment('I love this product!');
-const summary = await scalix.text.summarize(longArticle);
-const translated = await scalix.text.translate('Hello', 'es');
+### Storage — presigned upload URLs
 
-// RAG — upload and query documents
-const doc = await scalix.rag.upload(pdfBlob, { filename: 'report.pdf' });
-const hits = await scalix.rag.query('revenue growth');
+```typescript
+const { uploadUrl, fileUrl } = await scalix.storage.getUploadUrl('application/pdf');
+```
 
-// Document generation
-const report = await scalix.docgen.create({ prompt: 'Q1 report', format: 'pdf' });
+### Other wired services
 
-// ScalixDB
-const dbs = await scalix.database.list();
-const db = await scalix.database.create({ name: 'my-app-db' });
-const result = await scalix.database.query(db.database.id, 'SELECT * FROM users');
+The client also exposes `scalix.database`, `scalix.functions`, `scalix.kv`,
+`scalix.events`, `scalix.cron`, `scalix.compute`, `scalix.run`, `scalix.domains`,
+`scalix.auth`, and `scalix.realtime`. See the typed methods in `src/services/`.
 
-// Storage — presigned upload URL
-const { uploadUrl } = await scalix.storage.getUploadUrl('application/pdf');
+> **Note (service wiring gap):** `ResearchService`, `TextService`, `DocGenService`,
+> `RAGService`, and `EmbeddingsService` are implemented and exported from the
+> package, but are **not yet attached to the `Scalix` client** (no `scalix.research`,
+> `scalix.text`, `scalix.docgen`, `scalix.rag`, `scalix.embeddings`). Until they are
+> wired in `src/client.ts`, construct them directly, e.g.:
+>
+> ```typescript
+> import { ResearchService } from '@scalix-world/sdk';
+> const research = new ResearchService({ apiKey: 'scalix_sk_...', baseUrl: 'https://api.scalix.world' });
+> const results = await research.search('quantum computing');
+> ```
+>
+> The Python SDK wires all of these onto its client.
 
-// Account — manage API keys
-const keys = await scalix.account.listApiKeys();
-const newKey = await scalix.account.createApiKey({ name: 'production-key' });
+### Account — health, info, budget, usage
 
-// Usage tracking
-const usage = await scalix.account.usage({ startDate: '2026-04-01' });
+```typescript
+const health = await scalix.account.health();
+const info = await scalix.account.info();     // email, plan
+const budget = await scalix.account.budget(); // credits remaining
+const usage = await scalix.account.usage();   // usage stats
 ```
 
-## Configuration
+### Models — list available models
 
 ```typescript
-import { ScalixClient } from '@scalix-world/sdk';
+const models = await scalix.models.list();
+// Each model includes: id, context_window, max_output_tokens, plan_required
+```
+
+## Configuration
 
-const scalix = new ScalixClient({
-  apiKey: 'sk_scalix_...',
-  baseUrl: 'https://api.scalix.world', // default
+```typescript
+const scalix = new Scalix('scalix_sk_...', {
+  baseURL: 'https://api.scalix.world', // default
+  maxRetries: 2,                        // auto-retry with exponential backoff
+  timeout: 60000,                       // request timeout in ms
 });
 ```
 
-### Environment Variables
-
-| Variable | Description |
-|----------|-------------|
-| `SCALIX_API_KEY` | Scalix API key |
-| `SCALIX_BASE_URL` | Override API base URL (default: `https://api.scalix.world`) |
-
-## API Reference
-
-### Chat
-
-| Method | Endpoint | SDK Method |
-|--------|----------|------------|
-| POST | `/v1/chat/completions` | `scalix.chat.complete(options)` |
-| POST | `/v1/chat/completions` | `scalix.chat.stream(options)` (streaming) |
-| GET | `/v1/models` | `scalix.chat.models()` |
-
-### Research
-
-| Method | Endpoint | SDK Method |
-|--------|----------|------------|
-| POST | `/v1/research/search` | `scalix.research.search(query)` |
-| POST | `/v1/research` | `scalix.research.research(query)` |
-| POST | `/v1/research/deep` | `scalix.research.deep(query)` |
-
-### Audio
-
-| Method | Endpoint | SDK Method |
-|--------|----------|------------|
-| POST | `/v1/audio/transcribe` | `scalix.audio.transcribe(file)` (multipart) |
-| POST | `/v1/audio/speak/kokoro` | `scalix.audio.speak(text)` |
-| GET | `/v1/audio/kokoro/voices` | `scalix.audio.voices()` |
-| GET | `/v1/audio/kokoro/languages` | `scalix.audio.languages()` |
-
-### Images
-
-| Method | Endpoint | SDK Method |
-|--------|----------|------------|
-| POST | `/v1/images/generate` | `scalix.images.generate(prompt)` |
-| POST | `/v1/images/generate/queue` | `scalix.images.generateAsync(prompt)` |
-| GET | `/v1/images/jobs/{jobId}` | `scalix.images.getJob(jobId)` |
-| GET | `/v1/images/jobs/{jobId}/result` | `scalix.images.getJobResult(jobId)` |
-| GET | `/v1/images/models` | `scalix.images.models()` |
-
-### Text
-
-| Method | Endpoint | SDK Method |
-|--------|----------|------------|
-| POST | `/v1/text/sentiment` | `scalix.text.sentiment(text)` |
-| POST | `/v1/text/summarize` | `scalix.text.summarize(text)` |
-| POST | `/v1/text/translate` | `scalix.text.translate(text, targetLang)` |
-
-### RAG
-
-| Method | Endpoint | SDK Method |
-|--------|----------|------------|
-| POST | `/v1/rag/upload` | `scalix.rag.upload(file)` (multipart) |
-| POST | `/v1/rag/query` | `scalix.rag.query(query)` |
-| GET | `/v1/rag/documents` | `scalix.rag.documents()` |
-| DELETE | `/v1/rag/documents/{docId}` | `scalix.rag.deleteDocument(docId)` |
-
-### Document Generation
-
-| Method | Endpoint | SDK Method |
-|--------|----------|------------|
-| POST | `/v1/docgen/create` | `scalix.docgen.create(options)` |
-| POST | `/v1/docgen/preview` | `scalix.docgen.preview(options)` |
-| GET | `/v1/docgen/formats` | `scalix.docgen.formats()` |
-| GET | `/v1/docgen/templates` | `scalix.docgen.templates()` |
-| GET | `/v1/docgen/history` | `scalix.docgen.history()` |
-| POST | `/v1/docgen/revise` | `scalix.docgen.revise(docId, prompt)` |
-| GET | `/v1/docgen/versions/{docId}` | `scalix.docgen.versions(docId)` |
-
-### Storage
-
-| Method | Endpoint | SDK Method |
-|--------|----------|------------|
-| POST | `/v1/storage/upload-url` | `scalix.storage.getUploadUrl(mimeType)` |
-
-### ScalixDB
-
-| Method | Endpoint | SDK Method |
-|--------|----------|------------|
-| GET | `/api/scalixdb/databases` | `scalix.database.list()` |
-| POST | `/api/scalixdb/databases` | `scalix.database.create(options)` |
-| GET | `/api/scalixdb/databases/{id}` | `scalix.database.get(id)` |
-| DELETE | `/api/scalixdb/databases/{id}` | `scalix.database.delete(id)` |
-| POST | `/api/scalixdb/databases/{id}/query` | `scalix.database.query(id, sql)` |
-| GET | `/api/scalixdb/databases/{id}/tables` | `scalix.database.listTables(id)` |
-| GET | `/api/scalixdb/databases/{id}/metrics` | `scalix.database.getMetrics(id)` |
-
-### Account
-
-| Method | Endpoint | SDK Method |
-|--------|----------|------------|
-| GET | `/health` | `scalix.account.health()` |
-| GET | `/api/dashboard/api-keys` | `scalix.account.listApiKeys()` |
-| POST | `/api/dashboard/api-keys` | `scalix.account.createApiKey({ name })` |
-| DELETE | `/api/dashboard/api-keys/{id}` | `scalix.account.deleteApiKey(keyId)` |
-| GET | `/api/billing/usage` | `scalix.account.usage()` |
+## Available Models
+
+| Model | Description | Availability |
+|-------|-------------|--------------|
+| `scalix-lumio-lite` | Fastest, lightest tier — the default model | Available |
+| `scalix-lumio-pro` | Balanced quality for general use and production apps | Coming soon |
+| `scalix-candela` | Most capable — deep reasoning and complex agents | Coming soon |
+
+`scalix-lumio-lite` is generally available and is the default — calls that omit `model` use it. `scalix-lumio-pro` and `scalix-candela` are announced and coming soon (not callable yet). Run `scalix.models.list()` to see the models enabled for your plan.
 
 ## Error Handling
 
 ```typescript
-import { ScalixClient, ScalixError, AuthenticationError } from '@scalix-world/sdk';
-
-const scalix = new ScalixClient({ apiKey: 'sk_scalix_...' });
+import { Scalix, ScalixError, AuthenticationError, RateLimitError } from '@scalix-world/sdk';
 
 try {
-  const result = await scalix.chat.complete({
-    model: 'scalix-world-ai',
-    messages: [{ role: 'user', content: 'Hello!' }],
-  });
+  await scalix.account.info();
 } catch (error) {
   if (error instanceof AuthenticationError) {
     console.error('Invalid API key');
+  } else if (error instanceof RateLimitError) {
+    console.error('Rate limited — SDK retries automatically');
   } else if (error instanceof ScalixError) {
     console.error('API error:', error.message);
   }
 }
 ```
 
-## Available Models
-
-| Model | Description | Best For |
-|-------|-------------|----------|
-| `scalix-world-ai` | Default model — fast, balanced | General use, chat, quick tasks |
-| `scalix-advanced` | Most capable model — deep reasoning | Complex analysis, coding, agents |
-
 ## License
 
-See [LICENSE](../../LICENSE) for details.
+MIT — see [LICENSE](./LICENSE) for details.

package/dist/client.d.ts

@@ -1,41 +1,82 @@
 /**
- * ScalixClient — unified access to all Scalix API services.
+ * Scalix — the official client for Scalix Cloud.
+ *
+ * Chat completions delegate to the OpenAI SDK (Scalix's AI API is OpenAI-compatible).
+ * Platform services (database, functions, storage, KV, etc.) use a native HTTP client.
  *
  * @example
  * ```typescript
- * import { ScalixClient } from '@scalix-world/sdk';
+ * import { Scalix } from '@scalix-world/sdk';
+ *
+ * const scalix = new Scalix('scalix_sk_...');
  *
- * const scalix = new ScalixClient({ apiKey: 'sk_scalix_...' });
- * const reply = await scalix.chat.complete({
- *   model: 'scalix-world-ai',
+ * // Chat — full OpenAI-compatible (tools, vision, streaming)
+ * const response = await scalix.completions.create({
+ *   model: 'scalix-lumio-lite',
  *   messages: [{ role: 'user', content: 'Hello!' }],
  * });
+ *
+ * // Platform services
+ * const result = await scalix.database.query('select 1');
  * ```
  */
-import { type ScalixConfig } from './config.js';
+import OpenAI from 'openai';
 import { AccountService } from './services/account.js';
 import { AudioService } from './services/audio.js';
-import { ChatService } from './services/chat.js';
+import { AuthService } from './services/auth.js';
+import { ComputeService } from './services/compute.js';
+import { CronService } from './services/cron.js';
 import { DatabaseService } from './services/database.js';
-import { DocGenService } from './services/docgen.js';
+import { DomainsService } from './services/domains.js';
+import { EventsService } from './services/events.js';
+import { FunctionsService } from './services/functions.js';
 import { ImagesService } from './services/images.js';
-import { RAGService } from './services/rag.js';
-import { ResearchService } from './services/research.js';
+import { KvService } from './services/kv.js';
+import { ModelsService } from './services/models.js';
 import { StorageService } from './services/storage.js';
+import { RealtimeService } from './services/realtime.js';
+import { RunService } from './services/run.js';
+import { ResearchService } from './services/research.js';
+import { RAGService } from './services/rag.js';
+import { DocGenService } from './services/docgen.js';
 import { TextService } from './services/text.js';
-export declare class ScalixClient {
+import { EmbeddingsService } from './services/embeddings.js';
+import { SearchService } from './services/search.js';
+import { ShieldService } from './services/shield.js';
+export interface ScalixOptions {
+    baseURL?: string;
+    maxRetries?: number;
+    timeout?: number;
+}
+export declare class Scalix {
+    /** OpenAI-compatible chat completions — full tool calling, vision, streaming */
+    readonly completions: OpenAI['chat']['completions'];
+    /** Pre-configured OpenAI client for advanced usage (embeddings, raw access, etc.) */
+    readonly openai: OpenAI;
     readonly account: AccountService;
     readonly audio: AudioService;
-    readonly chat: ChatService;
+    readonly auth: AuthService;
+    readonly compute: ComputeService;
+    readonly cron: CronService;
     readonly database: DatabaseService;
-    readonly docgen: DocGenService;
+    readonly domains: DomainsService;
+    readonly events: EventsService;
+    readonly functions: FunctionsService;
     readonly images: ImagesService;
-    readonly rag: RAGService;
-    readonly research: ResearchService;
+    readonly kv: KvService;
+    readonly models: ModelsService;
     readonly storage: StorageService;
+    readonly realtime: RealtimeService;
+    readonly run: RunService;
+    readonly research: ResearchService;
+    readonly rag: RAGService;
+    readonly docgen: DocGenService;
     readonly text: TextService;
-    constructor(options?: {
-        apiKey?: string;
-    } & Partial<ScalixConfig>);
+    readonly embeddings: EmbeddingsService;
+    readonly search: SearchService;
+    readonly shield: ShieldService;
+    constructor(apiKey?: string, options?: ScalixOptions);
 }
+/** @deprecated Use `Scalix` instead */
+export declare const ScalixClient: typeof Scalix;
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAwB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,qBAAa,YAAY;IACvB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;gBAEf,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;CAgBlE"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -1,54 +1,117 @@
 /**
- * ScalixClient — unified access to all Scalix API services.
+ * Scalix — the official client for Scalix Cloud.
+ *
+ * Chat completions delegate to the OpenAI SDK (Scalix's AI API is OpenAI-compatible).
+ * Platform services (database, functions, storage, KV, etc.) use a native HTTP client.
  *
  * @example
  * ```typescript
- * import { ScalixClient } from '@scalix-world/sdk';
+ * import { Scalix } from '@scalix-world/sdk';
+ *
+ * const scalix = new Scalix('scalix_sk_...');
  *
- * const scalix = new ScalixClient({ apiKey: 'sk_scalix_...' });
- * const reply = await scalix.chat.complete({
- *   model: 'scalix-world-ai',
+ * // Chat — full OpenAI-compatible (tools, vision, streaming)
+ * const response = await scalix.completions.create({
+ *   model: 'scalix-lumio-lite',
  *   messages: [{ role: 'user', content: 'Hello!' }],
  * });
+ *
+ * // Platform services
+ * const result = await scalix.database.query('select 1');
  * ```
  */
-import { configure, getConfig } from './config.js';
+import OpenAI from 'openai';
 import { AccountService } from './services/account.js';
 import { AudioService } from './services/audio.js';
-import { ChatService } from './services/chat.js';
+import { AuthService } from './services/auth.js';
+import { ComputeService } from './services/compute.js';
+import { CronService } from './services/cron.js';
 import { DatabaseService } from './services/database.js';
-import { DocGenService } from './services/docgen.js';
+import { DomainsService } from './services/domains.js';
+import { EventsService } from './services/events.js';
+import { FunctionsService } from './services/functions.js';
 import { ImagesService } from './services/images.js';
-import { RAGService } from './services/rag.js';
-import { ResearchService } from './services/research.js';
+import { KvService } from './services/kv.js';
+import { ModelsService } from './services/models.js';
 import { StorageService } from './services/storage.js';
+import { RealtimeService } from './services/realtime.js';
+import { RunService } from './services/run.js';
+import { ResearchService } from './services/research.js';
+import { RAGService } from './services/rag.js';
+import { DocGenService } from './services/docgen.js';
 import { TextService } from './services/text.js';
-export class ScalixClient {
+import { EmbeddingsService } from './services/embeddings.js';
+import { SearchService } from './services/search.js';
+import { ShieldService } from './services/shield.js';
+export class Scalix {
+    /** OpenAI-compatible chat completions — full tool calling, vision, streaming */
+    completions;
+    /** Pre-configured OpenAI client for advanced usage (embeddings, raw access, etc.) */
+    openai;
     account;
     audio;
-    chat;
+    auth;
+    compute;
+    cron;
     database;
-    docgen;
+    domains;
+    events;
+    functions;
     images;
-    rag;
-    research;
+    kv;
+    models;
     storage;
+    realtime;
+    run;
+    research;
+    rag;
+    docgen;
     text;
-    constructor(options) {
-        if (options) {
-            configure(options);
+    embeddings;
+    search;
+    shield;
+    constructor(apiKey, options) {
+        const resolvedKey = apiKey ?? process.env.SCALIX_API_KEY ?? process.env.SCALIX_TOKEN;
+        if (!resolvedKey) {
+            throw new Error('No API key provided. Pass apiKey or set SCALIX_API_KEY / SCALIX_TOKEN env var, ' +
+                'or run `scalix login` to save credentials.');
         }
-        const config = getConfig();
+        // Host root (e.g. https://api.scalix.world). Native services call full
+        // paths like /v1/user/info and /api/v1/sql, so config.baseUrl must be the
+        // bare host. The OpenAI-compatible AI surface is served under /v1/ai.
+        const base = (options?.baseURL ?? 'https://api.scalix.world').replace(/\/+$/, '');
+        const baseUrl = base.replace(/\/v1(\/ai)?$/, '');
+        const config = { apiKey: resolvedKey, baseUrl, maxRetries: options?.maxRetries, timeout: options?.timeout };
+        this.openai = new OpenAI({
+            baseURL: `${baseUrl}/v1/ai`,
+            apiKey: resolvedKey,
+            defaultHeaders: { 'User-Agent': 'Scalix-SDK/2.0' },
+        });
+        this.completions = this.openai.chat.completions;
         this.account = new AccountService(config);
         this.audio = new AudioService(config);
-        this.chat = new ChatService(config);
+        this.auth = new AuthService(config);
+        this.compute = new ComputeService(config);
+        this.cron = new CronService(config);
         this.database = new DatabaseService(config);
-        this.docgen = new DocGenService(config);
+        this.domains = new DomainsService(config);
+        this.events = new EventsService(config);
+        this.functions = new FunctionsService(config);
         this.images = new ImagesService(config);
-        this.rag = new RAGService(config);
-        this.research = new ResearchService(config);
+        this.kv = new KvService(config);
+        this.models = new ModelsService(config);
         this.storage = new StorageService(config);
+        this.realtime = new RealtimeService(config);
+        this.run = new RunService(config);
+        this.research = new ResearchService(config);
+        this.rag = new RAGService(config);
+        this.docgen = new DocGenService(config);
         this.text = new TextService(config);
+        this.embeddings = new EmbeddingsService(config);
+        this.search = new SearchService(config);
+        this.shield = new ShieldService(config);
     }
 }
+/** @deprecated Use `Scalix` instead */
+export const ScalixClient = Scalix;
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAqB,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,OAAO,YAAY;IACd,OAAO,CAAiB;IACxB,KAAK,CAAe;IACpB,IAAI,CAAc;IAClB,QAAQ,CAAkB;IAC1B,MAAM,CAAgB;IACtB,MAAM,CAAgB;IACtB,GAAG,CAAa;IAChB,QAAQ,CAAkB;IAC1B,OAAO,CAAiB;IACxB,IAAI,CAAc;IAE3B,YAAY,OAAqD;QAC/D,IAAI,OAAO,EAAE,CAAC;YACZ,SAAS,CAAC,OAAO,CAAC,CAAC;QACrB,CAAC;QACD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;CACF"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -1,8 +1,7 @@
 export interface ScalixConfig {
-    apiKey?: string;
+    apiKey: string;
     baseUrl: string;
-    defaultModel: string;
+    maxRetries?: number;
+    timeout?: number;
 }
-export declare function configure(options: Partial<ScalixConfig>): ScalixConfig;
-export declare function getConfig(): ScalixConfig;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AASD,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAStE;AAED,wBAAgB,SAAS,IAAI,YAAY,CAKxC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/config.js

@@ -1,22 +1,2 @@
-const DEFAULT_CONFIG = {
-    baseUrl: 'https://api.scalix.world',
-    defaultModel: 'scalix-world-ai',
-};
-let _config = null;
-export function configure(options) {
-    const env = typeof process !== 'undefined' ? process.env : {};
-    _config = {
-        ...DEFAULT_CONFIG,
-        ...(env.SCALIX_API_KEY && { apiKey: env.SCALIX_API_KEY }),
-        ...(env.SCALIX_BASE_URL && { baseUrl: env.SCALIX_BASE_URL }),
-        ...options,
-    };
-    return _config;
-}
-export function getConfig() {
-    if (!_config) {
-        _config = configure({});
-    }
-    return _config;
-}
+export {};
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAMA,MAAM,cAAc,GAAiB;IACnC,OAAO,EAAE,0BAA0B;IACnC,YAAY,EAAE,iBAAiB;CAChC,CAAC;AAEF,IAAI,OAAO,GAAwB,IAAI,CAAC;AAExC,MAAM,UAAU,SAAS,CAAC,OAA8B;IACtD,MAAM,GAAG,GAAG,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,OAAO,GAAG;QACR,GAAG,cAAc;QACjB,GAAG,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,cAAc,EAAE,CAAC;QACzD,GAAG,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,eAAe,EAAE,CAAC;QAC5D,GAAG,OAAO;KACX,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":""}