@agentionai/agents 0.12.0-beta → 0.13.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 (46) hide show
  1. package/README.md +63 -7
  2. package/dist/agents/Agent.d.ts +15 -3
  3. package/dist/agents/Agent.js +8 -0
  4. package/dist/agents/AgentConfig.d.ts +38 -2
  5. package/dist/agents/anthropic/ClaudeAgent.d.ts +19 -1
  6. package/dist/agents/anthropic/ClaudeAgent.js +27 -8
  7. package/dist/agents/llamacpp/LlamaCppAgent.d.ts +60 -0
  8. package/dist/agents/llamacpp/LlamaCppAgent.js +262 -0
  9. package/dist/agents/model-types.d.ts +14 -1
  10. package/dist/agents/ollama/OllamaAgent.d.ts +91 -0
  11. package/dist/agents/ollama/OllamaAgent.js +317 -0
  12. package/dist/chunkers/index.d.ts +0 -1
  13. package/dist/chunkers/index.js +1 -3
  14. package/dist/core.d.ts +1 -0
  15. package/dist/core.js +1 -0
  16. package/dist/history/transformers.d.ts +100 -0
  17. package/dist/history/transformers.js +195 -1
  18. package/dist/history/types.d.ts +15 -1
  19. package/dist/index.d.ts +4 -1
  20. package/dist/index.js +8 -1
  21. package/dist/ingestion/IngestionPipeline.d.ts +1 -73
  22. package/dist/ingestion/IngestionPipeline.js +1 -110
  23. package/dist/llamacpp.d.ts +4 -0
  24. package/dist/llamacpp.js +24 -0
  25. package/dist/ollama.d.ts +4 -0
  26. package/dist/ollama.js +24 -0
  27. package/dist/tools/BuiltInTool.d.ts +72 -0
  28. package/dist/tools/BuiltInTool.js +53 -0
  29. package/dist/viz/types.d.ts +1 -1
  30. package/package.json +10 -42
  31. package/dist/chunkers/ElementChunker.d.ts +0 -100
  32. package/dist/chunkers/ElementChunker.js +0 -242
  33. package/dist/parsers/DocumentParser.d.ts +0 -36
  34. package/dist/parsers/DocumentParser.js +0 -35
  35. package/dist/parsers/LlamaIndexParser.d.ts +0 -58
  36. package/dist/parsers/LlamaIndexParser.js +0 -71
  37. package/dist/parsers/OllamaOCRParser.d.ts +0 -98
  38. package/dist/parsers/OllamaOCRParser.js +0 -203
  39. package/dist/parsers/UnstructuredAPIParser.d.ts +0 -57
  40. package/dist/parsers/UnstructuredAPIParser.js +0 -131
  41. package/dist/parsers/UnstructuredLocalParser.d.ts +0 -42
  42. package/dist/parsers/UnstructuredLocalParser.js +0 -118
  43. package/dist/parsers/index.d.ts +0 -3
  44. package/dist/parsers/index.js +0 -6
  45. package/dist/parsers/types.d.ts +0 -50
  46. package/dist/parsers/types.js +0 -3
