@asklumora/sdk 0.1.0

package/dist/src/providers/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/providers/openai.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACjG,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAErE,UAAU,qBAAqB;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,cAAe,YAAW,cAAc;IACnD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,GAAE,qBAA0B;IAMzC,IAAI,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqC5D,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,CAAC,iBAAiB,CAAC;IAgC/E,OAAO,CAAC,OAAO;CAMhB"}

package/dist/src/providers/openai.js

@@ -0,0 +1,132 @@
+import { requireEnv } from "../env.js";
+import { LumoraProviderError } from "./base.js";
+export class OpenAIProvider {
+    name = "openai";
+    defaultModel;
+    apiKey;
+    baseUrl;
+    constructor(options = {}) {
+        this.apiKey = requireEnv("OPENAI_API_KEY", options.apiKey);
+        this.baseUrl = options.baseUrl ?? "https://api.openai.com/v1";
+        this.defaultModel = options.defaultModel ?? "gpt-4o-mini";
+    }
+    async chat(request) {
+        const model = request.model ?? this.defaultModel;
+        const response = await fetch(`${this.baseUrl}/chat/completions`, {
+            method: "POST",
+            headers: this.headers(),
+            body: JSON.stringify({
+                model,
+                messages: withMemory(request),
+                temperature: request.temperature,
+                max_tokens: request.maxTokens,
+                tools: request.tools?.map((tool) => ({
+                    type: "function",
+                    function: {
+                        name: tool.name,
+                        description: tool.description,
+                        parameters: tool.parameters
+                    }
+                }))
+            })
+        });
+        const json = await readJson(response, this.name);
+        const choice = json.choices?.[0];
+        return {
+            provider: this.name,
+            model,
+            text: choice?.message?.content ?? "",
+            toolCalls: choice?.message?.tool_calls?.map((call) => ({
+                id: call.id,
+                name: call.function?.name,
+                arguments: safeJson(call.function?.arguments)
+            })),
+            raw: json
+        };
+    }
+    async *streamChat(request) {
+        const model = request.model ?? this.defaultModel;
+        const response = await fetch(`${this.baseUrl}/chat/completions`, {
+            method: "POST",
+            headers: this.headers(),
+            body: JSON.stringify({
+                model,
+                messages: withMemory(request),
+                temperature: request.temperature,
+                max_tokens: request.maxTokens,
+                stream: true
+            })
+        });
+        if (!response.ok || !response.body) {
+            throw new LumoraProviderError("OpenAI streaming request failed.", this.name, response.status, await response.text());
+        }
+        for await (const event of streamServerSentEvents(response.body)) {
+            if (event === "[DONE]") {
+                yield { provider: this.name, model, text: "", done: true };
+                return;
+            }
+            const json = safeJson(event);
+            const text = json.choices?.[0]?.delta?.content ?? "";
+            if (text) {
+                yield { provider: this.name, model, text, done: false, raw: json };
+            }
+        }
+    }
+    headers() {
+        return {
+            "Authorization": `Bearer ${this.apiKey}`,
+            "Content-Type": "application/json"
+        };
+    }
+}
+function withMemory(request) {
+    const memory = request.memory?.map((entry) => `- ${entry.content}`).join("\n");
+    if (!memory) {
+        return request.messages;
+    }
+    return [
+        {
+            role: "system",
+            content: `Long-term memory available for this conversation:\n${memory}`
+        },
+        ...request.messages
+    ];
+}
+async function readJson(response, provider) {
+    const json = await response.json().catch(() => undefined);
+    if (!response.ok) {
+        throw new LumoraProviderError("OpenAI request failed.", provider, response.status, json);
+    }
+    return json;
+}
+function safeJson(value) {
+    if (!value) {
+        return {};
+    }
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return {};
+    }
+}
+async function* streamServerSentEvents(stream) {
+    const reader = stream.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done) {
+            return;
+        }
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const line of lines) {
+            if (line.startsWith("data: ")) {
+                yield line.slice(6).trim();
+            }
+        }
+    }
+}
+//# sourceMappingURL=openai.js.map

