@asklumora/sdk 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/README.md +1162 -0
  2. package/dist/examples/chat.d.ts +2 -0
  3. package/dist/examples/chat.d.ts.map +1 -0
  4. package/dist/examples/chat.js +17 -0
  5. package/dist/examples/chat.js.map +1 -0
  6. package/dist/examples/custom-assistant.d.ts +2 -0
  7. package/dist/examples/custom-assistant.d.ts.map +1 -0
  8. package/dist/examples/custom-assistant.js +22 -0
  9. package/dist/examples/custom-assistant.js.map +1 -0
  10. package/dist/examples/game-ai.d.ts +2 -0
  11. package/dist/examples/game-ai.d.ts.map +1 -0
  12. package/dist/examples/game-ai.js +24 -0
  13. package/dist/examples/game-ai.js.map +1 -0
  14. package/dist/examples/providers.d.ts +2 -0
  15. package/dist/examples/providers.d.ts.map +1 -0
  16. package/dist/examples/providers.js +17 -0
  17. package/dist/examples/providers.js.map +1 -0
  18. package/dist/examples/streaming.d.ts +2 -0
  19. package/dist/examples/streaming.d.ts.map +1 -0
  20. package/dist/examples/streaming.js +10 -0
  21. package/dist/examples/streaming.js.map +1 -0
  22. package/dist/src/client.d.ts +34 -0
  23. package/dist/src/client.d.ts.map +1 -0
  24. package/dist/src/client.js +154 -0
  25. package/dist/src/client.js.map +1 -0
  26. package/dist/src/env.d.ts +11 -0
  27. package/dist/src/env.d.ts.map +1 -0
  28. package/dist/src/env.js +24 -0
  29. package/dist/src/env.js.map +1 -0
  30. package/dist/src/index.d.ts +11 -0
  31. package/dist/src/index.d.ts.map +1 -0
  32. package/dist/src/index.js +6 -0
  33. package/dist/src/index.js.map +1 -0
  34. package/dist/src/providers/base.d.ts +14 -0
  35. package/dist/src/providers/base.d.ts.map +1 -0
  36. package/dist/src/providers/base.js +13 -0
  37. package/dist/src/providers/base.js.map +1 -0
  38. package/dist/src/providers/gemini.d.ts +18 -0
  39. package/dist/src/providers/gemini.d.ts.map +1 -0
  40. package/dist/src/providers/gemini.js +102 -0
  41. package/dist/src/providers/gemini.js.map +1 -0
  42. package/dist/src/providers/openai.d.ts +19 -0
  43. package/dist/src/providers/openai.d.ts.map +1 -0
  44. package/dist/src/providers/openai.js +132 -0
  45. package/dist/src/providers/openai.js.map +1 -0
  46. package/dist/src/providers/xai.d.ts +19 -0
  47. package/dist/src/providers/xai.d.ts.map +1 -0
  48. package/dist/src/providers/xai.js +105 -0
  49. package/dist/src/providers/xai.js.map +1 -0
  50. package/dist/src/types/chat.d.ts +50 -0
  51. package/dist/src/types/chat.d.ts.map +1 -0
  52. package/dist/src/types/chat.js +2 -0
  53. package/dist/src/types/chat.js.map +1 -0
  54. package/dist/src/types/game.d.ts +30 -0
  55. package/dist/src/types/game.d.ts.map +1 -0
  56. package/dist/src/types/game.js +2 -0
  57. package/dist/src/types/game.js.map +1 -0
  58. package/dist/src/types/training.d.ts +28 -0
  59. package/dist/src/types/training.d.ts.map +1 -0
  60. package/dist/src/types/training.js +2 -0
  61. package/dist/src/types/training.js.map +1 -0
  62. package/examples/chat.ts +19 -0
  63. package/examples/custom-assistant.ts +25 -0
  64. package/examples/game-ai.ts +26 -0
  65. package/examples/providers.ts +21 -0
  66. package/examples/streaming.ts +12 -0
  67. package/package.json +46 -0