@@ -87,10 +87,24 @@ export type MistralMeta = {
87
87
  export type GeminiMeta = {
88
88
  provider: "gemini";
89
89
  };
90
+ /**
91
+ * Ollama-specific metadata
92
+ */
93
+ export type OllamaMeta = {
94
+ provider: "ollama";
95
+ tool_call_id?: string;
96
+ };
97
+ /**
98
+ * llama.cpp-specific metadata
99
+ */
100
+ export type LlamaCppMeta = {
101
+ provider: "llamacpp";
102
+ tool_call_id?: string;
103
+ };
90
104
  /**
91
105
  * Union of all provider metadata types
92
106
  */
93
- export type ProviderMeta = AnthropicMeta | OpenAiMeta | MistralMeta | GeminiMeta;
107
+ export type ProviderMeta = AnthropicMeta | OpenAiMeta | MistralMeta | GeminiMeta | OllamaMeta | LlamaCppMeta;
94
108
  /**
95
109
  * Valid roles for history entries
96
110
  */
package/dist/index.d.ts CHANGED
@@ -3,15 +3,18 @@ export * from "./agents/anthropic/ClaudeAgent";
3
3
  export { OpenAiAgent } from "./agents/openai/OpenAiAgent";
4
4
  export { MistralAgent } from "./agents/mistral/MistralAgent";
5
5
  export { GeminiAgent } from "./agents/google/GeminiAgent";
6
+ export { OllamaAgent } from "./agents/ollama/OllamaAgent";
7
+ export { LlamaCppAgent } from "./agents/llamacpp/LlamaCppAgent";
6
8
  export * from "./agents/model-types";
7
9
  export * from "./agents/AgentConfig";
8
10
  export * from "./agents/AgentEvent";
9
11
  export * from "./agents/errors/AgentError";
10
12
  export * from "./history/History";
11
13
  export * from "./history/types";
12
- export { anthropicTransformer, openAiTransformer, mistralTransformer, geminiTransformer, } from "./history/transformers";
14
+ export { anthropicTransformer, openAiTransformer, mistralTransformer, geminiTransformer, ollamaTransformer, chatCompletionsTransformer, } from "./history/transformers";
13
15
  export * from "./graph/AgentGraph";
14
16
  export * from "./tools/Tool";
17
+ export * from "./tools/BuiltInTool";
15
18
  export * from "./mcp";
16
19
  export * from "./viz";
17
20
  export * from "./vectorstore";
package/dist/index.js CHANGED
@@ -22,7 +22,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
22
22
  for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
23
23
  };
24
24
  Object.defineProperty(exports, "__esModule", { value: true });
25
- exports.geminiTransformer = exports.mistralTransformer = exports.openAiTransformer = exports.anthropicTransformer = exports.GeminiAgent = exports.MistralAgent = exports.OpenAiAgent = void 0;
25
+ exports.chatCompletionsTransformer = exports.ollamaTransformer = exports.geminiTransformer = exports.mistralTransformer = exports.openAiTransformer = exports.anthropicTransformer = exports.LlamaCppAgent = exports.OllamaAgent = exports.GeminiAgent = exports.MistralAgent = exports.OpenAiAgent = void 0;
26
26
  // Agents
27
27
  __exportStar(require("./agents/BaseAgent"), exports);
28
28
  __exportStar(require("./agents/anthropic/ClaudeAgent"), exports);
@@ -32,6 +32,10 @@ var MistralAgent_1 = require("./agents/mistral/MistralAgent");
32
32
  Object.defineProperty(exports, "MistralAgent", { enumerable: true, get: function () { return MistralAgent_1.MistralAgent; } });
33
33
  var GeminiAgent_1 = require("./agents/google/GeminiAgent");
34
34
  Object.defineProperty(exports, "GeminiAgent", { enumerable: true, get: function () { return GeminiAgent_1.GeminiAgent; } });
35
+ var OllamaAgent_1 = require("./agents/ollama/OllamaAgent");
36
+ Object.defineProperty(exports, "OllamaAgent", { enumerable: true, get: function () { return OllamaAgent_1.OllamaAgent; } });
37
+ var LlamaCppAgent_1 = require("./agents/llamacpp/LlamaCppAgent");
38
+ Object.defineProperty(exports, "LlamaCppAgent", { enumerable: true, get: function () { return LlamaCppAgent_1.LlamaCppAgent; } });
35
39
  __exportStar(require("./agents/model-types"), exports);
36
40
  __exportStar(require("./agents/AgentConfig"), exports);
37
41
  __exportStar(require("./agents/AgentEvent"), exports);