package/dist/src/providers/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../../src/providers/openai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,mBAAmB,EAAuB,MAAM,WAAW,CAAC;AAQrE,MAAM,OAAO,cAAc;IAChB,IAAI,GAAG,QAAiB,CAAC;IACzB,YAAY,CAAS;IACb,MAAM,CAAS;IACf,OAAO,CAAS;IAEjC,YAAY,UAAiC,EAAE;QAC7C,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,gBAAgB,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC3D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,2BAA2B,CAAC;QAC9D,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,aAAa,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAA0B;QACnC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC;QACjD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,mBAAmB,EAAE;YAC/D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;YACvB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK;gBACL,QAAQ,EAAE,UAAU,CAAC,OAAO,CAAC;gBAC7B,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,UAAU,EAAE,OAAO,CAAC,SAAS;gBAC7B,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;oBACnC,IAAI,EAAE,UAAU;oBAChB,QAAQ,EAAE;wBACR,IAAI,EAAE,IAAI,CAAC,IAAI;wBACf,WAAW,EAAE,IAAI,CAAC,WAAW;wBAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;qBAC5B;iBACF,CAAC,CAAC;aACJ,CAAC;SACH,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QAEjC,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,KAAK;YACL,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE;YACpC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,CAAC;gBAC1D,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI;gBACzB,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC;aAC9C,CAAC,CAAC;YACH,GAAG,EAAE,IAAI;SACV,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,CAAC,UAAU,CAAC,OAA0B;QAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC;QACjD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,mBAAmB,EAAE;YAC/D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;YACvB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK;gBACL,QAAQ,EAAE,UAAU,CAAC,OAAO,CAAC;gBAC7B,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,UAAU,EAAE,OAAO,CAAC,SAAS;gBAC7B,MAAM,EAAE,IAAI;aACb,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,IAAI,mBAAmB,CAAC,kCAAkC,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACvH,CAAC;QAED,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,sBAAsB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAChE,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACvB,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;gBAC3D,OAAO;YACT,CAAC;YAED,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC;YACrD,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;YACrE,CAAC;QACH,CAAC;IACH,CAAC;IAEO,OAAO;QACb,OAAO;YACL,eAAe,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;YACxC,cAAc,EAAE,kBAAkB;SACnC,CAAC;IACJ,CAAC;CACF;AAED,SAAS,UAAU,CAAC,OAA0B;IAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC,QAAQ,CAAC;IAC1B,CAAC;IAED,OAAO;QACL;YACE,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,sDAAsD,MAAM,EAAE;SACxE;QACD,GAAG,OAAO,CAAC,QAAQ;KACpB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,QAAkB,EAAE,QAAkB;IAC5D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC1D,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,mBAAmB,CAAC,wBAAwB,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC3F,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,QAAQ,CAAC,KAAyB;IACzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,SAAS,CAAC,CAAC,sBAAsB,CAAC,MAAkC;IACvE,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI,EAAE,CAAC;YACT,OAAO;QACT,CAAC;QAED,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/providers/xai.d.ts

@@ -0,0 +1,19 @@
+import type { LumoraChatRequest, LumoraChatResponse, LumoraStreamChunk } from "../types/chat.js";
+import { type LumoraProvider } from "./base.js";
+interface XAIProviderOptions {
+    apiKey?: string;
+    baseUrl?: string;
+    defaultModel?: string;
+}
+export declare class XAIProvider implements LumoraProvider {
+    readonly name: "xai";
+    readonly defaultModel: string;
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(options?: XAIProviderOptions);
+    chat(request: LumoraChatRequest): Promise<LumoraChatResponse>;
+    streamChat(request: LumoraChatRequest): AsyncIterable<LumoraStreamChunk>;
+    private headers;
+}
+export {};
+//# sourceMappingURL=xai.d.ts.map

package/dist/src/providers/xai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xai.d.ts","sourceRoot":"","sources":["../../../src/providers/xai.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACjG,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAErE,UAAU,kBAAkB;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,WAAY,YAAW,cAAc;IAChD,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAU;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,GAAE,kBAAuB;IAMtC,IAAI,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuB5D,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,CAAC,iBAAiB,CAAC;IAgC/E,OAAO,CAAC,OAAO;CAMhB"}

package/dist/src/providers/xai.js

