openliate 0.0.1 → 0.1.6

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 (73) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +73 -241
  3. package/README.npm.md +128 -0
  4. package/dist/bin.js +24644 -42273
  5. package/dist/liate.js +39479 -0
  6. package/dist/runtime/hono.js +28072 -0
  7. package/dist/runtime/index.js +28072 -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 +9 -6
  14. package/package.json +33 -21
  15. package/src/cli/index.ts +346 -0
  16. package/src/cli/resolver.ts +153 -0
  17. package/src/core/aum.ts +87 -28
  18. package/src/core/om.ts +159 -0
  19. package/src/core/spec.ts +112 -0
  20. package/src/core/uuid.ts +5 -16
  21. package/src/core/version.ts +2 -0
  22. package/src/layers/agent/harness.ts +118 -0
  23. package/src/{agent → layers/agent}/loop.ts +44 -24
  24. package/src/layers/agent/skills.ts +302 -0
  25. package/src/{agent → layers/agent}/types.ts +14 -1
  26. package/src/{environment/environment.ts → layers/environment/sandbox.ts} +24 -5
  27. package/src/{environment → layers/environment}/types.ts +8 -0
  28. package/src/layers/integration/knowledge.ts +187 -0
  29. package/src/layers/integration/lib.ts +167 -0
  30. package/src/{integration → layers/integration}/memory.ts +49 -67
  31. package/src/layers/integration/repo.ts +273 -0
  32. package/src/{integration → layers/integration}/types.ts +60 -31
  33. package/src/layers/llm/model.ts +928 -0
  34. package/src/layers/llm/types.ts +64 -0
  35. package/src/{tools → layers/tools}/mcp.ts +24 -10
  36. package/src/layers/tools/registry.ts +307 -0
  37. package/src/{tools → layers/tools}/server.ts +12 -13
  38. package/src/{tools → layers/tools}/types.ts +3 -2
  39. package/src/liate.ts +64 -24
  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
  44. package/dist/engine/engine.zip +0 -0
  45. package/dist/engine/index.js +0 -36790
  46. package/hub/agents/email-agent/agent.json +0 -19
  47. package/hub/agents/general-agent/agent.json +0 -18
  48. package/hub/agents/identity-agent/agent.json +0 -19
  49. package/hub/agents/research-agent/agent.json +0 -18
  50. package/hub/llm/sarvam.json +0 -27
  51. package/hub/mcp/agentmail.json +0 -10
  52. package/hub/mcp/fetch.json +0 -9
  53. package/hub/mcp/neon.json +0 -12
  54. package/hub/mcp/sarvam.json +0 -12
  55. package/hub/mcp/supabase.json +0 -12
  56. package/hub/mcp/vercel.json +0 -12
  57. package/src/agent/agent.ts +0 -165
  58. package/src/cli.ts +0 -272
  59. package/src/engine/types.ts +0 -104
  60. package/src/integration/integration.ts +0 -37
  61. package/src/link/index.ts +0 -317
  62. package/src/link/neon.ts +0 -646
  63. package/src/link/supabase.ts +0 -567
  64. package/src/link/vercel.ts +0 -633
  65. package/src/llm/config.ts +0 -46
  66. package/src/llm/hub.ts +0 -59
  67. package/src/llm/llm.ts +0 -60
  68. package/src/llm/sarvam.ts +0 -136
  69. package/src/server/engine.ts +0 -277
  70. package/src/server/index.ts +0 -32
  71. package/src/tools/builtin/fetch.ts +0 -66
  72. package/src/tools/builtin/identity.ts +0 -131
  73. package/src/tools/registry.ts +0 -218
package/LICENSE CHANGED
@@ -1,21 +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.
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,296 +1,128 @@
1
1
  <div align="center">
2
2
 
3
- # OpenLiate — Open Source Backend Layer for AI Agents
4
- ### Don't build AI agents. Integrate by parts.
3
+ # LIATE — Open Source OOP Framework for AI Agents
4
+ ### Where Classes Are AI Agents · From India, For India, Beyond India 🇮🇳 🌍
5
5
 
6
6
  `L[LM] · I[ntegration] · A[gent] · T[ools] · E[nvironment]`
7
7
 
8
8
  <br>
9
9
 
10
10
  <p align="center">
