lazlo-ai 1.0.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 (126) hide show
  1. package/.env.example +9 -0
  2. package/README.md +278 -0
  3. package/dist/cache/semantic.d.ts +39 -0
  4. package/dist/cache/semantic.d.ts.map +1 -0
  5. package/dist/cache/semantic.js +134 -0
  6. package/dist/cache/semantic.js.map +1 -0
  7. package/dist/chains/llmchain.d.ts +65 -0
  8. package/dist/chains/llmchain.d.ts.map +1 -0
  9. package/dist/chains/llmchain.js +137 -0
  10. package/dist/chains/llmchain.js.map +1 -0
  11. package/dist/chains/rag.d.ts +23 -0
  12. package/dist/chains/rag.d.ts.map +1 -0
  13. package/dist/chains/rag.js +47 -0
  14. package/dist/chains/rag.js.map +1 -0
  15. package/dist/core/types.d.ts +130 -0
  16. package/dist/core/types.d.ts.map +1 -0
  17. package/dist/core/types.js +8 -0
  18. package/dist/core/types.js.map +1 -0
  19. package/dist/document_loaders/index.d.ts +61 -0
  20. package/dist/document_loaders/index.d.ts.map +1 -0
  21. package/dist/document_loaders/index.js +183 -0
  22. package/dist/document_loaders/index.js.map +1 -0
  23. package/dist/embeddings/google.d.ts +43 -0
  24. package/dist/embeddings/google.d.ts.map +1 -0
  25. package/dist/embeddings/google.js +90 -0
  26. package/dist/embeddings/google.js.map +1 -0
  27. package/dist/embeddings/local.d.ts +64 -0
  28. package/dist/embeddings/local.d.ts.map +1 -0
  29. package/dist/embeddings/local.js +95 -0
  30. package/dist/embeddings/local.js.map +1 -0
  31. package/dist/evals/judge.d.ts +22 -0
  32. package/dist/evals/judge.d.ts.map +1 -0
  33. package/dist/evals/judge.js +77 -0
  34. package/dist/evals/judge.js.map +1 -0
  35. package/dist/index.d.ts +28 -0
  36. package/dist/index.d.ts.map +1 -0
  37. package/dist/index.js +84 -0
  38. package/dist/index.js.map +1 -0
  39. package/dist/memory/buffer.d.ts +64 -0
  40. package/dist/memory/buffer.d.ts.map +1 -0
  41. package/dist/memory/buffer.js +168 -0
  42. package/dist/memory/buffer.js.map +1 -0
  43. package/dist/parsers/output.d.ts +64 -0
  44. package/dist/parsers/output.d.ts.map +1 -0
  45. package/dist/parsers/output.js +148 -0
  46. package/dist/parsers/output.js.map +1 -0
  47. package/dist/prompts/registry.d.ts +65 -0
  48. package/dist/prompts/registry.d.ts.map +1 -0
  49. package/dist/prompts/registry.js +170 -0
  50. package/dist/prompts/registry.js.map +1 -0
  51. package/dist/providers/ollama.d.ts +30 -0
  52. package/dist/providers/ollama.d.ts.map +1 -0
  53. package/dist/providers/ollama.js +104 -0
  54. package/dist/providers/ollama.js.map +1 -0
  55. package/dist/providers/openai.d.ts +46 -0
  56. package/dist/providers/openai.d.ts.map +1 -0
  57. package/dist/providers/openai.js +228 -0
  58. package/dist/providers/openai.js.map +1 -0
  59. package/dist/retrievers/index.d.ts +71 -0
  60. package/dist/retrievers/index.d.ts.map +1 -0
  61. package/dist/retrievers/index.js +130 -0
  62. package/dist/retrievers/index.js.map +1 -0
  63. package/dist/router/smartrouter.d.ts +36 -0
  64. package/dist/router/smartrouter.d.ts.map +1 -0
  65. package/dist/router/smartrouter.js +132 -0
  66. package/dist/router/smartrouter.js.map +1 -0
  67. package/dist/text_splitters/index.d.ts +28 -0
  68. package/dist/text_splitters/index.d.ts.map +1 -0
  69. package/dist/text_splitters/index.js +109 -0
  70. package/dist/text_splitters/index.js.map +1 -0
  71. package/dist/tools/decorator.d.ts +26 -0
  72. package/dist/tools/decorator.d.ts.map +1 -0
  73. package/dist/tools/decorator.js +102 -0
  74. package/dist/tools/decorator.js.map +1 -0
  75. package/dist/tools/index.d.ts +7 -0
  76. package/dist/tools/index.d.ts.map +1 -0
  77. package/dist/tools/index.js +6 -0
  78. package/dist/tools/index.js.map +1 -0
  79. package/dist/tools/keiro.d.ts +20 -0
  80. package/dist/tools/keiro.d.ts.map +1 -0
  81. package/dist/tools/keiro.js +67 -0
  82. package/dist/tools/keiro.js.map +1 -0
  83. package/dist/tracing/tracer.d.ts +56 -0
  84. package/dist/tracing/tracer.d.ts.map +1 -0
  85. package/dist/tracing/tracer.js +125 -0
  86. package/dist/tracing/tracer.js.map +1 -0
  87. package/dist/utils/logger.d.ts +25 -0
  88. package/dist/utils/logger.d.ts.map +1 -0
  89. package/dist/utils/logger.js +50 -0
  90. package/dist/utils/logger.js.map +1 -0
  91. package/dist/utils/pricing.d.ts +31 -0
  92. package/dist/utils/pricing.d.ts.map +1 -0
  93. package/dist/utils/pricing.js +108 -0
  94. package/dist/utils/pricing.js.map +1 -0
  95. package/dist/vectorstores/index.d.ts +62 -0
  96. package/dist/vectorstores/index.d.ts.map +1 -0
  97. package/dist/vectorstores/index.js +244 -0
  98. package/dist/vectorstores/index.js.map +1 -0
  99. package/package.json +48 -0
  100. package/src/cache/semantic.ts +175 -0
  101. package/src/chains/llmchain.ts +194 -0
  102. package/src/chains/rag.ts +65 -0
  103. package/src/core/types.ts +178 -0
  104. package/src/document_loaders/index.ts +223 -0
  105. package/src/embeddings/google.ts +119 -0
  106. package/src/embeddings/local.ts +118 -0
  107. package/src/evals/judge.ts +99 -0
  108. package/src/index.ts +121 -0
  109. package/src/memory/buffer.ts +222 -0
  110. package/src/parsers/output.ts +195 -0
  111. package/src/prompts/registry.ts +205 -0
  112. package/src/providers/ollama.ts +151 -0
  113. package/src/providers/openai.ts +320 -0
  114. package/src/retrievers/index.ts +182 -0
  115. package/src/router/smartrouter.ts +172 -0
  116. package/src/text_splitters/index.ts +145 -0
  117. package/src/tools/decorator.ts +145 -0
  118. package/src/tools/index.ts +7 -0
  119. package/src/tools/keiro.ts +92 -0
  120. package/src/tracing/tracer.ts +178 -0
  121. package/src/utils/logger.ts +62 -0
  122. package/src/utils/pricing.ts +133 -0
  123. package/src/vectorstores/index.ts +338 -0
  124. package/test-full.mjs +552 -0
  125. package/test.mjs +74 -0
  126. package/tsconfig.json +30 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/text_splitters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAM5C,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,GAAE,mBAAwB;IAM7C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAkCjC,cAAc,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE;CAgBlD;AAMD,qBAAa,8BAA+B,SAAQ,qBAAqB;IACvE,OAAO,CAAC,UAAU,CAAW;gBAEjB,OAAO,GAAE,mBAAmB,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;KAAO;IAKzE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAkCjC,OAAO,CAAC,UAAU;CAUnB;AAGD,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,qBAAqB,CAE5F;AAED,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,8BAA8B,CAErG"}