@@ -0,0 +1,105 @@
+import { requireEnv } from "../env.js";
+import { LumoraProviderError } from "./base.js";
+export class XAIProvider {
+    name = "xai";
+    defaultModel;
+    apiKey;
+    baseUrl;
+    constructor(options = {}) {
+        this.apiKey = requireEnv("XAI_API_KEY", options.apiKey);
+        this.baseUrl = options.baseUrl ?? "https://api.x.ai/v1";
+        this.defaultModel = options.defaultModel ?? "grok-2-latest";
+    }
+    async chat(request) {
+        const model = request.model ?? this.defaultModel;
+        const response = await fetch(`${this.baseUrl}/chat/completions`, {
+            method: "POST",
+            headers: this.headers(),
+            body: JSON.stringify({
+                model,
+                messages: request.messages,
+                temperature: request.temperature,
+                max_tokens: request.maxTokens
+            })
+        });
+        const json = await readJson(response, this.name);
+        return {
+            provider: this.name,
+            model,
+            text: json.choices?.[0]?.message?.content ?? "",
+            raw: json
+        };
+    }
+    async *streamChat(request) {
+        const model = request.model ?? this.defaultModel;
+        const response = await fetch(`${this.baseUrl}/chat/completions`, {
+            method: "POST",
+            headers: this.headers(),
+            body: JSON.stringify({
+                model,
+                messages: request.messages,
+                temperature: request.temperature,
+                max_tokens: request.maxTokens,
+                stream: true
+            })
+        });
+        if (!response.ok || !response.body) {
+            throw new LumoraProviderError("xAI streaming request failed.", this.name, response.status, await response.text());
+        }
+        for await (const event of streamServerSentEvents(response.body)) {
+            if (event === "[DONE]") {
+                yield { provider: this.name, model, text: "", done: true };
+                return;
+            }
+            const json = safeJson(event);
+            const text = json.choices?.[0]?.delta?.content ?? "";
+            if (text) {
+                yield { provider: this.name, model, text, done: false, raw: json };
+            }
+        }
+    }
+    headers() {
+        return {
+            "Authorization": `Bearer ${this.apiKey}`,
+            "Content-Type": "application/json"
+        };
+    }
+}
+async function readJson(response, provider) {
+    const json = await response.json().catch(() => undefined);
+    if (!response.ok) {
+        throw new LumoraProviderError("xAI request failed.", provider, response.status, json);
+    }
+    return json;
+}
+function safeJson(value) {
+    if (!value) {
+        return {};
+    }
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return {};
+    }
+}
+async function* streamServerSentEvents(stream) {
+    const reader = stream.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done) {
+            return;
+        }
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const line of lines) {
+            if (line.startsWith("data: ")) {
+                yield line.slice(6).trim();
+            }
+        }
+    }
+}
+//# sourceMappingURL=xai.js.map

package/dist/src/providers/xai.js.map

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

package/dist/src/types/chat.d.ts

@@ -0,0 +1,50 @@
+export type LumoraProviderName = "openai" | "xai" | "gemini";
+export type LumoraRole = "system" | "user" | "assistant" | "tool";
+export interface LumoraMessage {
+    role: LumoraRole;
+    content: string;
+    name?: string;
+    toolCallId?: string;
+}
+export interface LumoraTool {
+    name: string;
+    description?: string;
+    parameters: Record<string, unknown>;
+}
+export interface LumoraToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export interface LumoraChatRequest {
+    messages: LumoraMessage[];
+    model?: string;
+    provider?: LumoraProviderName;
+    temperature?: number;
+    maxTokens?: number;
+    tools?: LumoraTool[];
+    memory?: LumoraMemoryEntry[];
+    metadata?: Record<string, unknown>;
+}
+export interface LumoraChatResponse {
+    provider: LumoraProviderName;
+    model: string;
+    text: string;
+    toolCalls?: LumoraToolCall[];
+    raw?: unknown;
+}
+export interface LumoraStreamChunk {
+    provider: LumoraProviderName;
+    model: string;
+    text: string;
+    done: boolean;
+    raw?: unknown;
+}
+export interface LumoraMemoryEntry {
+    id?: string;
+    content: string;
+    importance?: number;
+    createdAt?: string;
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=chat.d.ts.map

package/dist/src/types/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../src/types/chat.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE7D,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAElE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/src/types/chat.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chat.js.map

package/dist/src/types/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../../src/types/chat.ts"],"names":[],"mappings":""}

package/dist/src/types/game.d.ts

@@ -0,0 +1,30 @@
+import type { LumoraMemoryEntry } from "./chat.js";
+export interface LumoraGameCharacter {
+    id: string;
+    name: string;
+    description: string;
+    personality?: string;
+    memory?: LumoraMemoryEntry[];
+    metadata?: Record<string, unknown>;
+}
+export interface LumoraGameContext {
+    world?: string;
+    scene?: string;
+    player?: string;
+    questState?: Record<string, unknown>;
+    lore?: string[];
+}
+export interface LumoraNpcDialogueRequest {
+    character: LumoraGameCharacter;
+    context: LumoraGameContext;
+    playerMessage: string;
+    model?: string;
+    provider?: "openai" | "xai" | "gemini";
+}
+export interface LumoraQuestRequest {
+    context: LumoraGameContext;
+    objective?: string;
+    model?: string;
+    provider?: "openai" | "xai" | "gemini";
+}
+//# sourceMappingURL=game.d.ts.map

package/dist/src/types/game.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game.d.ts","sourceRoot":"","sources":["../../../src/types/game.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,mBAAmB,CAAC;IAC/B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;CACxC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;CACxC"}

package/dist/src/types/game.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=game.js.map

package/dist/src/types/game.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"game.js","sourceRoot":"","sources":["../../../src/types/game.ts"],"names":[],"mappings":""}

package/dist/src/types/training.d.ts