11
- <a href="https://docs.openliate.tech"><img src="https://img.shields.io/badge/docs-docs.openliate.tech-white?labelColor=black&style=flat-square&v=2" alt="Docs"></a>
12
- <a href="https://github.com/openliate/openliate/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="Startup Program: Sarvam AI"></a>
14
- <a href="https://codespaces.new/openliate/openliate"><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
- <img src="https://img.shields.io/badge/version-0.1.0-white?labelColor=black&style=flat-square" alt="v0.1.0">
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">
16
18
  </p>
17
19
 
18
20
  <p align="center">
19
- <a href="#run-cloud"><img src="https://img.shields.io/badge/Regional_Cloud-2.5M_Live-white?labelColor=black&style=flat-square" alt="Regional Cloud"></a>
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>
20
22
  &nbsp;
21
- <a href="#run-cloud"><img src="https://img.shields.io/badge/Neon-1M_Runs-white?logo=neon&logoColor=00E59B&labelColor=black&style=flat-square" alt="Neon"></a>
22
- &nbsp;
23
- <a href="#run-cloud"><img src="https://img.shields.io/badge/Vercel-1M_Runs-white?logo=vercel&logoColor=white&labelColor=black&style=flat-square" alt="Vercel"></a>
24
- &nbsp;
25
- <a href="#run-cloud"><img src="https://img.shields.io/badge/Supabase-5_Lakhs-white?logo=supabase&logoColor=3ECF8E&labelColor=black&style=flat-square" alt="Supabase"></a>
26
- </p>
27
-
28
- <p align="center">
29
- <a href="#run-cloud"><img src="https://img.shields.io/badge/Worldwide_Edge-16M_Grid-white?labelColor=black&style=flat-square" alt="Worldwide Edge"></a>
30
- &nbsp;
31
- <a href="#run-cloud"><img src="https://img.shields.io/badge/Fastly-10M_Runs-white?logo=fastly&logoColor=FF282D&labelColor=black&style=flat-square" alt="Fastly"></a>
32
- &nbsp;
33
- <a href="#run-cloud"><img src="https://img.shields.io/badge/Cloudflare-3M_Runs-white?logo=cloudflare&logoColor=F38020&labelColor=black&style=flat-square" alt="Cloudflare"></a>
34
- &nbsp;
35
- <a href="#run-cloud"><img src="https://img.shields.io/badge/Azion-3M_Runs-white?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0iI0Y0NjUyQiIgZD0iTSAyIDE5LjMgTCAxOS44IDIgTCAyMiAyIEwgMTguOCAyMiBMIDE1LjUgMjIgTCAxNy42IDguNyBMIDQuMiAyMiBMIDIuOCAyMiBMIDIgMjEuMSBaIi8+PC9zdmc+&labelColor=black&style=flat-square" alt="Azion"></a>
36
- </p>
37
-
38
- <p align="center">
39
- <a href="#aum-architecture"><img src="https://img.shields.io/badge/Agent_Architecture-AUM_(Agent_Unified_Manifest)-white?labelColor=black&style=flat-square" alt="Agent Unified Manifest (AUM)"></a>
40
- &nbsp;
41
- <a href="#runtime-engine"><img src="https://img.shields.io/badge/Core_Engine-OM_(Orchestration_Module)-white?labelColor=black&style=flat-square" alt="Core Engine: OM (Orchestration Module)"></a>
42
- &nbsp;
43
- <a href="#instant-install"><img src="https://img.shields.io/badge/Instant_Install-Zero_Dependencies-white?labelColor=black&style=flat-square" alt="Instant Install"></a>
44
- &nbsp;
45
- <a href="https://skills.sh"><img src="https://img.shields.io/badge/Agent_Skills-1.5M+_skills.sh_(Vercel_Labs)-white?labelColor=black&logo=vercel&logoColor=white&style=flat-square" alt="1.5M+ Agent Skills (skills.sh)"></a>
46
- &nbsp;
47
- <a href="https://www.omniroute.online/"><img src="./assets/omniroute-badge.svg" alt="1.62B+ Free AI Tokens Per Month (OmniRoute)"></a>
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>
48
24
  </p>
49
25
 
50
26
  <br>
51
27
 