@@ -0,0 +1,2 @@
1
+ import "dotenv/config";
2
+ //# sourceMappingURL=chat.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../examples/chat.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC"}
@@ -0,0 +1,17 @@
1
+ import "dotenv/config";
2
+ import { createLumoraClient } from "@asklumora/sdk";
3
+ const lumora = createLumoraClient();
4
+ const response = await lumora.chat({
5
+ messages: [
6
+ {
7
+ role: "system",
8
+ content: "You are Lumora, a clear and helpful AI assistant."
9
+ },
10
+ {
11
+ role: "user",
12
+ content: "Write a short welcome message for a game studio using Lumora."
13
+ }
14
+ ]
15
+ });
16
+ console.log(response.text);
17
+ //# sourceMappingURL=chat.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"chat.js","sourceRoot":"","sources":["../../examples/chat.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;AAEpC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;IACjC,QAAQ,EAAE;QACR;YACE,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,mDAAmD;SAC7D;QACD;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,+DAA+D;SACzE;KACF;CACF,CAAC,CAAC;AAEH,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ import "dotenv/config";
2
+ //# sourceMappingURL=custom-assistant.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"custom-assistant.d.ts","sourceRoot":"","sources":["../../examples/custom-assistant.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC"}
@@ -0,0 +1,22 @@
1
+ import "dotenv/config";
2
+ import { createLumoraClient } from "@asklumora/sdk";
3
+ const lumora = createLumoraClient();
4
+ const assistant = lumora.createAssistant({
5
+ name: "Retail Support Expert",
6
+ instructions: "Answer as a concise support assistant for a retail business.",
7
+ knowledge: [
8
+ {
9
+ type: "text",
10
+ name: "Return policy",
11
+ content: "Customers can return unused items within 30 days with proof of purchase."
12
+ },
13
+ {
14
+ type: "website",
15
+ name: "Help Center",
16
+ url: "https://example.com/help"
17
+ }
18
+ ]
19
+ });
20
+ const response = await lumora.chatWithAssistant(assistant, "Can I return an item after two weeks?");
21
+ console.log(response.text);
22
+ //# sourceMappingURL=custom-assistant.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"custom-assistant.js","sourceRoot":"","sources":["../../examples/custom-assistant.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;AAEpC,MAAM,SAAS,GAAG,MAAM,CAAC,eAAe,CAAC;IACvC,IAAI,EAAE,uBAAuB;IAC7B,YAAY,EAAE,8DAA8D;IAC5E,SAAS,EAAE;QACT;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,0EAA0E;SACpF;QACD;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,aAAa;YACnB,GAAG,EAAE,0BAA0B;SAChC;KACF;CACF,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,SAAS,EAAE,uCAAuC,CAAC,CAAC;AAEpG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ import "dotenv/config";
2
+ //# sourceMappingURL=game-ai.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"game-ai.d.ts","sourceRoot":"","sources":["../../examples/game-ai.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC"}
@@ -0,0 +1,24 @@
1
+ import "dotenv/config";
2
+ import { createLumoraClient } from "@asklumora/sdk";
3
+ const lumora = createLumoraClient();
4
+ const dialogue = await lumora.npcDialogue({
5
+ character: {
6
+ id: "blacksmith-mira",
7
+ name: "Mira",
8
+ description: "A village blacksmith who remembers every blade she has forged.",
9
+ personality: "Warm, direct, and protective of the town.",
10
+ memory: [
11
+ {
12
+ content: "The player saved Mira's apprentice from the old mine."
13
+ }
14
+ ]
15
+ },
16
+ context: {
17
+ world: "A coastal fantasy kingdom where storms reveal ancient ruins.",
18
+ scene: "The player enters Mira's forge at midnight.",
19
+ lore: ["The lighthouse bell rings when sea spirits are near."]
20
+ },
21
+ playerMessage: "I need a weapon before the tide rises."
22
+ });
23
+ console.log(dialogue.text);
24
+ //# sourceMappingURL=game-ai.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"game-ai.js","sourceRoot":"","sources":["../../examples/game-ai.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;AAEpC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC;IACxC,SAAS,EAAE;QACT,EAAE,EAAE,iBAAiB;QACrB,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,gEAAgE;QAC7E,WAAW,EAAE,2CAA2C;QACxD,MAAM,EAAE;YACN;gBACE,OAAO,EAAE,uDAAuD;aACjE;SACF;KACF;IACD,OAAO,EAAE;QACP,KAAK,EAAE,8DAA8D;QACrE,KAAK,EAAE,6CAA6C;QACpD,IAAI,EAAE,CAAC,sDAAsD,CAAC;KAC/D;IACD,aAAa,EAAE,wCAAwC;CACxD,CAAC,CAAC;AAEH,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ import "dotenv/config";
2
+ //# sourceMappingURL=providers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../examples/providers.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC"}
@@ -0,0 +1,17 @@
1
+ import "dotenv/config";
2
+ import { createLumoraClient } from "@asklumora/sdk";
3
+ const lumora = createLumoraClient();
4
+ const openai = await lumora.chat({
5
+ provider: "openai",
6
+ messages: [{ role: "user", content: "Explain Lumora in one sentence." }]
7
+ });
8
+ const xai = await lumora.chat({
9
+ provider: "xai",
10
+ messages: [{ role: "user", content: "Explain Lumora in one sentence." }]
11
+ });
12
+ const gemini = await lumora.chat({
13
+ provider: "gemini",
14
+ messages: [{ role: "user", content: "Explain Lumora in one sentence." }]
15
+ });
16
+ console.log({ openai: openai.text, xai: xai.text, gemini: gemini.text });
17
+ //# sourceMappingURL=providers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"providers.js","sourceRoot":"","sources":["../../examples/providers.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;AAEpC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;IAC/B,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;CACzE,CAAC,CAAC;AAEH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;IAC5B,QAAQ,EAAE,KAAK;IACf,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;CACzE,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;IAC/B,QAAQ,EAAE,QAAQ;IAClB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;CACzE,CAAC,CAAC;AAEH,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ import "dotenv/config";
2
+ //# sourceMappingURL=streaming.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../examples/streaming.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC"}
@@ -0,0 +1,10 @@
1
+ import "dotenv/config";
2
+ import { createLumoraClient } from "@asklumora/sdk";
3
+ const lumora = createLumoraClient();
4
+ for await (const chunk of lumora.streamChat({
5
+ messages: [{ role: "user", content: "Give me three product ideas for AI-powered games." }]
6
+ })) {
7
+ process.stdout.write(chunk.text);
8
+ }
9
+ process.stdout.write("\n");
10
+ //# sourceMappingURL=streaming.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"streaming.js","sourceRoot":"","sources":["../../examples/streaming.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;AAEpC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,CAAC,UAAU,CAAC;IAC1C,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,mDAAmD,EAAE,CAAC;CAC3F,CAAC,EAAE,CAAC;IACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC"}
@@ -0,0 +1,34 @@
1
+ import type { LumoraProvider } from "./providers/base.js";
2
+ import type { LumoraChatRequest, LumoraChatResponse, LumoraMemoryEntry, LumoraProviderName, LumoraStreamChunk } from "./types/chat.js";
3
+ import type { LumoraAssistant, LumoraAssistantConfig } from "./types/training.js";
4
+ import type { LumoraNpcDialogueRequest, LumoraQuestRequest } from "./types/game.js";
5
+ export interface LumoraClientOptions {
6
+ defaultProvider?: LumoraProviderName;
7
+ defaultModel?: string;
8
+ providers?: Partial<Record<LumoraProviderName, LumoraProvider>>;
9
+ apiKeys?: {
10
+ openai?: string;
11
+ xai?: string;
12
+ gemini?: string;
13
+ };
14
+ }
15
+ export declare class LumoraSDK {
16
+ private readonly providers;
17
+ private readonly defaultProvider;
18
+ private readonly defaultModel?;
19
+ private readonly memory;
20
+ constructor(options?: LumoraClientOptions);
21
+ chat(request: LumoraChatRequest): Promise<LumoraChatResponse>;
22
+ streamChat(request: LumoraChatRequest): AsyncIterable<LumoraStreamChunk>;
23
+ remember(entry: LumoraMemoryEntry): LumoraMemoryEntry;
24
+ createAssistant(config: LumoraAssistantConfig): LumoraAssistant;
25
+ chatWithAssistant(assistant: LumoraAssistant, userMessage: string): Promise<LumoraChatResponse>;
26
+ npcDialogue(request: LumoraNpcDialogueRequest): Promise<LumoraChatResponse>;
27
+ generateQuest(request: LumoraQuestRequest): Promise<LumoraChatResponse>;
28
+ useProvider(provider: LumoraProvider): this;
29
+ private getProvider;
30
+ private resolveModel;
31
+ private registerDefaultProvider;
32
+ }
33
+ export declare function createLumoraClient(options?: LumoraClientOptions): LumoraSDK;
34
+ //# sourceMappingURL=client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,KAAK,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEpF,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,EAAE,kBAAkB,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,cAAc,CAAC,CAAC,CAAC;IAChE,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0C;IACpE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;gBAEtC,OAAO,GAAE,mBAAwB;IAS7C,IAAI,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAU7D,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,CAAC,iBAAiB,CAAC;IAUxE,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,iBAAiB;IAWrD,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,eAAe;IAezD,iBAAiB,CAAC,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAkBrG,WAAW,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAyB3E,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAoBvE,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAK3C,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,uBAAuB;CAiBhC;AAED,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAE3E"}
@@ -0,0 +1,154 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { loadLumoraEnv } from "./env.js";
3
+ import { GeminiProvider } from "./providers/gemini.js";
4
+ import { OpenAIProvider } from "./providers/openai.js";
5
+ import { XAIProvider } from "./providers/xai.js";
6
+ export class LumoraSDK {
7
+ providers;
8
+ defaultProvider;
9
+ defaultModel;
10
+ memory = [];
11
+ constructor(options = {}) {
12
+ const env = loadLumoraEnv();
13
+ this.defaultProvider = options.defaultProvider ?? env.defaultProvider;
14
+ this.defaultModel = options.defaultModel ?? env.defaultModel;
15
+ this.providers = new Map(Object.entries(options.providers ?? {}));
16
+ this.registerDefaultProvider(this.defaultProvider, options, env);
17
+ }
18
+ chat(request) {
19
+ const provider = this.getProvider(request.provider);
20
+ return provider.chat({
21
+ ...request,
22
+ model: this.resolveModel(provider, request),
23
+ memory: [...this.memory, ...(request.memory ?? [])]
24
+ });
25
+ }
26
+ streamChat(request) {
27
+ const provider = this.getProvider(request.provider);
28
+ return provider.streamChat({
29
+ ...request,
30
+ model: this.resolveModel(provider, request),
31
+ memory: [...this.memory, ...(request.memory ?? [])]
32
+ });
33
+ }
34
+ remember(entry) {
35
+ const memory = {
36
+ ...entry,
37
+ id: entry.id ?? randomUUID(),
38
+ createdAt: entry.createdAt ?? new Date().toISOString()
39
+ };
40
+ this.memory.push(memory);
41
+ return memory;
42
+ }
43
+ createAssistant(config) {
44
+ const provider = this.getProvider(config.provider);
45
+ return {
46
+ id: randomUUID(),
47
+ name: config.name,
48
+ instructions: config.instructions,
49
+ provider: provider.name,
50
+ model: config.model ?? (config.provider ? provider.defaultModel : this.defaultModel ?? provider.defaultModel),
51
+ knowledge: config.knowledge ?? [],
52
+ tools: config.tools ?? [],
53
+ metadata: config.metadata
54
+ };
55
+ }
56
+ async chatWithAssistant(assistant, userMessage) {
57
+ const knowledge = assistant.knowledge
58
+ .map((source) => `${source.type.toUpperCase()}: ${source.name}\n${source.content ?? source.url ?? ""}`)
59
+ .join("\n\n");
60
+ return this.chat({
61
+ provider: assistant.provider,
62
+ model: assistant.model,
63
+ messages: [
64
+ {
65
+ role: "system",
66
+ content: [assistant.instructions, knowledge && `Knowledge:\n${knowledge}`].filter(Boolean).join("\n\n")
67
+ },
68
+ { role: "user", content: userMessage }
69
+ ]
70
+ });
71
+ }
72
+ npcDialogue(request) {
73
+ return this.chat({
74
+ provider: request.provider,
75
+ model: request.model,
76
+ memory: request.character.memory,
77
+ messages: [
78
+ {
79
+ role: "system",
80
+ content: [
81
+ `You are ${request.character.name}.`,
82
+ request.character.description,
83
+ request.character.personality && `Personality: ${request.character.personality}`,
84
+ request.context.world && `World: ${request.context.world}`,
85
+ request.context.scene && `Scene: ${request.context.scene}`,
86
+ request.context.lore?.length && `Lore:\n${request.context.lore.join("\n")}`,
87
+ "Respond as an in-world character with context-aware dialogue."
88
+ ]
89
+ .filter(Boolean)
90
+ .join("\n")
91
+ },
92
+ { role: "user", content: request.playerMessage }
93
+ ]
94
+ });
95
+ }
96
+ generateQuest(request) {
97
+ return this.chat({
98
+ provider: request.provider,
99
+ model: request.model,
100
+ messages: [
101
+ {
102
+ role: "system",
103
+ content: "Create dynamic game quest content with objectives, stakes, NPC hooks, and possible outcomes."
104
+ },
105
+ {
106
+ role: "user",
107
+ content: JSON.stringify({
108
+ context: request.context,
109
+ objective: request.objective
110
+ })
111
+ }
112
+ ]
113
+ });
114
+ }
115
+ useProvider(provider) {
116
+ this.providers.set(provider.name, provider);
117
+ return this;
118
+ }
119
+ getProvider(name = this.defaultProvider) {
120
+ const provider = this.providers.get(name);
121
+ if (provider) {
122
+ return provider;
123
+ }
124
+ this.registerDefaultProvider(name);
125
+ return this.providers.get(name);
126
+ }
127
+ resolveModel(provider, request) {
128
+ if (request.model) {
129
+ return request.model;
130
+ }
131
+ if (!request.provider || request.provider === this.defaultProvider) {
132
+ return this.defaultModel ?? provider.defaultModel;
133
+ }
134
+ return provider.defaultModel;
135
+ }
136
+ registerDefaultProvider(name, options = {}, env = loadLumoraEnv()) {
137
+ if (this.providers.has(name)) {
138
+ return;
139
+ }
140
+ if (name === "openai") {
141
+ this.providers.set(name, new OpenAIProvider({ apiKey: options.apiKeys?.openai ?? env.openAiApiKey }));
142
+ }
143
+ if (name === "xai") {
144
+ this.providers.set(name, new XAIProvider({ apiKey: options.apiKeys?.xai ?? env.xaiApiKey }));
145
+ }
146
+ if (name === "gemini") {
147
+ this.providers.set(name, new GeminiProvider({ apiKey: options.apiKeys?.gemini ?? env.geminiApiKey }));
148
+ }
149
+ }
150
+ }
151
+ export function createLumoraClient(options) {
152
+ return new LumoraSDK(options);
153
+ }
154
+ //# sourceMappingURL=client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ import type { LumoraProviderName } from "./types/chat.js";
2
+ export interface LumoraEnv {
3
+ openAiApiKey?: string;
4
+ xaiApiKey?: string;
5
+ geminiApiKey?: string;
6
+ defaultProvider: LumoraProviderName;
7
+ defaultModel?: string;
8
+ }
9
+ export declare function loadLumoraEnv(): LumoraEnv;
10
+ export declare function requireEnv(name: string, value: string | undefined): string;
11
+ //# sourceMappingURL=env.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/env.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAI1D,MAAM,WAAW,SAAS;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,kBAAkB,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,aAAa,IAAI,SAAS,CAQzC;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAM1E"}
@@ -0,0 +1,24 @@
1
+ import dotenv from "dotenv";
2
+ dotenv.config();
3
+ export function loadLumoraEnv() {
4
+ return {
5
+ openAiApiKey: process.env.OPENAI_API_KEY,
6
+ xaiApiKey: process.env.XAI_API_KEY,
7
+ geminiApiKey: process.env.GEMINI_API_KEY,
8
+ defaultProvider: parseProvider(process.env.LUMORA_DEFAULT_PROVIDER),
9
+ defaultModel: process.env.LUMORA_DEFAULT_MODEL
10
+ };
11
+ }
12
+ export function requireEnv(name, value) {
13
+ if (!value) {
14
+ throw new Error(`Missing ${name}. Add it to your .env file or environment variables.`);
15
+ }
16
+ return value;
17
+ }
18
+ function parseProvider(value) {
19
+ if (value === "xai" || value === "gemini" || value === "openai") {
20
+ return value;
21
+ }
22
+ return "openai";
23
+ }
24
+ //# sourceMappingURL=env.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAG5B,MAAM,CAAC,MAAM,EAAE,CAAC;AAUhB,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;QACxC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW;QAClC,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;QACxC,eAAe,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;QACnE,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB;KAC/C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,KAAyB;IAChE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,sDAAsD,CAAC,CAAC;IACzF,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CAAC,KAAyB;IAC9C,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}
@@ -0,0 +1,11 @@
1
+ export { createLumoraClient, LumoraSDK } from "./client.js";
2
+ export type { LumoraClientOptions } from "./client.js";
3
+ export { OpenAIProvider } from "./providers/openai.js";
4
+ export { XAIProvider } from "./providers/xai.js";
5
+ export { GeminiProvider } from "./providers/gemini.js";
6
+ export { LumoraProviderError } from "./providers/base.js";
7
+ export type { LumoraProvider } from "./providers/base.js";
8
+ export type { LumoraChatRequest, LumoraChatResponse, LumoraMemoryEntry, LumoraMessage, LumoraProviderName, LumoraRole, LumoraStreamChunk, LumoraTool, LumoraToolCall } from "./types/chat.js";
9
+ export type { LumoraAssistant, LumoraAssistantConfig, LumoraKnowledgeSource, LumoraKnowledgeSourceType } from "./types/training.js";
10
+ export type { LumoraGameCharacter, LumoraGameContext, LumoraNpcDialogueRequest, LumoraQuestRequest } from "./types/game.js";
11
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC5D,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,cAAc,EACf,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,EAC1B,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC"}
@@ -0,0 +1,6 @@
1
+ export { createLumoraClient, LumoraSDK } from "./client.js";
2
+ export { OpenAIProvider } from "./providers/openai.js";
3
+ export { XAIProvider } from "./providers/xai.js";
4
+ export { GeminiProvider } from "./providers/gemini.js";
5
+ export { LumoraProviderError } from "./providers/base.js";
6
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG5D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}
@@ -0,0 +1,14 @@
1
+ import type { LumoraChatRequest, LumoraChatResponse, LumoraProviderName, LumoraStreamChunk } from "../types/chat.js";
2
+ export interface LumoraProvider {
3
+ readonly name: LumoraProviderName;
4
+ readonly defaultModel: string;
5
+ chat(request: LumoraChatRequest): Promise<LumoraChatResponse>;
6
+ streamChat(request: LumoraChatRequest): AsyncIterable<LumoraStreamChunk>;
7
+ }
8
+ export declare class LumoraProviderError extends Error {
9
+ readonly provider: LumoraProviderName;
10
+ readonly status?: number | undefined;
11
+ readonly details?: unknown | undefined;
12
+ constructor(message: string, provider: LumoraProviderName, status?: number | undefined, details?: unknown | undefined);
13
+ }
14
+ //# sourceMappingURL=base.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/providers/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,IAAI,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC9D,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,CAAC,iBAAiB,CAAC,CAAC;CAC1E;AAED,qBAAa,mBAAoB,SAAQ,KAAK;aAG1B,QAAQ,EAAE,kBAAkB;aAC5B,MAAM,CAAC,EAAE,MAAM;aACf,OAAO,CAAC,EAAE,OAAO;gBAHjC,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,OAAO,CAAC,EAAE,OAAO,YAAA;CAKpC"}
@@ -0,0 +1,13 @@
1
+ export class LumoraProviderError extends Error {
2
+ provider;
3
+ status;
4
+ details;
5
+ constructor(message, provider, status, details) {
6
+ super(message);
7
+ this.provider = provider;
8
+ this.status = status;
9
+ this.details = details;
10
+ this.name = "LumoraProviderError";
11
+ }
12
+ }
13
+ //# sourceMappingURL=base.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/providers/base.ts"],"names":[],"mappings":"AAcA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAG1B;IACA;IACA;IAJlB,YACE,OAAe,EACC,QAA4B,EAC5B,MAAe,EACf,OAAiB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,aAAQ,GAAR,QAAQ,CAAoB;QAC5B,WAAM,GAAN,MAAM,CAAS;QACf,YAAO,GAAP,OAAO,CAAU;QAGjC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}
@@ -0,0 +1,18 @@
1
+ import type { LumoraChatRequest, LumoraChatResponse, LumoraStreamChunk } from "../types/chat.js";
2
+ import { type LumoraProvider } from "./base.js";
3
+ interface GeminiProviderOptions {
4
+ apiKey?: string;
5
+ baseUrl?: string;
6
+ defaultModel?: string;
7
+ }
8
+ export declare class GeminiProvider implements LumoraProvider {
9
+ readonly name: "gemini";
10
+ readonly defaultModel: string;
11
+ private readonly apiKey;
12
+ private readonly baseUrl;
13
+ constructor(options?: GeminiProviderOptions);
14
+ chat(request: LumoraChatRequest): Promise<LumoraChatResponse>;
15
+ streamChat(request: LumoraChatRequest): AsyncIterable<LumoraStreamChunk>;
16
+ }
17
+ export {};
18
+ //# sourceMappingURL=gemini.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../../src/providers/gemini.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;IAkB5D,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,CAAC,iBAAiB,CAAC;CAsBhF"}
@@ -0,0 +1,102 @@
1
+ import { requireEnv } from "../env.js";
2
+ import { LumoraProviderError } from "./base.js";
3
+ export class GeminiProvider {
4
+ name = "gemini";
5
+ defaultModel;
6
+ apiKey;
7
+ baseUrl;
8
+ constructor(options = {}) {
9
+ this.apiKey = requireEnv("GEMINI_API_KEY", options.apiKey);
10
+ this.baseUrl = options.baseUrl ?? "https://generativelanguage.googleapis.com/v1beta";
11
+ this.defaultModel = options.defaultModel ?? "gemini-1.5-flash";
12
+ }
13
+ async chat(request) {
14
+ const model = request.model ?? this.defaultModel;
15
+ const response = await fetch(`${this.baseUrl}/models/${model}:generateContent?key=${this.apiKey}`, {
16
+ method: "POST",
17
+ headers: { "Content-Type": "application/json" },
18
+ body: JSON.stringify(toGeminiRequest(request))
19
+ });
20
+ const json = await readJson(response, this.name);
21
+ return {
22
+ provider: this.name,
23
+ model,
24
+ text: json.candidates?.[0]?.content?.parts?.map((part) => part.text ?? "").join("") ?? "",
25
+ raw: json
26
+ };
27
+ }
28
+ async *streamChat(request) {
29
+ const model = request.model ?? this.defaultModel;
30
+ const response = await fetch(`${this.baseUrl}/models/${model}:streamGenerateContent?alt=sse&key=${this.apiKey}`, {
31
+ method: "POST",
32
+ headers: { "Content-Type": "application/json" },
33
+ body: JSON.stringify(toGeminiRequest(request))
34
+ });
35
+ if (!response.ok || !response.body) {
36
+ throw new LumoraProviderError("Gemini streaming request failed.", this.name, response.status, await response.text());
37
+ }
38
+ for await (const event of streamServerSentEvents(response.body)) {
39
+ const json = safeJson(event);
40
+ const text = json.candidates?.[0]?.content?.parts?.map((part) => part.text ?? "").join("") ?? "";
41
+ if (text) {
42
+ yield { provider: this.name, model, text, done: false, raw: json };
43
+ }
44
+ }
45
+ yield { provider: this.name, model, text: "", done: true };
46
+ }
47
+ }
48
+ function toGeminiRequest(request) {
49
+ const systemMessages = request.messages.filter((message) => message.role === "system");
50
+ const chatMessages = request.messages.filter((message) => message.role !== "system");
51
+ return {
52
+ systemInstruction: systemMessages.length
53
+ ? { parts: systemMessages.map((message) => ({ text: message.content })) }
54
+ : undefined,
55
+ contents: chatMessages.map((message) => ({
56
+ role: message.role === "assistant" ? "model" : "user",
57
+ parts: [{ text: message.content }]
58
+ })),
59
+ generationConfig: {
60
+ temperature: request.temperature,
61
+ maxOutputTokens: request.maxTokens
62
+ }
63
+ };
64
+ }
65
+ async function readJson(response, provider) {
66
+ const json = await response.json().catch(() => undefined);
67
+ if (!response.ok) {
68
+ throw new LumoraProviderError("Gemini request failed.", provider, response.status, json);
69
+ }
70
+ return json;
71
+ }
72
+ function safeJson(value) {
73
+ if (!value) {
74
+ return {};
75
+ }
76
+ try {
77
+ return JSON.parse(value);
78
+ }
79
+ catch {
80
+ return {};
81
+ }
82
+ }
83
+ async function* streamServerSentEvents(stream) {
84
+ const reader = stream.getReader();
85
+ const decoder = new TextDecoder();
86
+ let buffer = "";
87
+ while (true) {
88
+ const { done, value } = await reader.read();
89
+ if (done) {
90
+ return;
91
+ }
92
+ buffer += decoder.decode(value, { stream: true });
93
+ const lines = buffer.split("\n");
94
+ buffer = lines.pop() ?? "";
95
+ for (const line of lines) {
96
+ if (line.startsWith("data: ")) {
97
+ yield line.slice(6).trim();
98
+ }
99
+ }
100
+ }
101
+ }
102
+ //# sourceMappingURL=gemini.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gemini.js","sourceRoot":"","sources":["../../../src/providers/gemini.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ import type { LumoraChatRequest, LumoraChatResponse, LumoraStreamChunk } from "../types/chat.js";
2
+ import { type LumoraProvider } from "./base.js";
3
+ interface OpenAIProviderOptions {
4
+ apiKey?: string;
5
+ baseUrl?: string;
6
+ defaultModel?: string;
7
+ }
8
+ export declare class OpenAIProvider implements LumoraProvider {
9
+ readonly name: "openai";
10
+ readonly defaultModel: string;
11
+ private readonly apiKey;
12
+ private readonly baseUrl;
13
+ constructor(options?: OpenAIProviderOptions);
14
+ chat(request: LumoraChatRequest): Promise<LumoraChatResponse>;
15
+ streamChat(request: LumoraChatRequest): AsyncIterable<LumoraStreamChunk>;
16
+ private headers;
17
+ }
18
+ export {};
19
+ //# sourceMappingURL=openai.d.ts.map