@@ -0,0 +1,28 @@
+export type LumoraKnowledgeSourceType = "document" | "website" | "dataset" | "text";
+export interface LumoraKnowledgeSource {
+    type: LumoraKnowledgeSourceType;
+    name: string;
+    content?: string;
+    url?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface LumoraAssistantConfig {
+    name: string;
+    instructions: string;
+    provider?: "openai" | "xai" | "gemini";
+    model?: string;
+    knowledge?: LumoraKnowledgeSource[];
+    tools?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface LumoraAssistant {
+    id: string;
+    name: string;
+    instructions: string;
+    provider: "openai" | "xai" | "gemini";
+    model: string;
+    knowledge: LumoraKnowledgeSource[];
+    tools: string[];
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=training.d.ts.map

package/dist/src/types/training.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"training.d.ts","sourceRoot":"","sources":["../../../src/types/training.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,yBAAyB,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;AAEpF,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,yBAAyB,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,qBAAqB,EAAE,CAAC;IACnC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/src/types/training.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=training.js.map

package/dist/src/types/training.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"training.js","sourceRoot":"","sources":["../../../src/types/training.ts"],"names":[],"mappings":""}

package/examples/chat.ts

@@ -0,0 +1,19 @@
+import "dotenv/config";
+import { createLumoraClient } from "@asklumora/sdk";
+
+const lumora = createLumoraClient();
+
+const response = await lumora.chat({
+  messages: [
+    {
+      role: "system",
+      content: "You are Lumora, a clear and helpful AI assistant."
+    },
+    {
+      role: "user",
+      content: "Write a short welcome message for a game studio using Lumora."
+    }
+  ]
+});
+
+console.log(response.text);

package/examples/custom-assistant.ts

@@ -0,0 +1,25 @@
+import "dotenv/config";
+import { createLumoraClient } from "@asklumora/sdk";
+
+const lumora = createLumoraClient();
+
+const assistant = lumora.createAssistant({
+  name: "Retail Support Expert",
+  instructions: "Answer as a concise support assistant for a retail business.",
+  knowledge: [
+    {
+      type: "text",
+      name: "Return policy",
+      content: "Customers can return unused items within 30 days with proof of purchase."
+    },
+    {
+      type: "website",
+      name: "Help Center",
+      url: "https://example.com/help"
+    }
+  ]
+});
+
+const response = await lumora.chatWithAssistant(assistant, "Can I return an item after two weeks?");
+
+console.log(response.text);

package/examples/game-ai.ts

@@ -0,0 +1,26 @@
+import "dotenv/config";
+import { createLumoraClient } from "@asklumora/sdk";
+
+const lumora = createLumoraClient();
+
+const dialogue = await lumora.npcDialogue({
+  character: {
+    id: "blacksmith-mira",
+    name: "Mira",
+    description: "A village blacksmith who remembers every blade she has forged.",
+    personality: "Warm, direct, and protective of the town.",
+    memory: [
+      {
+        content: "The player saved Mira's apprentice from the old mine."
+      }
+    ]
+  },
+  context: {
+    world: "A coastal fantasy kingdom where storms reveal ancient ruins.",
+    scene: "The player enters Mira's forge at midnight.",
+    lore: ["The lighthouse bell rings when sea spirits are near."]
+  },
+  playerMessage: "I need a weapon before the tide rises."
+});
+
+console.log(dialogue.text);

package/examples/providers.ts

@@ -0,0 +1,21 @@
+import "dotenv/config";
+import { createLumoraClient } from "@asklumora/sdk";
+
+const lumora = createLumoraClient();
+
+const openai = await lumora.chat({
+  provider: "openai",
+  messages: [{ role: "user", content: "Explain Lumora in one sentence." }]
+});
+
+const xai = await lumora.chat({
+  provider: "xai",
+  messages: [{ role: "user", content: "Explain Lumora in one sentence." }]
+});
+
+const gemini = await lumora.chat({
+  provider: "gemini",
+  messages: [{ role: "user", content: "Explain Lumora in one sentence." }]
+});
+
+console.log({ openai: openai.text, xai: xai.text, gemini: gemini.text });

package/examples/streaming.ts

@@ -0,0 +1,12 @@
+import "dotenv/config";
+import { createLumoraClient } from "@asklumora/sdk";
+
+const lumora = createLumoraClient();
+
+for await (const chunk of lumora.streamChat({
+  messages: [{ role: "user", content: "Give me three product ideas for AI-powered games." }]
+})) {
+  process.stdout.write(chunk.text);
+}
+
+process.stdout.write("\n");

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@asklumora/sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for building Lumora AI chat, custom assistants, and game AI experiences.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "examples",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "keywords": [
+    "lumora",
+    "ai",
+    "sdk",
+    "openai",
+    "xai",
+    "gemini",
+    "chat",
+    "games"
+  ],
+  "author": "Ask Lumora",
+  "license": "MIT",
+  "dependencies": {
+    "dotenv": "^16.4.5"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.10",
+    "typescript": "^5.5.4"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}