52
- > **#1 Milestone: Liate — Selected for India's Sarvam AI Startup Program 2026** <sup>IN</sup>
53
- > Open Source Backend Layer for AI Agents by [OpenLiate](https://github.com/openliate) · Creator [@iamazent](https://github.com/iamazent)
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
54
30
 
55
- <br>
56
-
57
- > ### *"If Stripe did payments in 7 lines of code, why not AI Agents in 5 lines of code?*
58
- > **BaaA — Backend-as-an-Agent.**
59
- > *Let's Try Liate."*
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."*
60
34
 
61
35
  </div>
62
36
 
63
- ## <a id="instant-install"></a>[0] Instant Install (Zero Dependencies)
64
-
65
- ```bash
66
- # 1-Click Run via npx (Zero local install):
67
- npx openliate run agent.json "Hello World"
68
-
69
- # Or Install Globally:
70
- npm install -g openliate
71
-
72
- # Windows (PowerShell):
73
- powershell -c "irm https://openliate.tech/install.ps1 | iex"
74
-
75
- # macOS / Linux (cURL):
76
- curl -fsSL https://openliate.tech/install.sh | sh
77
- ```
78
-
79
- > **Prefer 1-Click in Browser?**
80
- > Run OpenLiate instantly inside [GitHub Codespaces](https://codespaces.new/openliate/openliate) with zero local setup.
81
-
82
-
83
- > **Why 5 Lines? The AI Agent Architecture:**
84
- > On stage, NVIDIA CEO Jensen Huang proved that an AI Agent is fundamentally 5 elements: **Model (`L`)**, **Knowledge (`I`)**, **Harness (`A`)**, **Tools (`T`)**, and **Sandbox (`E`)**. LIATE maps this directly into 5 lines of declarative execution.
85
-
86
- ```jsonc
87
- {
88
- "L": "sarvam/sarvam-105b", // [L] LLM / Model: Text, Reasoning (Sarvam 105B), Decisions, Multimodal
89
- "I": { "memory": "sessions/hello-agent" }, // [I] Integration / Knowledge: Session Memory, State, Neon Postgres, Frameworks
90
- "A": { "name": "hello_agent", "intent": "Autonomous Agent", "skills": ["vercel/nextjs"] }, // [A] Agent / Harness: Name, Intent, Vercel skills.sh (1.5M+ skills), ReAct Loop
91
- "T": ["fetch"], // [T] Tools: MCP v2 (Local Stdio & Remote SSE), Custom APIs
92
- "E": { "SARVAM_API_KEY": "$SARVAM_API_KEY" } // [E] Environment / Sandbox: Secrets, Cloud Execution, Guardrails
93
- }
94
- ```
95
-
96
- ```bash
97
- # Execute your agent (reads L·I·A·T·E directly from agent.json)
98
- liate run agent.json "Hello Agent World!"
99
- ```
100
-
101
- > **Prefer writing code directly?**
102
- > Direct language packages for **npm**, **PyPI**, and other OOP class-based languages (TypeScript, Python, Java, C#, etc.) are coming soon.
103
- > On Day 1 (`v0.1.0`), Liate is 100% focused on the zero-dependency **Autonomous Runtime Engine (`agent.json`)**.
104
-
105
- <br>
106
-
107
37
  ---
108
38
 
109
- <div align="center">
110
-
111
- ### Millions of AI Agent Runs on Edge Cloud: Function is an Agent.
112
- #### *Self-Host Anywhere or Bring Your Own Cloud (BYOC) — Free Forever.*
113
-
114
- <br>
115
-
116
- ## **Class is an Agent. Agent is a Function. Function is an API.** *(Soon)*
117
-
118
- #### *Liate Agent Protocol Interface (LAPI) is Your Backend.*
119
-
120
- </div>
121
-
122
- ```typescript
123
- // Coming Soon: Class is an Agent (TypeScript & Python OOP SDK)
124
- class HelloAgent {
125
- L; I; A; T; E; // 1 Class = 5 Properties (L·I·A·T·E) = Same as agent.json
126
- }
127
- ```
128
-
129
- ---
130
-
131
- ## <a id="runtime-engine"></a>[1] Core Engine: OM (Orchestration Module)
132
-
133
- **Liate's Orchestration Module (OM) is the autonomous runtime engine** — just like Docker executes containers and Ollama executes models, **Liate executes AI agents via OM** across the 5 orthogonal layers (`L · I · A · T · E`).
134
-
135
- Liate provides three sovereign deployment targets across local hardware, regional cloud, and worldwide edge:
136
-
137
- ---
138
-
139
- ### #1 Run Locally (Native CLI & 1-Click Docker Engine)
140
-
141
- Run agents anywhere on your own hardware with full Dual-MCP superpowers:
39
+ ## Installation
142
40
 
143
41
  ```bash
144
- # 1. Native Standalone CLI
145
- liate run agent.json "Hello Agent World!"
42
+ # Direct Package:
43
+ npm install openliate
44
+ # or Org-Scoped Package:
45
+ npm install @openliate/liate
146
46
 
147
- # 2. Production Docker Engine (Node 24 + Python 3.14 + Astral uv + npx)
148
- docker compose up -d
47
+ # or via Bun:
48
+ bun add openliate
149
49
  ```
150
50
 
151
- * **Full Dual-MCP Support:** Execute both local Stdio MCP tools (`npx`, `uvx`) and remote HTTP/SSE MCP endpoints.
152
- * **100% Offline & Private:** Zero cloud dependencies, zero external network hops, zero telemetry.
153
- * **Your Keys:** Reads `$SARVAM_API_KEY` (or OpenAI/Claude) directly from your local `.env`.
154
- * **Universal Deployment:** Run on your laptop, Mac/Linux/Windows, any VPS (DigitalOcean, Hetzner, AWS), or private Kubernetes cluster.
155
-
156
51
  ---
157
52
 
158
- ### #2 Run in Regional Cloud (Co-Located Postgres Memory · 2.5M Free Runs/mo)
159
-
160
- Link your Vercel, Neon, and Supabase accounts with Liate in one click to deploy your autonomous agent engine across all three for `< 1ms` database retrieval:
161
-
162
- ```bash
163
- # 1-Click Link & Auto-Deploy across all 3 platforms (2.5M Free Runs/mo for $0.00)
164
- liate link
165
-
166
- # Or link individual clouds:
167
- liate link --neon # Provisions project 'liate' & deploys engine (2 vCPU, 8GB RAM + pgvector)
168
- liate link --vercel # Deploys serverless HTTP engine (1M runs, auto-scales to 0)
169
- liate link --vercel-daemons # Deploys 24/7 containerized background daemon worker (Node 24 + Python + uvx)
170
- liate link --supabase # Deploys Edge Function (500k runs + pgvector store)
171
-
172
- # Relink / refresh tokens and redeploy anytime:
173
- liate relink # Relink all clouds with fresh OAuth
174
- liate relink --supabase # Relink specific provider
175
-
176
- # Unlink & clear saved credentials:
177
- liate unlink --all # Safely clear all tokens from disk and .env.local
178
-
179
- # Optional: set private model keys
180
- liate env set SARVAM_API_KEY="your-key-here"
181
- ```
53
+ ## Quickstart: The Frontier Agent (`SovereignAgent`)
182
54
 
183
- * **Neon Functions (1,000,000 / mo):** Linux Node.js (**2 vCPU, 8 GB RAM**) co-located directly with serverless Postgres + `pgvector` and automated Neon Cron triggers.
184
- * **Vercel Functions & Daemons (1,000,000 / mo):** Fluid Compute functions for Next.js apps, plus 24/7 background agent runners via October 15, 2026 **Vercel Daemons** (`Dockerfile`).
185
- * **Supabase Edge (500,000 / mo):** Deno V8 edge functions co-located with Postgres auth and realtime database webhooks.
186
- * **Zero Cross-Region Latency:** Compute lives in the same data center as your database—eliminating network bottlenecks.
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:
187
56
 
188
- ```sql
189
- -- Schedule a 24/7 autonomous agent to run every hour on your serverless Postgres
190
- INSERT INTO liate_cron (schedule, manifest)
191
- VALUES ('0 * * * *', '{"L": "sarvam/sarvam-105b", "A": {"name": "auditor"}, ...}');
192
- ```
193
-
194
- ---
195
-
196
- ### #3 Run in Worldwide Edge Cloud (Anycast BGP Edge Grid · *Coming Soon*)
197
-
198
- Distribute agents across 300+ to 500+ global Points of Presence (PoPs) using Anycast BGP routing for sub-10ms response times worldwide:
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
+ }
199
79
 
200
- ```bash
201
- # Link your edge cloud providers (Coming Soon in v0.2.0)
202
- liate link --cloudflare
203
- liate link --azion
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);
204
84
  ```
205
85
 
206
- * **Cloudflare Workers (3,000,000 / mo · *Coming Soon*):** Global Google V8 Isolates across 300+ edge cities (100k requests/day free).
207
- * **Azion Edge Functions (3,000,000 / mo · *Coming Soon*):** Distributed V8 Isolates across 500+ global edge locations with edge storage caching and OAuth MCP integration.
208
- * **Fastly Compute (10,000,000 / mo · *Coming Soon*):** Pure WebAssembly (WASM) on Wasmtime/Lucet with microsecond cold starts. Orchestrated via Fastly's `@fastly/mcp` streamable-http remote adapter.
209
- * **Global Low Latency:** Requests terminate at the physical data center closest to the user or webhook sender.
210
-
211
- ---
212
-
213
- ### <a id="run-cloud"></a>Multi-Cloud Capacity Matrix (2.5M Live Runs/mo · 18.5M Total Grid · Zero Vendor Lock-in)
214
-
215
- OpenLiate organizes multi-cloud agent execution across two clean physical topologies: **Regional Cloud** (co-located with your Postgres memory) and **Worldwide Edge Cloud** (sub-10ms global ingress):
216
-
217
- | Layer | Physical Topology | Platforms | Free Monthly Runs | Compute Specs & Architecture | Tool Transport `[T]` | Native Memory `[I]` | Cost |
218
- | :---: | :--- | :--- | :---: | :--- | :--- | :--- | :---: |
219
- | **Local** | **Self-Host Hardware** | **Local / VPS Docker** *(Live)* | **Unlimited** | Node 24 + Python 3.14 + Astral `uvx` | **Dual MCP**: Stdio + Remote | Local File / In-Memory / SQLite | **$0** |
220
- | **#1 Cloud** | **Regional Co-Located** | **Neon Functions (BYON)** *(Live)* | **1,000,000** (1M) | Linux Node.js (**2 vCPU, 8 GB RAM**) | Remote MCP (HTTP/SSE) | Serverless Postgres + `pgvector` + Cron | **$0** |
221
- | **#1 Cloud** | **Regional Co-Located** | **Vercel Functions & Daemons** *(Live)* | **1,000,000** (1M) | Fluid Compute + Docker Daemons | Remote MCP (HTTP/SSE) | Edge Config / KV + `skills.sh` | **$0** |
222
- | **#1 Cloud** | **Regional Co-Located** | **Supabase Edge (BYOS)** *(Live)* | **500,000** (500k) | Deno V8 Engine | Remote MCP (HTTP/SSE) | Postgres + `pgvector` + Realtime | **$0** |
223
- | **#2 Edge** | **Worldwide Anycast Edge** | **Cloudflare Workers** *(Soon)* | **3,000,000** (3M) | Global V8 Isolates (300+ cities) | Remote MCP (HTTP/SSE) | Workers KV & D1 Database | **$0** |
224
- | **#2 Edge** | **Worldwide Anycast Edge** | **Azion Edge Functions** *(Soon)* | **3,000,000** (3M) | Distributed V8 Isolates (500+ PoPs) | Remote MCP (HTTP/SSE) | Edge Storage & KV Caching | **$0** |
225
- | **#2 Edge** | **Worldwide Anycast Edge** | **Fastly Compute (WASM)** *(Soon)* | **10,000,000** (10M) | WebAssembly (Wasmtime/Lucet) | Remote MCP (HTTP/SSE) | Fastly KV & Secret Store | **$0** |
226
- | **LIVE TOTAL** | **Regional Multi-Cloud Mesh** | **Neon + Vercel + Supabase** *(Live)* | **2,500,000 / mo** | **Live Serverless Mesh** | **Dual Stdio & Remote MCP** | **Postgres + pgvector** | **$0.00** |
227
- | **GRID TOTAL** | **Multi-Cloud Sovereign Grid** | **All 6 Sovereign Clouds** | **18,500,000 / mo** | **Decentralized Multi-Cloud Mesh** | **Dual Stdio & Remote MCP** | **Sovereign Multi-Database** | **$0.00** |
228
-
229
86
  ---
230
87
 
231
- ### Deployment Comparison: Self-Host vs. Regional Cloud vs. Worldwide Edge
232
-
233
- | Capability | Local Self-Host (Docker / CLI) | #1 Regional Cloud (Neon, Vercel, Supabase · *Live*) | #2 Worldwide Edge (Cloudflare, Azion, Fastly · *Coming Soon*) |
234
- |---|---|---|---|
235
- | **Environment** | Local machine, VPS, Docker, Kubernetes | AWS Regional Zone (co-located with DB) | 300+ to 500+ Global Anycast Edge PoPs |
236
- | **Tool Transport [T]** | **Dual-MCP**: Stdio (`npx`/`uvx`) + Remote HTTP/SSE | **Remote MCP** (HTTP/SSE) | **Remote MCP** (HTTP/SSE) |
237
- | **Native Memory [I]** | In-Memory / File / Local SQLite / Postgres | Serverless Postgres + `pgvector` + Scheduled Cron | Edge KV / Fastly KV / D1 SQLite |
238
- | **Cost** | **$0** (Free & Open Source forever) | **$0** (Runs on your provider's Free Tier) | **$0** (Runs on your provider's Free Tier) |
239
- | **Account Ownership** | 100% Sovereign (Your Hardware) | 100% BYOC (Your Own Cloud Account) | 100% BYOC (Your Own Cloud Account) |
240
- | **Quick Start** | `docker compose up -d` | `liate link` / `liate link --neon` / `liate link --supabase` | `liate link --cloudflare` / `liate link --azion` |
88
+ ## Instant Run (Zero Install)
241
89
 
242
- ---
243
-
244
- ### Invoke from Any App or Webhook via HTTP (LAPI):
90
+ Run any agent directly without installation using `npx`:
245
91
 
246
92
  ```bash
247
- curl -X POST https://your-engine-endpoint/run \
248
- -H "Content-Type: application/json" \
249
- -d @agent.json
93
+ npx openliate run agent.ts "Fetch https://openliate.tech and summarize"
250
94
  ```
251
95
 
252
96
  ---
253
97
 
254
- ## [2] Benchmark of Liate Runtime Engine *(Coming Soon)*
98
+ ## The 5 Layers (L · I · A · T · E)
255
99
 
256
- Official empirical benchmarks for cold boot time, memory footprint, and native ReAct execution will be published with the `v0.1.0` standalone binary release.
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. |
257
107
 
258
108
  ---
259
109
 
260
- ## <a id="aum-architecture"></a>[3] Architecture: The 5 Layers (AUM)
261
-
262
- Every agent implements the **Agent Unified Manifest (AUM)** across 5 decoupled pillars declared as class properties or manifest keys:
110
+ ## CLI Reference
263
111
 
264
- | Layer | Name | Core (Built-in) | Community PRs |
265
- |---|---|---|---|
266
- | **L** | **Large Models** | Sarvam AI (`hub/llm/sarvam.json`) <sup>IN</sup> | Add Claude, Nano Banana, SeaDance, OpenJev... |
267
- | **I** | **Integration** | Libraries (Zod), in-memory state, persistent memory | Add Neon Postgres, LlamaIndex, Redis, webhooks, repos... |
268
- | **A** | **Agent** | Name, intent, ReAct loop, Vercel `skills.sh` inject | Add subagents, multi-agent swarms, wrap CrewAI/LangGraph... |
269
- | **T** | **Tools** | MCP v2 (Local stdio & Remote SSE) | Add filesystem, GitHub, remote MCP servers... |
270
- | **E** | **Environment** | Pure `.env` key reader & edge sandbox | Add edge isolate configs... |
271
-
272
- > **Unifying the Two Greatest Standards:** Liate natively unifies **Vercel Labs' `skills.sh`** (1.5M+ portable domain skills injected into Layer **[A]**) and **Anthropic's Model Context Protocol (MCP)** (modular tools and actuators in Layer **[T]**). Zero custom glue code required.
273
-
274
- ---
275
-
276
- ## [4] Community & Hub
277
-
278
- Liate's core runtime is minimal, fast, and focused.
279
- The **`hub/`** directory belongs to the community:
280
-
281
- * Add a new LLM -> PR to `hub/llm/`
282
- * Share your agent -> PR to `hub/agents/`
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 |
283
119
 
284
120
  ---
285
121
 
286
- ## [5] License
287
-
288
- [MIT](LICENSE) © 2026 OpenLiate. Free and open source forever.
289
-
290
- <br>
291
-
292
122
  <div align="center">
293
123
 
294
- Built with ❤️ from India to the World
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 🇮🇳 🌍
295
127
 
296
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>