llmist 1.3.0 → 1.4.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.
- package/README.md +10 -18
- package/dist/chunk-UEEESLOA.js +974 -0
- package/dist/chunk-UEEESLOA.js.map +1 -0
- package/dist/{chunk-RZTAKIDE.js → chunk-VGZCFUPX.js} +4627 -3211
- package/dist/chunk-VGZCFUPX.js.map +1 -0
- package/dist/cli.cjs +1321 -245
- package/dist/cli.cjs.map +1 -1
- package/dist/cli.js +1190 -215
- package/dist/cli.js.map +1 -1
- package/dist/index.cjs +52 -10
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +7 -6
- package/dist/index.d.ts +7 -6
- package/dist/index.js +20 -973
- package/dist/index.js.map +1 -1
- package/dist/{mock-stream-DNt-HBTn.d.cts → mock-stream-DD5yJM44.d.cts} +65 -0
- package/dist/{mock-stream-DNt-HBTn.d.ts → mock-stream-DD5yJM44.d.ts} +65 -0
- package/dist/testing/index.cjs +52 -10
- package/dist/testing/index.cjs.map +1 -1
- package/dist/testing/index.d.cts +2 -2
- package/dist/testing/index.d.ts +2 -2
- package/dist/testing/index.js +1 -2
- package/package.json +3 -1
- package/dist/chunk-RZTAKIDE.js.map +0 -1
- package/dist/chunk-TFIKR2RK.js +0 -1394
- package/dist/chunk-TFIKR2RK.js.map +0 -1
package/README.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
# llmist
|
|
2
2
|
|
|
3
3
|
[](https://github.com/zbigniewsobiecki/llmist/actions/workflows/ci.yml)
|
|
4
|
-
[](https://codecov.io/gh/zbigniewsobiecki/llmist)
|
|
4
|
+
[](https://codecov.io/gh/zbigniewsobiecki/llmist)
|
|
5
5
|
[](https://www.npmjs.com/package/llmist)
|
|
6
6
|
[](https://opensource.org/licenses/MIT)
|
|
7
7
|
|
|
8
|
-
> **Universal TypeScript LLM client with streaming-first tool execution and simple, extensible agent framework**
|
|
8
|
+
> **Universal TypeScript LLM client with own function calling grammar, streaming-first tool execution and simple, extensible agent framework**
|
|
9
9
|
|
|
10
10
|
> **⚠️ EARLY WORK IN PROGRESS** - This library is under active development. APIs may change without notice. Use in production at your own risk.
|
|
11
11
|
|
|
@@ -15,12 +15,13 @@ llmist is an asynchonous, streaming-first, provider-agnostic LLM client that mak
|
|
|
15
15
|
|
|
16
16
|
## 🎯 Why llmist?
|
|
17
17
|
|
|
18
|
-
- **🌍 Universal** - Works with any LLM provider (OpenAI, Anthropic, Gemini, custom)
|
|
19
|
-
- **📝 No Structured Outputs** - Simple block format with
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
-
|
|
23
|
-
-
|
|
18
|
+
- **🌍 Universal** - Works with [any LLM provider](./docs/PROVIDERS.md) (OpenAI, Anthropic, Gemini, [custom](./docs/CUSTOM_MODELS.md)) and easy to integrate more
|
|
19
|
+
- **📝 No Structured Outputs** - Simple [block format](./docs/BLOCK_FORMAT.md) with streaming oriented tool calling
|
|
20
|
+
- **🪝 Powerful Hooks** - Monitor, customize, and control [every step of execution](./docs/HOOKS.md)
|
|
21
|
+
- **🎨 Fluent API** - [Builder pattern](./docs/CONFIGURATION.md) with model shortcuts and presets
|
|
22
|
+
- **🧪 Testing-Friendly** - Built-in [mocking system](./docs/TESTING.md) for zero-cost testing
|
|
23
|
+
- **⌨️ Convenient CLI** - [Capable CLI](./docs/CLI.md) showcasing how to build on top of llmist
|
|
24
|
+
- **🏦 Cost-aware** - [Cost APIs per model](./docs/MODEL_CATALOG.md) + prompt-caching aware accounting
|
|
24
25
|
|
|
25
26
|
---
|
|
26
27
|
|
|
@@ -49,15 +50,6 @@ bunx llmist agent "Calculate 15 * 23" --gadget ./calculator.ts --model sonnet
|
|
|
49
50
|
cat document.txt | llmist complete "Summarize" --model gpt-5-nano
|
|
50
51
|
```
|
|
51
52
|
|
|
52
|
-
**Built-in gadgets** are included by default in agent mode:
|
|
53
|
-
- `AskUser` - Prompts for user input when clarification is needed
|
|
54
|
-
- `TellUser` - Displays important messages (info/success/warning/error) and can end conversations
|
|
55
|
-
|
|
56
|
-
```bash
|
|
57
|
-
# Disable built-in gadgets
|
|
58
|
-
bunx llmist agent "Task" --no-builtins -g ./my-tools.ts
|
|
59
|
-
```
|
|
60
|
-
|
|
61
53
|
📖 **[CLI Reference](./docs/CLI.md)** | **[CLI Gadgets Guide](./docs/CLI_GADGETS.md)**
|
|
62
54
|
|
|
63
55
|
|
|
@@ -97,7 +89,7 @@ const answer = await LLMist.createAgent()
|
|
|
97
89
|
console.log(answer); // "15 times 23 equals 345"
|
|
98
90
|
```
|
|
99
91
|
|
|
100
|
-
**That's it!**
|
|
92
|
+
**That's it!**
|
|
101
93
|
|
|
102
94
|
📖 **[Getting Started Guide](./docs/GETTING_STARTED.md)** - Learn more in 5 minutes
|
|
103
95
|
|