@ddlqhd/agent-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 (50) hide show
  1. package/README.md +53 -0
  2. package/dist/chunk-5QMA2YBY.cjs +2880 -0
  3. package/dist/chunk-5QMA2YBY.cjs.map +1 -0
  4. package/dist/chunk-5Y56A64C.cjs +5 -0
  5. package/dist/chunk-5Y56A64C.cjs.map +1 -0
  6. package/dist/chunk-A3S3AGE3.js +3 -0
  7. package/dist/chunk-A3S3AGE3.js.map +1 -0
  8. package/dist/chunk-CNSGZVRN.cjs +152 -0
  9. package/dist/chunk-CNSGZVRN.cjs.map +1 -0
  10. package/dist/chunk-JF5AJQMU.cjs +2788 -0
  11. package/dist/chunk-JF5AJQMU.cjs.map +1 -0
  12. package/dist/chunk-NDSL7NPN.js +807 -0
  13. package/dist/chunk-NDSL7NPN.js.map +1 -0
  14. package/dist/chunk-OHXW2YM6.js +2708 -0
  15. package/dist/chunk-OHXW2YM6.js.map +1 -0
  16. package/dist/chunk-Q3SOMX26.js +2854 -0
  17. package/dist/chunk-Q3SOMX26.js.map +1 -0
  18. package/dist/chunk-WH3APNQ5.js +147 -0
  19. package/dist/chunk-WH3APNQ5.js.map +1 -0
  20. package/dist/chunk-X35MHWXE.cjs +817 -0
  21. package/dist/chunk-X35MHWXE.cjs.map +1 -0
  22. package/dist/cli/index.cjs +926 -0
  23. package/dist/cli/index.cjs.map +1 -0
  24. package/dist/cli/index.d.cts +24 -0
  25. package/dist/cli/index.d.ts +24 -0
  26. package/dist/cli/index.js +916 -0
  27. package/dist/cli/index.js.map +1 -0
  28. package/dist/index-DPsZ1zat.d.ts +447 -0
  29. package/dist/index-RTPmFjMp.d.cts +447 -0
  30. package/dist/index.cjs +508 -0
  31. package/dist/index.cjs.map +1 -0
  32. package/dist/index.d.cts +664 -0
  33. package/dist/index.d.ts +664 -0
  34. package/dist/index.js +204 -0
  35. package/dist/index.js.map +1 -0
  36. package/dist/models/index.cjs +62 -0
  37. package/dist/models/index.cjs.map +1 -0
  38. package/dist/models/index.d.cts +165 -0
  39. package/dist/models/index.d.ts +165 -0
  40. package/dist/models/index.js +5 -0
  41. package/dist/models/index.js.map +1 -0
  42. package/dist/tools/index.cjs +207 -0
  43. package/dist/tools/index.cjs.map +1 -0
  44. package/dist/tools/index.d.cts +108 -0
  45. package/dist/tools/index.d.ts +108 -0
  46. package/dist/tools/index.js +6 -0
  47. package/dist/tools/index.js.map +1 -0
  48. package/dist/types-C0aX_Qdp.d.cts +917 -0
  49. package/dist/types-C0aX_Qdp.d.ts +917 -0
  50. package/package.json +80 -0
package/README.md ADDED
@@ -0,0 +1,53 @@
1
+ # Agent SDK
2
+
3
+ A TypeScript library for building AI agents with multi-model support (OpenAI, Anthropic, Ollama), MCP integration, a skill system, tool registration, session persistence, and streaming.
4
+
5
+ **Integration policy:** Application code should drive execution through **`Agent`** (`run` / `stream`). Use `createOpenAI`, `createAnthropic`, `createOllama`, or `createModel` only to build the `model` passed into `Agent`. Do not call `ModelAdapter` methods such as `stream()` or `complete()` directly in product code (bypassing `Agent`). See [`docs/sdk-overview.md`](docs/sdk-overview.md) section 3.
6
+
7
+ ## Features
8
+
9
+ - Multi-model support: OpenAI, Anthropic, Ollama
10
+ - Built-in tools plus custom tools (Zod-validated parameters)
11
+ - MCP servers (stdio / HTTP) mapped to tools
12
+ - Skills loaded from `SKILL.md`
13
+ - JSONL or in-memory session storage
14
+ - Long-term memory from `CLAUDE.md`
15
+ - Streaming via `AsyncIterable` / `StreamEvent`
16
+ - Optional CLI for trying the SDK (`agent-sdk`)
17
+
18
+ ## Requirements
19
+
20
+ - **Node.js** >= 18 (see [`package.json`](package.json) `engines`)
21
+
22
+ ## Installation
23
+
24
+ ```bash
25
+ npm install @ddlqhd/agent-sdk
26
+ ```
27
+
28
+ ```bash
29
+ pnpm add @ddlqhd/agent-sdk
30
+ ```
31
+
32
+ ## Documentation
33
+
34
+ Factual guides and API references live under **`docs/`** (single source of truth). Start here:
35
+
36
+ | Topic | Document |
37
+ |--------|----------|
38
+ | Overview, export boundaries, integration rules | [`docs/sdk-overview.md`](docs/sdk-overview.md) |
39
+ | Quick start | [`docs/sdk-quickstart.md`](docs/sdk-quickstart.md) |
40
+ | Agent loop (`iteration`, tool cycles) | [`docs/sdk-agent-loop.md`](docs/sdk-agent-loop.md) |
41
+ | Built-in tools catalog | [`docs/sdk-built-in-tools.md`](docs/sdk-built-in-tools.md) |
42
+ | Recipes (tools, MCP, skills, memory, prompts, approval, subagent) | [`docs/sdk-integration-recipes.md`](docs/sdk-integration-recipes.md) |
43
+ | API reference | [`docs/sdk-api-reference.md`](docs/sdk-api-reference.md) |
44
+ | Types (`StreamEvent`, etc.) | [`docs/sdk-types-reference.md`](docs/sdk-types-reference.md) |
45
+ | CLI | [`docs/sdk-cli.md`](docs/sdk-cli.md) |
46
+ | Tool hooks | [`docs/tool-hook-mechanism.md`](docs/tool-hook-mechanism.md) |
47
+ | Troubleshooting | [`docs/sdk-troubleshooting.md`](docs/sdk-troubleshooting.md) |
48
+ | Examples & Web Demo index | [`docs/sdk-examples-index.md`](docs/sdk-examples-index.md) |
49
+ | Repository layout (contributors) | [`docs/repository-layout.md`](docs/repository-layout.md) |
50
+
51
+ ## License
52
+
53
+ MIT