@@ -44,10 +48,13 @@ Object.defineProperty(exports, "anthropicTransformer", { enumerable: true, get:
44
48
  Object.defineProperty(exports, "openAiTransformer", { enumerable: true, get: function () { return transformers_1.openAiTransformer; } });
45
49
  Object.defineProperty(exports, "mistralTransformer", { enumerable: true, get: function () { return transformers_1.mistralTransformer; } });
46
50
  Object.defineProperty(exports, "geminiTransformer", { enumerable: true, get: function () { return transformers_1.geminiTransformer; } });
51
+ Object.defineProperty(exports, "ollamaTransformer", { enumerable: true, get: function () { return transformers_1.ollamaTransformer; } });
52
+ Object.defineProperty(exports, "chatCompletionsTransformer", { enumerable: true, get: function () { return transformers_1.chatCompletionsTransformer; } });
47
53
  // Graph
48
54
  __exportStar(require("./graph/AgentGraph"), exports);
49
55
  // Tools
50
56
  __exportStar(require("./tools/Tool"), exports);
57
+ __exportStar(require("./tools/BuiltInTool"), exports);
51
58
  // MCP (Model Context Protocol)
52
59
  __exportStar(require("./mcp"), exports);
53
60
  // Visualization
@@ -2,8 +2,6 @@ import { Chunk, ChunkOptions } from "../chunkers/types";
2
2
  import { Chunker } from "../chunkers/Chunker";
3
3
  import { Embeddings } from "../embeddings/Embeddings";
4
4
  import { VectorStore } from "../vectorstore/VectorStore";
5
- import { DocumentParser } from "../parsers/DocumentParser";
6
- import { ParseOptions } from "../parsers/types";
7
5
  import { IngestionOptions, IngestionResult, DocumentInput } from "./types";
8
6
  /**
9
7
  * Pipeline for ingesting documents into a vector store.
@@ -33,15 +31,7 @@ export declare class IngestionPipeline {
33
31
  private chunker;
34
32
  private embeddings;
35
33
  private store;
36
- private parser?;
37
- /**
38
- * @param chunker - Chunker to split parsed/raw text into chunks
39
- * @param embeddings - Embeddings provider
40
- * @param store - Vector store for persistence
41
- * @param parser - Optional default parser used by {@link ingestFile} and
42
- * {@link ingestFiles} when no parser is passed at call time
43
- */
44
- constructor(chunker: Chunker, embeddings: Embeddings, store: VectorStore, parser?: DocumentParser);
34
+ constructor(chunker: Chunker, embeddings: Embeddings, store: VectorStore);
45
35
  /**
46
36
  * Ingest a single document into the vector store.
47
37
  *
@@ -58,64 +48,6 @@ export declare class IngestionPipeline {
58
48
  * @returns Aggregated result of all ingestions
59
49
  */
60
50
  ingestMany(documents: DocumentInput[], options?: IngestionOptions): Promise<IngestionResult>;
61
- /**
62
- * Parse a file and ingest it into the vector store.
63
- *
64
- * Combines parsing + chunking + embedding + storing in a single call.
65
- * When the pipeline's chunker is an {@link ElementChunker} and the parser
66
- * returns structured elements, chunking is done on element boundaries
67
- * instead of raw text.
68
- *
69
- * The `parser` argument is optional when one was configured on the pipeline
70
- * constructor; it is required otherwise.
71
- *
72
- * @example Using a pipeline-level parser:
73
- * ```typescript
74
- * const pipeline = new IngestionPipeline(
75
- * new ElementChunker({ chunkSize: 1000 }),
76
- * embeddings,
77
- * store,
78
- * new UnstructuredLocalParser(),
79
- * );
80
- * await pipeline.ingestFile("/docs/report.pdf", { strategy: "hi_res" });
81
- * ```
82
- *
83
- * @example Passing a parser per call:
84
- * ```typescript
85
- * await pipeline.ingestFile("/docs/report.pdf", new UnstructuredLocalParser(), {
86
- * strategy: "hi_res",
87
- * sourceId: "report-2024",
88
- * });
89
- * ```
90
- */
91
- ingestFile(filePath: string, options?: ParseOptions & ChunkOptions & IngestionOptions): Promise<IngestionResult>;
92
- ingestFile(filePath: string, parser: DocumentParser, options?: ParseOptions & ChunkOptions & IngestionOptions): Promise<IngestionResult>;
93
- /**
94
- * Parse and ingest multiple files.
95
- *
96
- * Files are parsed sequentially; all chunks are batched together for
97
- * embedding and storage. When the pipeline uses an {@link ElementChunker}
98
- * and the parser returns structured elements, element-aware chunking is
99
- * applied per file (preserving `element_types` and `page` metadata).
100
- * The `parser` argument is optional when one was set on the pipeline
101
- * constructor.
102
- *
103
- * @example Using a pipeline-level parser:
104
- * ```typescript
105
- * await pipeline.ingestFiles(["/a.pdf", "/b.docx"], { skipDuplicates: true });
106
- * ```
107
- *
108
- * @example Passing a parser per call:
109
- * ```typescript
110
- * await pipeline.ingestFiles(
111
- * ["/docs/a.pdf", "/docs/b.docx"],
112
- * new UnstructuredAPIParser({ serverUrl: "http://localhost:8000" }),
113
- * { strategy: "auto", skipDuplicates: true }
114
- * );
115
- * ```
116
- */
117
- ingestFiles(filePaths: string[], options?: ParseOptions & ChunkOptions & IngestionOptions): Promise<IngestionResult>;
118
- ingestFiles(filePaths: string[], parser: DocumentParser, options?: ParseOptions & ChunkOptions & IngestionOptions): Promise<IngestionResult>;
119
51
  /**
120
52
  * Ingest pre-chunked data into the vector store.
121
53
  * Useful when chunking is done separately.
@@ -150,9 +82,5 @@ export declare class IngestionPipeline {
150
82
  * Get the vector store used by this pipeline.
151
83
  */
152
84
  getStore(): VectorStore;
153
- /**
154
- * Get the default parser configured on this pipeline, if any.
155
- */
156
- getParser(): DocumentParser | undefined;
157
85
  }
158
86
  //# sourceMappingURL=IngestionPipeline.d.ts.map
@@ -1,7 +1,6 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.IngestionPipeline = void 0;
4
- const ElementChunker_1 = require("../chunkers/ElementChunker");
5
4
  /**
6
5
  * Pipeline for ingesting documents into a vector store.
7
6
  * Orchestrates the flow: chunk → batch embed → store
@@ -27,18 +26,10 @@ const ElementChunker_1 = require("../chunkers/ElementChunker");
27
26
  * ```
28
27
  */
29
28
  class IngestionPipeline {
30
- /**
31
- * @param chunker - Chunker to split parsed/raw text into chunks
32
- * @param embeddings - Embeddings provider
33
- * @param store - Vector store for persistence
34
- * @param parser - Optional default parser used by {@link ingestFile} and
35
- * {@link ingestFiles} when no parser is passed at call time
36
- */
37
- constructor(chunker, embeddings, store, parser) {
29
+ constructor(chunker, embeddings, store) {
38
30
  this.chunker = chunker;
39
31
  this.embeddings = embeddings;
40
32
  this.store = store;
41
- this.parser = parser;
42
33
  }
43
34
  /**
44
35
  * Ingest a single document into the vector store.
@@ -104,100 +95,6 @@ class IngestionPipeline {
104
95
  // Process all chunks together
105
96
  return this.processChunks(allChunks, options ?? {}, startTime);
106
97
  }
107
- async ingestFile(filePath, parserOrOptions, options) {
108
- let parser;
109
- let opts;
110
- if (parserOrOptions != null && typeof parserOrOptions.parse === "function") {
111
- parser = parserOrOptions;
112
- opts = options;
113
- }
114
- else {
115
- parser = this.parser;
116
- opts = parserOrOptions;
117
- }
118
- if (!parser) {
119
- throw new Error("No parser provided. Pass a DocumentParser to ingestFile() or set one in the IngestionPipeline constructor.");
120
- }
121
- const parseOptions = {
122
- strategy: opts?.strategy,
123
- languages: opts?.languages,
124
- };
125
- const parsed = await parser.parse(filePath, parseOptions);
126
- const chunkOptions = {
127
- sourceId: opts?.sourceId,
128
- sourcePath: opts?.sourcePath ?? filePath,
129
- metadata: opts?.metadata,
130
- };
131
- const ingestionOptions = {
132
- batchSize: opts?.batchSize,
133
- onProgress: opts?.onProgress,
134
- onError: opts?.onError,
135
- skipDuplicates: opts?.skipDuplicates,
136
- };
137
- // When the pipeline uses an ElementChunker and the parser returned
138
- // structured elements, chunk on element boundaries instead of raw text.
139
- if (this.chunker instanceof ElementChunker_1.ElementChunker && parsed.elements?.length) {
140
- const startTime = Date.now();
141
- const chunks = await this.chunker.chunkElements(parsed.elements, chunkOptions);
142
- return this.processChunks(chunks, ingestionOptions, startTime);
143
- }
144
- return this.ingest(parsed.text, { ...chunkOptions, ...ingestionOptions });
145
- }
146
- async ingestFiles(filePaths, parserOrOptions, options) {
147
- let parser;
148
- let opts;
149
- if (parserOrOptions != null && typeof parserOrOptions.parse === "function") {
150
- parser = parserOrOptions;
151
- opts = options;
152
- }
153
- else {
154
- parser = this.parser;
155
- opts = parserOrOptions;
156
- }
157
- if (!parser) {
158
- throw new Error("No parser provided. Pass a DocumentParser to ingestFiles() or set one in the IngestionPipeline constructor.");
159
- }
160
- const parseOptions = {
161
- strategy: opts?.strategy,
162
- languages: opts?.languages,
163
- };
164
- const ingestionOptions = {
165
- batchSize: opts?.batchSize,
166
- onProgress: opts?.onProgress,
167
- onError: opts?.onError,
168
- skipDuplicates: opts?.skipDuplicates,
169
- };
170
- const startTime = Date.now();
171
- const allChunks = [];
172
- this.emitProgress(ingestionOptions.onProgress, {
173
- phase: "chunking",
174
- processed: 0,
175
- total: filePaths.length,
176
- });
177
- for (let i = 0; i < filePaths.length; i++) {
178
- const filePath = filePaths[i];
179
- const parsed = await parser.parse(filePath, parseOptions);
180
- const chunkOptions = {
181
- sourceId: opts?.sourceId,
182
- sourcePath: filePath,
183
- metadata: opts?.metadata,
184
- };
185
- let fileChunks;
186
- if (this.chunker instanceof ElementChunker_1.ElementChunker && parsed.elements?.length) {
187
- fileChunks = await this.chunker.chunkElements(parsed.elements, chunkOptions);
188
- }
189
- else {
190
- fileChunks = await this.chunker.chunk(parsed.text, chunkOptions);
191
- }
192
- allChunks.push(...fileChunks);
193
- this.emitProgress(ingestionOptions.onProgress, {
194
- phase: "chunking",
195
- processed: i + 1,
196
- total: filePaths.length,
197
- });
198
- }
199
- return this.processChunks(allChunks, ingestionOptions, startTime);
200
- }
201
98
  /**
202
99
  * Ingest pre-chunked data into the vector store.
203
100
  * Useful when chunking is done separately.
@@ -364,12 +261,6 @@ class IngestionPipeline {
364
261
  getStore() {
365
262
  return this.store;
366
263
  }
367
- /**
368
- * Get the default parser configured on this pipeline, if any.
369
- */
370
- getParser() {
371
- return this.parser;
372
- }
373
264
  }
374
265
  exports.IngestionPipeline = IngestionPipeline;
375
266
  //# sourceMappingURL=IngestionPipeline.js.map
@@ -0,0 +1,4 @@
1
+ export * from "./core";
2
+ export { LlamaCppAgent } from "./agents/llamacpp/LlamaCppAgent";
3
+ export { chatCompletionsTransformer } from "./history/transformers";
4
+ //# sourceMappingURL=llamacpp.d.ts.map
@@ -0,0 +1,24 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ exports.chatCompletionsTransformer = exports.LlamaCppAgent = void 0;
18
+ // llama.cpp Agent Entry Point
19
+ __exportStar(require("./core"), exports);
20
+ var LlamaCppAgent_1 = require("./agents/llamacpp/LlamaCppAgent");
21
+ Object.defineProperty(exports, "LlamaCppAgent", { enumerable: true, get: function () { return LlamaCppAgent_1.LlamaCppAgent; } });
22
+ var transformers_1 = require("./history/transformers");
23
+ Object.defineProperty(exports, "chatCompletionsTransformer", { enumerable: true, get: function () { return transformers_1.chatCompletionsTransformer; } });
24
+ //# sourceMappingURL=llamacpp.js.map
@@ -0,0 +1,4 @@
1
+ export * from "./core";
2
+ export { OllamaAgent } from "./agents/ollama/OllamaAgent";
3
+ export { ollamaTransformer } from "./history/transformers";
4
+ //# sourceMappingURL=ollama.d.ts.map
package/dist/ollama.js ADDED
@@ -0,0 +1,24 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ exports.ollamaTransformer = exports.OllamaAgent = void 0;
18
+ // Ollama Agent Entry Point
19
+ __exportStar(require("./core"), exports);
20
+ var OllamaAgent_1 = require("./agents/ollama/OllamaAgent");
21
+ Object.defineProperty(exports, "OllamaAgent", { enumerable: true, get: function () { return OllamaAgent_1.OllamaAgent; } });
22
+ var transformers_1 = require("./history/transformers");
23
+ Object.defineProperty(exports, "ollamaTransformer", { enumerable: true, get: function () { return transformers_1.ollamaTransformer; } });
24
+ //# sourceMappingURL=ollama.js.map
@@ -0,0 +1,72 @@
1
+ /**
2
+ * Provider-defined ("built-in" / server-side) tools.
3
+ *
4
+ * Unlike `Tool`, these are not executed locally — the provider runs them as
5
+ * part of generating its response (e.g. Anthropic's web search, bash, and
6
+ * text editor tools). They carry no `execute` function or input schema; the
7
+ * agent simply forwards their definition to the provider's API.
8
+ *
9
+ * Pass arbitrary built-in tool definitions straight through — only `type`
10
+ * and `name` are required, any other provider-specific fields are allowed:
11
+ *
12
+ * @example
13
+ * ```typescript
14
+ * const agent = new ClaudeAgent({
15
+ * ...,
16
+ * builtInTools: [
17
+ * { type: "web_search_20250305", name: "web_search", max_uses: 5 },
18
+ * ],
19
+ * });
20
+ * ```
21
+ *
22
+ * Or use one of the helpers below for the well-known Anthropic tools.
23
+ */
24
+ export interface BuiltInTool {
25
+ /** Provider-specific tool type identifier, e.g. `"web_search_20250305"` */
26
+ type: string;
27
+ /** Name the model will use to refer to the tool, e.g. `"web_search"` */
28
+ name: string;
29
+ /** Any additional provider-specific configuration for this tool */
30
+ [key: string]: unknown;
31
+ }
32
+ /**
33
+ * Options for Anthropic's web search tool (`web_search_20250305`).
34
+ * @see https://docs.anthropic.com/en/docs/build-with-claude/tool-use/web-search-tool
35
+ */
36
+ export interface WebSearchToolOptions {
37
+ /** Maximum number of searches Claude can perform during the request */
38
+ maxUses?: number;
39
+ /** Only include results from these domains (mutually exclusive with `blockedDomains`) */
40
+ allowedDomains?: string[];
41
+ /** Never include results from these domains (mutually exclusive with `allowedDomains`) */
42
+ blockedDomains?: string[];
43
+ /** Approximate user location, used to localize search results */
44
+ userLocation?: {
45
+ type?: "approximate";
46
+ city?: string;
47
+ region?: string;
48
+ country?: string;
49
+ timezone?: string;
50
+ };
51
+ }
52
+ /**
53
+ * Anthropic's server-side web search tool.
54
+ * Claude decides when to search and the results are fetched and processed by Anthropic.
55
+ */
56
+ export declare function webSearchTool(options?: WebSearchToolOptions): BuiltInTool;
57
+ /**
58
+ * Anthropic's server-side bash tool — gives Claude a persistent shell session.
59
+ * Requires a compatible model (e.g. Claude 4 / 3.7 Sonnet) and beta header support.
60
+ */
61
+ export declare function bashTool(): BuiltInTool;
62
+ /**
63
+ * Anthropic's server-side text editor tool — lets Claude view and edit text files.
64
+ */
65
+ export declare function textEditorTool(version?: "20250124" | "20250429" | "20250728"): BuiltInTool;
66
+ /**
67
+ * Define an arbitrary provider-defined / built-in tool by its raw definition.
68
+ * Use this to pass through tools not covered by the helpers above (or for
69
+ * other providers that support server-side tools).
70
+ */
71
+ export declare function builtInTool(definition: BuiltInTool): BuiltInTool;
72
+ //# sourceMappingURL=BuiltInTool.d.ts.map
@@ -0,0 +1,53 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.webSearchTool = webSearchTool;
4
+ exports.bashTool = bashTool;
5
+ exports.textEditorTool = textEditorTool;
6
+ exports.builtInTool = builtInTool;
7
+ /**
8
+ * Anthropic's server-side web search tool.
9
+ * Claude decides when to search and the results are fetched and processed by Anthropic.
10
+ */
11
+ function webSearchTool(options = {}) {
12
+ const tool = {
13
+ type: "web_search_20250305",
14
+ name: "web_search",
15
+ };
16
+ if (options.maxUses !== undefined)
17
+ tool.max_uses = options.maxUses;
18
+ if (options.allowedDomains)
19
+ tool.allowed_domains = options.allowedDomains;
20
+ if (options.blockedDomains)
21
+ tool.blocked_domains = options.blockedDomains;
22
+ if (options.userLocation) {
23
+ tool.user_location = { type: "approximate", ...options.userLocation };
24
+ }
25
+ return tool;
26
+ }
27
+ /**
28
+ * Anthropic's server-side bash tool — gives Claude a persistent shell session.
29
+ * Requires a compatible model (e.g. Claude 4 / 3.7 Sonnet) and beta header support.
30
+ */
31
+ function bashTool() {
32
+ return { type: "bash_20250124", name: "bash" };
33
+ }
34
+ /**
35
+ * Anthropic's server-side text editor tool — lets Claude view and edit text files.
36
+ */
37
+ function textEditorTool(version = "20250728") {
38
+ const names = {
39
+ "20250124": "str_replace_editor",
40
+ "20250429": "str_replace_based_edit_tool",
41
+ "20250728": "str_replace_based_edit_tool",
42
+ };
43
+ return { type: `text_editor_${version}`, name: names[version] };
44
+ }
45
+ /**
46
+ * Define an arbitrary provider-defined / built-in tool by its raw definition.
47
+ * Use this to pass through tools not covered by the helpers above (or for
48
+ * other providers that support server-side tools).
49
+ */
50
+ function builtInTool(definition) {
51
+ return definition;
52
+ }
53
+ //# sourceMappingURL=BuiltInTool.js.map
@@ -2,7 +2,7 @@
2
2
  * Visualization event types and interfaces for agent monitoring.
3
3
  * These types define the contract between agention-lib and @agention/viz.
4
4
  */
5
- export type VizVendor = "anthropic" | "openai" | "mistral" | "gemini";
5
+ export type VizVendor = "anthropic" | "openai" | "mistral" | "gemini" | "ollama" | "llamacpp";
6
6
  export type VizEventType = "session.start" | "session.end" | "pipeline.start" | "pipeline.end" | "executor.start" | "executor.end" | "agent.start" | "agent.complete" | "agent.error" | "tool.start" | "tool.complete" | "tool.error" | "message.user" | "message.assistant";
7
7
  export type VizExecutorType = "sequential" | "parallel" | "map" | "voting" | "router";
8
8
  export type VizStopReason = "end_turn" | "tool_use" | "max_tokens" | "stop_sequence" | "error";
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@agentionai/agents",
3
3
  "author": "Laurent Zuijdwijk",
4
- "version": "0.12.0-beta",
4
+ "version": "0.13.0",
5
5
  "description": "Agent Library",
6
6
  "main": "dist/index.js",
7
7
  "types": "dist/index.d.ts",
@@ -31,8 +31,12 @@
31
31
  "default": "./dist/gemini.js"
32
32
  },
33
33
  "./ollama": {
34
- "types": "./dist/agents/ollama/OllamaAgent.d.ts",
35
- "default": "./dist/agents/ollama/OllamaAgent.js"
34
+ "types": "./dist/ollama.d.ts",
35
+ "default": "./dist/ollama.js"
36
+ },
37
+ "./llamacpp": {
38
+ "types": "./dist/llamacpp.d.ts",
39
+ "default": "./dist/llamacpp.js"
36
40
  },
37
41
  "./embeddings": {
38
42
  "types": "./dist/embeddings/index.d.ts",
@@ -65,26 +69,6 @@
65
69
  "./history/plugins": {
66
70
  "types": "./dist/history/plugins/index.d.ts",
67
71
  "default": "./dist/history/plugins/index.js"
68
- },
69
- "./parsers": {
70
- "types": "./dist/parsers/index.d.ts",
71
- "default": "./dist/parsers/index.js"
72
- },
73
- "./parsers/unstructured-local": {
74
- "types": "./dist/parsers/UnstructuredLocalParser.d.ts",
75
- "default": "./dist/parsers/UnstructuredLocalParser.js"
76
- },
77
- "./parsers/unstructured-api": {
78
- "types": "./dist/parsers/UnstructuredAPIParser.d.ts",
79
- "default": "./dist/parsers/UnstructuredAPIParser.js"
80
- },
81
- "./parsers/llamaindex": {
82
- "types": "./dist/parsers/LlamaIndexParser.d.ts",
83
- "default": "./dist/parsers/LlamaIndexParser.js"
84
- },
85
- "./parsers/ollama-ocr": {
86
- "types": "./dist/parsers/OllamaOCRParser.d.ts",
87
- "default": "./dist/parsers/OllamaOCRParser.js"
88
72
  }
89
73
  },
90
74
  "files": [
@@ -164,13 +148,9 @@
164
148
  "@mistralai/mistralai": "^1.13.0",
165
149
  "@modelcontextprotocol/sdk": "^1.26.0",
166
150
  "apache-arrow": "^18.0.0",
151
+ "ollama": "^0.5.18",
167
152
  "openai": "^6.16.0",
168
- "voyageai": "^0.0.3",
169
- "@epilogo/unstructured-io-node": "*",
170
- "unstructured-client": "*",
171
- "llamaindex": "*",
172
- "@llamaindex/readers": "*",
173
- "pdf-to-img": "*"
153
+ "voyageai": "^0.0.3"
174
154
  },
175
155
  "peerDependenciesMeta": {
176
156
  "@lancedb/lancedb": {
@@ -200,19 +180,7 @@
200
180
  "@opensearch-project/opensearch": {
201
181
  "optional": true
202
182
  },
203
- "@epilogo/unstructured-io-node": {
204
- "optional": true
205
- },
206
- "unstructured-client": {
207
- "optional": true
208
- },
209
- "llamaindex": {
210
- "optional": true
211
- },
212
- "@llamaindex/readers": {
213
- "optional": true
214
- },
215
- "pdf-to-img": {
183
+ "ollama": {
216
184
  "optional": true
217
185
  }
218
186
  },