openliate 0.0.0-stage → 0.1.5

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 (43) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +127 -2
  3. package/README.npm.md +128 -0
  4. package/dist/bin.js +28734 -0
  5. package/dist/liate.js +39468 -0
  6. package/dist/runtime/hono.js +28061 -0
  7. package/dist/runtime/index.js +28061 -0
  8. package/hub/agents/docgyan-agent/agent.json +27 -0
  9. package/hub/agents/docgyan-agent/agent.ts +39 -0
  10. package/hub/agents/gnani-agent/agent.json +17 -0
  11. package/hub/agents/neon-agent/agent.json +18 -0
  12. package/hub/agents/prism-agent/agent.json +17 -0
  13. package/hub/agents/sarvam-agent/agent.json +17 -0
  14. package/package.json +71 -4
  15. package/src/cli/index.ts +346 -0
  16. package/src/cli/resolver.ts +153 -0
  17. package/src/core/aum.ts +137 -0
  18. package/src/core/om.ts +159 -0
  19. package/src/core/spec.ts +112 -0
  20. package/src/core/uuid.ts +8 -0
  21. package/src/core/version.ts +2 -0
  22. package/src/layers/agent/harness.ts +118 -0
  23. package/src/layers/agent/loop.ts +203 -0
  24. package/src/layers/agent/skills.ts +302 -0
  25. package/src/layers/agent/types.ts +66 -0
  26. package/src/layers/environment/sandbox.ts +107 -0
  27. package/src/layers/environment/types.ts +23 -0
  28. package/src/layers/integration/knowledge.ts +187 -0
  29. package/src/layers/integration/lib.ts +167 -0
  30. package/src/layers/integration/memory.ts +135 -0
  31. package/src/layers/integration/repo.ts +273 -0
  32. package/src/layers/integration/types.ts +60 -0
  33. package/src/layers/llm/model.ts +916 -0
  34. package/src/layers/llm/types.ts +64 -0
  35. package/src/layers/tools/mcp.ts +236 -0
  36. package/src/layers/tools/registry.ts +307 -0
  37. package/src/layers/tools/server.ts +69 -0
  38. package/src/layers/tools/types.ts +38 -0
  39. package/src/liate.ts +65 -0
  40. package/src/routes/skills.ts +73 -0
  41. package/src/runtime/hono.ts +346 -0
  42. package/src/runtime/wasm.ts +23 -0
  43. package/src/scaffold/project.ts +188 -0
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 OpenLiate
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,128 @@
1
- # Temporary Holding Version
1
+ <div align="center">
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ # LIATE — Open Source OOP Framework for AI Agents
4
+ ### Where Classes Are AI Agents · From India, For India, Beyond India 🇮🇳 🌍
5
+
6
+ `L[LM] · I[ntegration] · A[gent] · T[ools] · E[nvironment]`
7
+
8
+ <br>
9
+
10
+ <p align="center">
11
+ <a href="https://openliate.tech/docs"><img src="https://img.shields.io/badge/docs-openliate.tech%2Fdocs-white?labelColor=black&style=flat-square" alt="Docs"></a>
12
+ <a href="https://github.com/OpenLiate/Liate/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-white?labelColor=black&style=flat-square" alt="License: MIT"></a>
13
+ <a href="https://sarvam.ai"><img src="./assets/sarvam-badge.svg" alt="Powered by Sarvam AI Startup Program"></a>
14
+ <a href="https://codespaces.new/OpenLiate/Liate"><img src="https://img.shields.io/badge/Codespaces-1--Click_Run-white?logo=github&logoColor=white&labelColor=black&style=flat-square" alt="Open in GitHub Codespaces"></a>
15
+ <a href="https://www.npmjs.com/package/openliate"><img src="https://img.shields.io/badge/npm-v0.1.5-white?labelColor=black&style=flat-square" alt="npm: v0.1.5"></a>
16
+ <img src="https://img.shields.io/badge/Bun-Supported-white?logo=bun&logoColor=white&labelColor=black&style=flat-square" alt="Bun">
17
+ <img src="https://img.shields.io/badge/Node.js-Supported-white?logo=node.js&logoColor=5FA04E&labelColor=black&style=flat-square" alt="Node.js">
18
+ </p>
19
+
20
+ <p align="center">
21
+ <a href="#aum-architecture"><img src="https://img.shields.io/badge/Agent_Architecture-AUM_(Agent_Unified_Module)-white?labelColor=black&style=flat-square" alt="Agent Unified Module (AUM)"></a>
22
+ &nbsp;
23
+ <a href="#runtime-engine"><img src="https://img.shields.io/badge/Core_Runtime_Engine-OM_(Orchestration_Module)-white?labelColor=black&style=flat-square" alt="Core Runtime Engine: OM (Orchestration Module)"></a>
24
+ </p>
25
+
26
+ <br>
27
+
28
+ > **Milestone: Liate — Selected for India's Sarvam AI Startup Program 2026** <sup>IN</sup>
29
+ > Built by **[OpenLiate](https://github.com/OpenLiate/Liate)** — Open Source Backend Layer for AI Agents
30
+
31
+ > *"If Stripe did payments in 7 lines of code, why not AI Agents in 5 lines of code?*
32
+ > **Class is an Agent. Agent is a Function. Function is an API.**
33
+ > *Don't build AI agents. Integrate by parts."*
34
+
35
+ </div>
36
+
37
+ ---
38
+
39
+ ## Installation
40
+
41
+ ```bash
42
+ # Direct Package:
43
+ npm install openliate
44
+ # or Org-Scoped Package:
45
+ npm install @openliate/liate
46
+
47
+ # or via Bun:
48
+ bun add openliate
49
+ ```
50
+
51
+ ---
52
+
53
+ ## Quickstart: The Frontier Agent (`SovereignAgent`)
54
+
55
+ Every agent is declared natively as a TypeScript class inheriting from `liate`. The 5 layers map 1-to-1 to NVIDIA CEO Jensen Huang's 5 foundational agent elements:
56
+
57
+ ```typescript
58
+ import { liate } from "openliate";
59
+ // or if using the org-scoped package:
60
+ // import { liate } from "@openliate/liate";
61
+
62
+ export class SovereignAgent extends liate {
63
+ L = "sarvam/sarvam-105b"; // [L] Large Models Layer (Sarvam Indic 105B)
64
+ I = { memory: "sessions/sovereign-agent" }; // [I] Integration & Memory Layer
65
+ A = { // [A] Agent Harness Layer
66
+ name: "agentyaan",
67
+ intent: "Autonomous Sovereign Indic Agent",
68
+ maxSteps: 5
69
+ };
70
+ T = { // [T] Tools & MCP Layer (Stdio & SSE)
71
+ fetch: {
72
+ command: "uvx",
73
+ args: ["mcp-server-fetch"],
74
+ tools: ["*"]
75
+ }
76
+ };
77
+ E = { SARVAM_API_KEY: "$SARVAM_API_KEY" }; // [E] Environment & Sandbox Layer
78
+ }
79
+
80
+ // Run the agent via the autonomous ReAct loop:
81
+ const agent = new SovereignAgent();
82
+ const result = await agent.run("Fetch https://openliate.tech and summarize.");
83
+ console.log(result.text);
84
+ ```
85
+
86
+ ---
87
+
88
+ ## Instant Run (Zero Install)
89
+
90
+ Run any agent directly without installation using `npx`:
91
+
92
+ ```bash
93
+ npx openliate run agent.ts "Fetch https://openliate.tech and summarize"
94
+ ```
95
+
96
+ ---
97
+
98
+ ## The 5 Layers (L · I · A · T · E)
99
+
100
+ | Layer | Name | Description |
101
+ | :--- | :--- | :--- |
102
+ | **`L`** | **Large Models** | Universal routing to Sarvam AI (`sarvam-105b`, `sarvam-30b`), Ollama local, or OpenRouter with fallback cascade. |
103
+ | **`I`** | **Integration** | Sovereign memory sessions, vector knowledge graphs, and local execution state. |
104
+ | **`A`** | **Agent Harness** | Autonomous ReAct loop with max-steps safeguards and self-healing error recovery. |
105
+ | **`T`** | **Tools & MCP** | Native Anthropic Model Context Protocol (MCP) clients over stdio and SSE protocols. |
106
+ | **`E`** | **Environment** | Sandboxed environment isolation and secure secret injection. |
107
+
108
+ ---
109
+
110
+ ## CLI Reference
111
+
112
+ | Command | Action |
113
+ | :--- | :--- |
114
+ | `openliate run [file] <prompt>` | Execute agent with a prompt |
115
+ | `openliate chat [file]` | Start interactive multi-turn REPL session |
116
+ | `openliate serve [--port]` | Launch high-performance Hono HTTP/SSE edge runtime |
117
+ | `openliate create <name>` | Scaffold a new agent project |
118
+ | `openliate hub` | List prebuilt agent templates |
119
+
120
+ ---
121
+
122
+ <div align="center">
123
+
124
+ **[Documentation](https://openliate.tech/docs)** · **[Website](https://openliate.tech)** · **[GitHub](https://github.com/OpenLiate/Liate)**
125
+
126
+ Built with ❤️ from India, for India, and beyond India 🇮🇳 🌍
127
+
128
+ </div>
package/README.npm.md ADDED
@@ -0,0 +1,128 @@
1
+ <div align="center">
2
+
3
+ # LIATE — Open Source OOP Framework for AI Agents
4
+ ### Where Classes Are AI Agents · From India, For India, Beyond India 🇮🇳 🌍
5
+
6
+ `L[LM] · I[ntegration] · A[gent] · T[ools] · E[nvironment]`
7
+
8
+ <br>
9
+
10
+ <p align="center">
11
+ <a href="https://openliate.tech/docs"><img src="https://img.shields.io/badge/docs-openliate.tech%2Fdocs-white?labelColor=black&style=flat-square" alt="Docs"></a>
12
+ <a href="https://github.com/OpenLiate/Liate/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-white?labelColor=black&style=flat-square" alt="License: MIT"></a>
13
+ <a href="https://sarvam.ai"><img src="./assets/sarvam-badge.svg" alt="Powered by Sarvam AI Startup Program"></a>
14
+ <a href="https://codespaces.new/OpenLiate/Liate"><img src="https://img.shields.io/badge/Codespaces-1--Click_Run-white?logo=github&logoColor=white&labelColor=black&style=flat-square" alt="Open in GitHub Codespaces"></a>
15
+ <a href="https://www.npmjs.com/package/openliate"><img src="https://img.shields.io/badge/npm-v0.1.5-white?labelColor=black&style=flat-square" alt="npm: v0.1.5"></a>
16
+ <img src="https://img.shields.io/badge/Bun-Supported-white?logo=bun&logoColor=white&labelColor=black&style=flat-square" alt="Bun">
17
+ <img src="https://img.shields.io/badge/Node.js-Supported-white?logo=node.js&logoColor=5FA04E&labelColor=black&style=flat-square" alt="Node.js">
18
+ </p>
19
+
20
+ <p align="center">
21
+ <a href="#aum-architecture"><img src="https://img.shields.io/badge/Agent_Architecture-AUM_(Agent_Unified_Module)-white?labelColor=black&style=flat-square" alt="Agent Unified Module (AUM)"></a>
22
+ &nbsp;
23
+ <a href="#runtime-engine"><img src="https://img.shields.io/badge/Core_Runtime_Engine-OM_(Orchestration_Module)-white?labelColor=black&style=flat-square" alt="Core Runtime Engine: OM (Orchestration Module)"></a>
24
+ </p>
25
+
26
+ <br>
27
+
28
+ > **Milestone: Liate — Selected for India's Sarvam AI Startup Program 2026** <sup>IN</sup>
29
+ > Built by **[OpenLiate](https://github.com/OpenLiate/Liate)** — Open Source Backend Layer for AI Agents
30
+
31
+ > *"If Stripe did payments in 7 lines of code, why not AI Agents in 5 lines of code?*
32
+ > **Class is an Agent. Agent is a Function. Function is an API.**
33
+ > *Don't build AI agents. Integrate by parts."*
34
+
35
+ </div>
36
+
37
+ ---
38
+
39
+ ## Installation
40
+
41
+ ```bash
42
+ # Direct Package:
43
+ npm install openliate
44
+ # or Org-Scoped Package:
45
+ npm install @openliate/liate
46
+
47
+ # or via Bun:
48
+ bun add openliate
49
+ ```
50
+
51
+ ---
52
+
53
+ ## Quickstart: The Frontier Agent (`SovereignAgent`)
54
+
55
+ Every agent is declared natively as a TypeScript class inheriting from `liate`. The 5 layers map 1-to-1 to NVIDIA CEO Jensen Huang's 5 foundational agent elements:
56
+
57
+ ```typescript
58
+ import { liate } from "openliate";
59
+ // or if using the org-scoped package:
60
+ // import { liate } from "@openliate/liate";
61
+
62
+ export class SovereignAgent extends liate {
63
+ L = "sarvam/sarvam-105b"; // [L] Large Models Layer (Sarvam Indic 105B)
64
+ I = { memory: "sessions/sovereign-agent" }; // [I] Integration & Memory Layer
65
+ A = { // [A] Agent Harness Layer
66
+ name: "agentyaan",
67
+ intent: "Autonomous Sovereign Indic Agent",
68
+ maxSteps: 5
69
+ };
70
+ T = { // [T] Tools & MCP Layer (Stdio & SSE)
71
+ fetch: {
72
+ command: "uvx",
73
+ args: ["mcp-server-fetch"],
74
+ tools: ["*"]
75
+ }
76
+ };
77
+ E = { SARVAM_API_KEY: "$SARVAM_API_KEY" }; // [E] Environment & Sandbox Layer
78
+ }
79
+
80
+ // Run the agent via the autonomous ReAct loop:
81
+ const agent = new SovereignAgent();
82
+ const result = await agent.run("Fetch https://openliate.tech and summarize.");
83
+ console.log(result.text);
84
+ ```
85
+
86
+ ---
87
+
88
+ ## Instant Run (Zero Install)
89
+
90
+ Run any agent directly without installation using `npx`:
91
+
92
+ ```bash
93
+ npx openliate run agent.ts "Fetch https://openliate.tech and summarize"
94
+ ```
95
+
96
+ ---
97
+
98
+ ## The 5 Layers (L · I · A · T · E)
99
+
100
+ | Layer | Name | Description |
101
+ | :--- | :--- | :--- |
102
+ | **`L`** | **Large Models** | Universal routing to Sarvam AI (`sarvam-105b`, `sarvam-30b`), Ollama local, or OpenRouter with fallback cascade. |
103
+ | **`I`** | **Integration** | Sovereign memory sessions, vector knowledge graphs, and local execution state. |
104
+ | **`A`** | **Agent Harness** | Autonomous ReAct loop with max-steps safeguards and self-healing error recovery. |
105
+ | **`T`** | **Tools & MCP** | Native Anthropic Model Context Protocol (MCP) clients over stdio and SSE protocols. |
106
+ | **`E`** | **Environment** | Sandboxed environment isolation and secure secret injection. |
107
+
108
+ ---
109
+
110
+ ## CLI Reference
111
+
112
+ | Command | Action |
113
+ | :--- | :--- |
114
+ | `openliate run [file] <prompt>` | Execute agent with a prompt |
115
+ | `openliate chat [file]` | Start interactive multi-turn REPL session |
116
+ | `openliate serve [--port]` | Launch high-performance Hono HTTP/SSE edge runtime |
117
+ | `openliate create <name>` | Scaffold a new agent project |
118
+ | `openliate hub` | List prebuilt agent templates |
119
+
120
+ ---
121
+
122
+ <div align="center">
123
+
124
+ **[Documentation](https://openliate.tech/docs)** · **[Website](https://openliate.tech)** · **[GitHub](https://github.com/OpenLiate/Liate)**
125
+
126
+ Built with ❤️ from India, for India, and beyond India 🇮🇳 🌍
127
+
128
+ </div>