@@ -0,0 +1,109 @@
1
+ /**
2
+ * Text Splitters - Split documents into chunks
3
+ */
4
+ export class CharacterTextSplitter {
5
+ separator;
6
+ chunkSize;
7
+ chunkOverlap;
8
+ constructor(options = {}) {
9
+ this.separator = options.separator ?? '\n\n';
10
+ this.chunkSize = options.chunkSize ?? 1000;
11
+ this.chunkOverlap = options.chunkOverlap ?? 200;
12
+ }
13
+ splitText(text) {
14
+ if (this.chunkSize === 0 || this.chunkSize >= text.length) {
15
+ return [text];
16
+ }
17
+ const splits = text.split(this.separator);
18
+ const chunks = [];
19
+ let currentChunk = [];
20
+ let currentLength = 0;
21
+ for (const split of splits) {
22
+ const splitLen = split.length;
23
+ if (currentLength + splitLen > this.chunkSize && currentChunk.length > 0) {
24
+ chunks.push(currentChunk.join(this.separator));
25
+ // Remove from front until under overlap threshold
26
+ while (currentLength > this.chunkOverlap && currentChunk.length > 0) {
27
+ const removed = currentChunk.shift();
28
+ currentLength -= (removed?.length ?? 0) + this.separator.length;
29
+ }
30
+ }
31
+ currentChunk.push(split);
32
+ currentLength += splitLen + (currentChunk.length > 1 ? this.separator.length : 0);
33
+ }
34
+ if (currentChunk.length > 0) {
35
+ chunks.push(currentChunk.join(this.separator));
36
+ }
37
+ return chunks;
38
+ }
39
+ splitDocuments(documents) {
40
+ const newDocs = [];
41
+ for (const doc of documents) {
42
+ const chunks = this.splitText(doc.pageContent);
43
+ chunks.forEach((chunk, i) => {
44
+ newDocs.push({
45
+ pageContent: chunk,
46
+ metadata: { ...doc.metadata, chunk_id: i },
47
+ });
48
+ });
49
+ }
50
+ return newDocs;
51
+ }
52
+ }
53
+ // ============================================================================
54
+ // Recursive Character Text Splitter
55
+ // ============================================================================
56
+ export class RecursiveCharacterTextSplitter extends CharacterTextSplitter {
57
+ separators;
58
+ constructor(options = {}) {
59
+ super(options);
60
+ this.separators = options.separators ?? ['\n\n', '\n', ' ', ''];
61
+ }
62
+ splitText(text) {
63
+ const finalChunks = [];
64
+ // If text is small enough, return as-is
65
+ if (text.length <= this.chunkSize) {
66
+ return [text];
67
+ }
68
+ // Try each separator in order
69
+ const separator = this.separators[0];
70
+ const splits = text.split(separator);
71
+ for (const split of splits) {
72
+ if (!split.trim())
73
+ continue;
74
+ if (split.length <= this.chunkSize) {
75
+ finalChunks.push(split);
76
+ }
77
+ else if (this.separators.length > 1) {
78
+ // Recursively split with next separator
79
+ const nextSplitter = new RecursiveCharacterTextSplitter({
80
+ separators: this.separators.slice(1),
81
+ chunkSize: this.chunkSize,
82
+ chunkOverlap: this.chunkOverlap,
83
+ });
84
+ finalChunks.push(...nextSplitter.splitText(split));
85
+ }
86
+ else {
87
+ // Last resort - force split
88
+ finalChunks.push(...this.forceSplit(split));
89
+ }
90
+ }
91
+ return finalChunks;
92
+ }
93
+ forceSplit(text) {
94
+ const chunks = [];
95
+ const chunkSize = this.chunkSize;
96
+ for (let i = 0; i < text.length; i += chunkSize) {
97
+ chunks.push(text.slice(i, i + chunkSize));
98
+ }
99
+ return chunks;
100
+ }
101
+ }
102
+ // Factory helpers
103
+ export function createCharacterSplitter(options) {
104
+ return new CharacterTextSplitter(options);
105
+ }
106
+ export function createRecursiveSplitter(options) {
107
+ return new RecursiveCharacterTextSplitter(options);
108
+ }
109
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/text_splitters/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,26 @@
1
+ /**
2
+ * Tool Decorator - Turn functions into Lazlo tools
3
+ */
4
+ import { BaseTool } from '../core/types.js';
5
+ export interface ToolOptions {
6
+ name?: string;
7
+ description?: string;
8
+ argsSchema?: Record<string, unknown>;
9
+ }
10
+ export declare class Tool implements BaseTool {
11
+ name: string;
12
+ description: string;
13
+ argsSchema?: Record<string, unknown>;
14
+ private func;
15
+ constructor(func: Function, options?: ToolOptions);
16
+ invoke(input: string | Record<string, unknown>): Promise<string>;
17
+ toJSON(): Record<string, unknown>;
18
+ }
19
+ export declare function createToolDecorator(options?: ToolOptions): (func: Function) => Tool;
20
+ export declare const tool: (func: Function) => Tool;
21
+ export declare const toolWithOptions: typeof createToolDecorator;
22
+ export declare function defineTool(func: Function, name: string, description: string, argsSchema?: Record<string, unknown>): Tool;
23
+ export declare const calculator: Tool;
24
+ export declare const search: Tool;
25
+ export declare const weather: Tool;
26
+ //# sourceMappingURL=decorator.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"decorator.d.ts","sourceRoot":"","sources":["../../src/tools/decorator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAO5C,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,qBAAa,IAAK,YAAW,QAAQ;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAW;gBAEX,IAAI,EAAE,QAAQ,EAAE,OAAO,GAAE,WAAgB;IAO/C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAsBtE,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAUlC;AAMD,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,WAAW,IACvC,MAAM,QAAQ,KAAG,IAAI,CAGtC;AAGD,eAAO,MAAM,IAAI,SANO,QAAQ,KAAG,IAMM,CAAC;AAG1C,eAAO,MAAM,eAAe,4BAAsB,CAAC;AAMnD,wBAAgB,UAAU,CACxB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,IAAI,CAEN;AAOD,eAAO,MAAM,UAAU,MAkBtB,CAAC;AAGF,eAAO,MAAM,MAAM,MAWlB,CAAC;AAGF,eAAO,MAAM,OAAO,MAWnB,CAAC"}
@@ -0,0 +1,102 @@
1
+ /**
2
+ * Tool Decorator - Turn functions into Lazlo tools
3
+ */
4
+ import { logger } from '../utils/logger.js';
5
+ export class Tool {
6
+ name;
7
+ description;
8
+ argsSchema;
9
+ func;
10
+ constructor(func, options = {}) {
11
+ this.func = func;
12
+ this.name = options.name ?? func.name ?? 'unnamed_tool';
13
+ this.description = options.description ?? func.toString().slice(0, 100) ?? '';
14
+ this.argsSchema = options.argsSchema;
15
+ }
16
+ async invoke(input) {
17
+ try {
18
+ let args;
19
+ if (typeof input === 'string') {
20
+ try {
21
+ args = JSON.parse(input);
22
+ }
23
+ catch {
24
+ args = { input };
25
+ }
26
+ }
27
+ else {
28
+ args = input;
29
+ }
30
+ const result = await this.func(args);
31
+ return typeof result === 'string' ? result : JSON.stringify(result);
32
+ }
33
+ catch (error) {
34
+ logger.error(`Tool ${this.name} failed:`, error);
35
+ return `Error: ${error}`;
36
+ }
37
+ }
38
+ toJSON() {
39
+ return {
40
+ name: this.name,
41
+ description: this.description,
42
+ parameters: this.argsSchema ?? {
43
+ type: 'object',
44
+ properties: {},
45
+ },
46
+ };
47
+ }
48
+ }
49
+ // ============================================================================
50
+ // Tool Decorator Factory
51
+ // ============================================================================
52
+ export function createToolDecorator(options) {
53
+ return function (func) {
54
+ return new Tool(func, options);
55
+ };
56
+ }
57
+ // Shorthand: @tool
58
+ export const tool = createToolDecorator();
59
+ // With options: @tool({ name: 'calc', description: '...' })
60
+ export const toolWithOptions = createToolDecorator;
61
+ // ============================================================================
62
+ // Create Tool Helper
63
+ // ============================================================================
64
+ export function defineTool(func, name, description, argsSchema) {
65
+ return new Tool(func, { name, description, argsSchema });
66
+ }
67
+ // ============================================================================
68
+ // Example Tools
69
+ // ============================================================================
70
+ // Calculator
71
+ export const calculator = defineTool((args) => {
72
+ try {
73
+ const result = Function(`"use strict"; return (${args.expression})`)();
74
+ return String(result);
75
+ }
76
+ catch (e) {
77
+ return `Error: ${e}`;
78
+ }
79
+ }, 'calculator', 'Perform a mathematical calculation', {
80
+ type: 'object',
81
+ properties: {
82
+ expression: { type: 'string', description: 'Mathematical expression' },
83
+ },
84
+ required: ['expression'],
85
+ });
86
+ // Search
87
+ export const search = defineTool((args) => `Search results for "${args.query}"`, 'search', 'Search the web', {
88
+ type: 'object',
89
+ properties: {
90
+ query: { type: 'string', description: 'Search query' },
91
+ },
92
+ required: ['query'],
93
+ });
94
+ // Weather
95
+ export const weather = defineTool((args) => `Weather for ${args.location}: Sunny, 72°F`, 'weather', 'Get weather info', {
96
+ type: 'object',
97
+ properties: {
98
+ location: { type: 'string', description: 'City name' },
99
+ },
100
+ required: ['location'],
101
+ });
102
+ //# sourceMappingURL=decorator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"decorator.js","sourceRoot":"","sources":["../../src/tools/decorator.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Tools - Function calling for LLM agents
3
+ */
4
+ export { Tool, tool, createToolDecorator, defineTool, calculator, search, weather } from './decorator.js';
5
+ export { KeiroSearch } from './keiro.js';
6
+ export type { ToolOptions } from './decorator.js';
7
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,mBAAmB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC1G,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Tools - Function calling for LLM agents
3
+ */
4
+ export { Tool, tool, createToolDecorator, defineTool, calculator, search, weather } from './decorator.js';
5
+ export { KeiroSearch } from './keiro.js';
6
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,mBAAmB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC1G,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}
@@ -0,0 +1,20 @@
1
+ /**
2
+ * Keiro Search - Web search tool for LLM agents
3
+ */
4
+ import { BaseTool } from '../core/types.js';
5
+ export interface KeiroSearchOptions {
6
+ apiKey?: string;
7
+ cacheSearch?: boolean;
8
+ }
9
+ export declare class KeiroSearch implements BaseTool {
10
+ name: string;
11
+ description: string;
12
+ private client;
13
+ private apiKey?;
14
+ private cacheSearch;
15
+ constructor(options?: KeiroSearchOptions);
16
+ private parseInput;
17
+ invoke(input: string | Record<string, unknown>): Promise<string>;
18
+ ainvoke(input: string | Record<string, unknown>): Promise<string>;
19
+ }
20
+ //# sourceMappingURL=keiro.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"keiro.d.ts","sourceRoot":"","sources":["../../src/tools/keiro.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAO5C,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,qBAAa,WAAY,YAAW,QAAQ;IAC1C,IAAI,SAAkB;IACtB,WAAW,SAA8K;IAEzL,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,WAAW,CAAU;gBAEjB,OAAO,GAAE,kBAAuB;IAe5C,OAAO,CAAC,UAAU;IAYZ,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAoChE,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CAGxE"}
@@ -0,0 +1,67 @@
1
+ /**
2
+ * Keiro Search - Web search tool for LLM agents
3
+ */
4
+ import axios from 'axios';
5
+ import { logger } from '../utils/logger.js';
6
+ export class KeiroSearch {
7
+ name = 'keiro_search';
8
+ description = 'A powerful web search engine. Use this to find current events, up-to-date information, or if you do not know the answer. Input should be a specific search query string.';
9
+ client;
10
+ apiKey;
11
+ cacheSearch;
12
+ constructor(options = {}) {
13
+ this.apiKey = options.apiKey ?? process.env.KEIRO_API_KEY;
14
+ this.cacheSearch = options.cacheSearch ?? true;
15
+ this.client = axios.create({
16
+ baseURL: 'https://kierolabs.space/api',
17
+ timeout: 30000,
18
+ headers: {
19
+ 'Content-Type': 'application/json',
20
+ },
21
+ });
22
+ logger.info('KeiroSearch tool initialized.');
23
+ }
24
+ parseInput(input) {
25
+ if (typeof input === 'string') {
26
+ return input;
27
+ }
28
+ // If it's an object with a query field, use that
29
+ if ('query' in input && typeof input.query === 'string') {
30
+ return input.query;
31
+ }
32
+ // Otherwise stringify
33
+ return JSON.stringify(input);
34
+ }
35
+ async invoke(input) {
36
+ const query = this.parseInput(input);
37
+ logger.debug(`KeiroSearch: "${query}"`);
38
+ try {
39
+ const response = await this.client.post('/search-pro', {
40
+ apiKey: this.apiKey,
41
+ query,
42
+ cache_search: this.cacheSearch,
43
+ });
44
+ const results = response.data.results ?? [];
45
+ const answer = response.data.answer;
46
+ if (answer) {
47
+ return answer;
48
+ }
49
+ if (results.length === 0) {
50
+ return 'No search results found.';
51
+ }
52
+ // Format results
53
+ const formatted = results.slice(0, 5).map((r, i) => {
54
+ return `${i + 1}. ${r.title}\n ${r.url}\n ${r.content?.slice(0, 200) ?? ''}`;
55
+ }).join('\n\n');
56
+ return `Search results for "${query}":\n\n${formatted}`;
57
+ }
58
+ catch (error) {
59
+ logger.error(`KeiroSearch error: ${error.message}`);
60
+ return `Error searching the web: ${error.message}`;
61
+ }
62
+ }
63
+ async ainvoke(input) {
64
+ return this.invoke(input);
65
+ }
66
+ }
67
+ //# sourceMappingURL=keiro.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"keiro.js","sourceRoot":"","sources":["../../src/tools/keiro.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,56 @@
1
+ /**
2
+ * Tracing - Built-in observability without SaaS
3
+ */
4
+ export interface SpanData {
5
+ name: string;
6
+ type: string;
7
+ durationMs: number;
8
+ tokensIn: number;
9
+ tokensOut: number;
10
+ costUsd: number;
11
+ error?: string;
12
+ metadata?: Record<string, unknown>;
13
+ }
14
+ declare class Span {
15
+ name: string;
16
+ type: string;
17
+ startTime: number;
18
+ endTime?: number;
19
+ tokensIn: number;
20
+ tokensOut: number;
21
+ metadata: Record<string, unknown>;
22
+ error?: string;
23
+ constructor(name: string, type?: string);
24
+ finish(): void;
25
+ get durationMs(): number;
26
+ get costUsd(): number;
27
+ toDict(): SpanData;
28
+ }
29
+ export declare class Tracer {
30
+ private runs;
31
+ private currentRunName?;
32
+ private currentSpans;
33
+ /**
34
+ * Start a trace context
35
+ */
36
+ trace(runName: string): {
37
+ tracer: Tracer;
38
+ span: (name: string, type?: string) => Span;
39
+ end: () => void;
40
+ };
41
+ /**
42
+ * Record an event/span
43
+ */
44
+ event(name: string, type?: string, tokensIn?: number, tokensOut?: number, metadata?: Record<string, unknown>): void;
45
+ /**
46
+ * Print trace summary
47
+ */
48
+ printSummary(): void;
49
+ /**
50
+ * Clear all traces
51
+ */
52
+ clear(): void;
53
+ }
54
+ export declare const tracer: Tracer;
55
+ export {};
56
+ //# sourceMappingURL=tracer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../src/tracing/tracer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,cAAM,IAAI;IACR,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,SAAK;IACb,SAAS,SAAK;IACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;gBAEH,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAc;IAM9C,MAAM,IAAI,IAAI;IAId,IAAI,UAAU,IAAI,MAAM,CAGvB;IAED,IAAI,OAAO,IAAI,MAAM,CAGpB;IAED,MAAM,IAAI,QAAQ;CAYnB;AAeD,qBAAa,MAAM;IACjB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,YAAY,CAAc;IAElC;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,GAAG,EAAE,MAAM,IAAI,CAAA;KAAE;IAkCxG;;OAEG;IACH,KAAK,CACH,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAc,EACpB,QAAQ,GAAE,MAAU,EACpB,SAAS,GAAE,MAAU,EACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI;IASP;;OAEG;IACH,YAAY,IAAI,IAAI;IA0BpB;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAGD,eAAO,MAAM,MAAM,QAAe,CAAC"}
@@ -0,0 +1,125 @@
1
+ /**
2
+ * Tracing - Built-in observability without SaaS
3
+ */
4
+ import { logger } from '../utils/logger.js';
5
+ class Span {
6
+ name;
7
+ type;
8
+ startTime;
9
+ endTime;
10
+ tokensIn = 0;
11
+ tokensOut = 0;
12
+ metadata = {};
13
+ error;
14
+ constructor(name, type = 'llm') {
15
+ this.name = name;
16
+ this.type = type;
17
+ this.startTime = Date.now();
18
+ }
19
+ finish() {
20
+ this.endTime = Date.now();
21
+ }
22
+ get durationMs() {
23
+ if (!this.endTime)
24
+ return 0;
25
+ return this.endTime - this.startTime;
26
+ }
27
+ get costUsd() {
28
+ const rate = this.type === 'llm' ? 0.002 : 0;
29
+ return ((this.tokensIn + this.tokensOut) / 1000) * rate;
30
+ }
31
+ toDict() {
32
+ return {
33
+ name: this.name,
34
+ type: this.type,
35
+ durationMs: this.durationMs,
36
+ tokensIn: this.tokensIn,
37
+ tokensOut: this.tokensOut,
38
+ costUsd: this.costUsd,
39
+ error: this.error,
40
+ metadata: this.metadata,
41
+ };
42
+ }
43
+ }
44
+ export class Tracer {
45
+ runs = [];
46
+ currentRunName;
47
+ currentSpans = [];
48
+ /**
49
+ * Start a trace context
50
+ */
51
+ trace(runName) {
52
+ this.currentRunName = runName;
53
+ this.currentSpans = [];
54
+ const runStart = Date.now();
55
+ logger.info(`[Tracer] Run '${runName}' started.`);
56
+ return {
57
+ tracer: this,
58
+ span: (name, type = 'llm') => {
59
+ const s = new Span(name, type);
60
+ this.currentSpans.push(s);
61
+ return s;
62
+ },
63
+ end: () => {
64
+ const runEnd = Date.now();
65
+ const runDuration = runEnd - runStart;
66
+ const totalCost = this.currentSpans.reduce((sum, s) => sum + s.costUsd, 0);
67
+ const totalTokens = this.currentSpans.reduce((sum, s) => sum + s.tokensIn + s.tokensOut, 0);
68
+ this.runs.push({
69
+ name: runName,
70
+ correlationId: Math.random().toString(36).slice(2, 10),
71
+ totalDurationMs: runDuration,
72
+ totalTokens,
73
+ totalCostUsd: totalCost,
74
+ spans: this.currentSpans.map(s => s.toDict()),
75
+ });
76
+ logger.info(`[Tracer] Run '${runName}' finished in ${runDuration}ms. Est. cost: $${totalCost.toFixed(5)}`);
77
+ },
78
+ };
79
+ }
80
+ /**
81
+ * Record an event/span
82
+ */
83
+ event(name, type = 'llm', tokensIn = 0, tokensOut = 0, metadata) {
84
+ const span = new Span(name, type);
85
+ span.tokensIn = tokensIn;
86
+ span.tokensOut = tokensOut;
87
+ span.metadata = metadata ?? {};
88
+ span.finish();
89
+ this.currentSpans.push(span);
90
+ }
91
+ /**
92
+ * Print trace summary
93
+ */
94
+ printSummary() {
95
+ if (this.runs.length === 0) {
96
+ console.log('No traces recorded yet.');
97
+ return;
98
+ }
99
+ for (const run of this.runs) {
100
+ console.log(`\n${'='.repeat(70)}`);
101
+ console.log(` Lazlo Trace: ${run.name}`);
102
+ console.log(` Total: ${run.totalDurationMs}ms | ~${run.totalTokens.toLocaleString()} tokens | Est. $${run.totalCostUsd.toFixed(5)}`);
103
+ console.log(`${'='.repeat(70)}`);
104
+ console.log(` ${'Step'.padEnd(28)} ${'Type'.padEnd(12)} ${'ms'.padStart(8)} ${'Tok-In'.padStart(8)} ${'Tok-Out'.padStart(8)} ${'Cost'.padStart(10)}`);
105
+ console.log(` ${'-'.repeat(68)}`);
106
+ for (const s of run.spans) {
107
+ const status = s.error ? '❌' : '✓';
108
+ console.log(` ${status} ${s.name.slice(0, 26).padEnd(28)} ${s.type.padEnd(12)} ` +
109
+ `${s.durationMs.toString().padStart(7)}ms ${s.tokensIn.toString().padStart(8)} ` +
110
+ `${s.tokensOut.toString().padStart(8)} $${s.costUsd.toFixed(5).padStart(9)}`);
111
+ }
112
+ console.log(`${'='.repeat(70)}\n`);
113
+ }
114
+ }
115
+ /**
116
+ * Clear all traces
117
+ */
118
+ clear() {
119
+ this.runs = [];
120
+ this.currentSpans = [];
121
+ }
122
+ }
123
+ // Singleton instance
124
+ export const tracer = new Tracer();
125
+ //# sourceMappingURL=tracer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tracer.js","sourceRoot":"","sources":["../../src/tracing/tracer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,25 @@
1
+ /**
2
+ * Lazlo Logger - Simple, structured logging
3
+ */
4
+ export declare enum LogLevel {
5
+ DEBUG = 0,
6
+ INFO = 1,
7
+ WARN = 2,
8
+ ERROR = 3
9
+ }
10
+ declare class Logger {
11
+ private level;
12
+ private prefix;
13
+ constructor(prefix?: string);
14
+ setLevel(level: LogLevel): void;
15
+ setPrefix(prefix: string): void;
16
+ private log;
17
+ debug(...args: unknown[]): void;
18
+ info(...args: unknown[]): void;
19
+ warn(...args: unknown[]): void;
20
+ error(...args: unknown[]): void;
21
+ }
22
+ export declare const logger: Logger;
23
+ export declare function createLogger(prefix: string): Logger;
24
+ export {};
25
+ //# sourceMappingURL=logger.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACV;AAID,cAAM,MAAM;IACV,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,GAAE,MAAW;IAI/B,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,OAAO,CAAC,GAAG;IAUX,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI9B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI9B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAGhC;AAED,eAAO,MAAM,MAAM,QAAsB,CAAC;AAG1C,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD"}