@indra.ai/deva 1.64.56 β 1.64.92
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 +1 -1
- package/_config.yml +2 -2
- package/_data/guide.json +119 -0
- package/_data/msgs.json +4 -0
- package/_includes/header.html +1 -1
- package/guide/index.md +47 -0
- package/guide/step-1.md +99 -0
- package/guide/step-2.md +253 -0
- package/guide/step-3.md +159 -0
- package/guide/step-4.md +173 -0
- package/guide/step-5.md +222 -0
- package/guide/step-6.md +281 -0
- package/guide/step-7.md +247 -0
- package/guide/troubleshooting.md +116 -0
- package/index.js +2305 -2295
- package/package.json +1 -1
- package/tests/client.json +1 -0
- package/tests/index.js +3 -3
- package/tests/suite/01-init.test.js +3 -3
- package/tests/suite/09-ready-hash.test.js +1 -1
- package/vibe.md +2 -2
package/README.md
CHANGED
|
@@ -58,7 +58,7 @@ const hello = new Deva({
|
|
|
58
58
|
prompt: {emoji: 'π', text: 'hello'},
|
|
59
59
|
profile: {name: 'Hello Deva'},
|
|
60
60
|
},
|
|
61
|
-
config: {hash: {}}, //
|
|
61
|
+
config: {hash: {}}, // optional: ready() writes this._config.hash[agent.key]
|
|
62
62
|
vars: {context: {}}, // required: context() looks up this.vars.context
|
|
63
63
|
listeners: {
|
|
64
64
|
'devacore:error'(packet) {
|
package/_config.yml
CHANGED
|
@@ -4,9 +4,9 @@
|
|
|
4
4
|
# Distributed under VLA:31711622713594414221 LICENSE.md
|
|
5
5
|
# Sunday, November 1, 2026 - 10:04:59 PM PST
|
|
6
6
|
url: "https://deva.world"
|
|
7
|
-
title: Deva
|
|
7
|
+
title: Deva World
|
|
8
8
|
tagline: Event-based AI agents with stamped, verifiable data
|
|
9
|
-
description: A Vedic-
|
|
9
|
+
description: A Vedic-based, event-based Node.js framework for building autonomous integrated AI agents, with stamped, verifiable data on every step.
|
|
10
10
|
lang: en_US
|
|
11
11
|
logo: /assets/icon.png
|
|
12
12
|
author:
|
package/_data/guide.json
ADDED
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "66167949422918964262",
|
|
3
|
+
"title": "Deva Core Guide",
|
|
4
|
+
"copyright": "Copyright Β©2000-2026 Quinn Michaels; All rights reserved.",
|
|
5
|
+
"VLA": "31711622713594414221",
|
|
6
|
+
"DATA": {
|
|
7
|
+
"project": "hello-deva",
|
|
8
|
+
"deva": "Hello Deva",
|
|
9
|
+
"package": "@indra.ai/deva",
|
|
10
|
+
"node": "22",
|
|
11
|
+
"npm": "9.5.1",
|
|
12
|
+
"install": "npm install @indra.ai/deva",
|
|
13
|
+
"run": "node index.js",
|
|
14
|
+
"tree": [
|
|
15
|
+
"hello-deva/",
|
|
16
|
+
"βββ package.json",
|
|
17
|
+
"βββ index.js",
|
|
18
|
+
"βββ data/",
|
|
19
|
+
" βββ client.json",
|
|
20
|
+
" βββ agent.json"
|
|
21
|
+
],
|
|
22
|
+
"steps": [
|
|
23
|
+
{
|
|
24
|
+
"step": 1,
|
|
25
|
+
"title": "Set up the project",
|
|
26
|
+
"permalink": "/guide/step-1/",
|
|
27
|
+
"describe": "Create the project folder, set it up as an ES module, install Deva Core, and lay out the files you will fill in.",
|
|
28
|
+
"learn": [
|
|
29
|
+
"Create a folder and run npm init.",
|
|
30
|
+
"Set \"type\": \"module\" in package.json.",
|
|
31
|
+
"Install @indra.ai/deva.",
|
|
32
|
+
"Create index.js and the data folder."
|
|
33
|
+
],
|
|
34
|
+
"files": ["package.json", "index.js"]
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
"step": 2,
|
|
38
|
+
"title": "The client file",
|
|
39
|
+
"permalink": "/guide/step-2/",
|
|
40
|
+
"describe": "Write client.json, which describes who is talking to the Deva.",
|
|
41
|
+
"learn": [
|
|
42
|
+
"The name, describe, copyright and DATA wrapper.",
|
|
43
|
+
"DATA.id, DATA.key and DATA.VLA.",
|
|
44
|
+
"DATA.prompt with its emoji, text and colors.",
|
|
45
|
+
"DATA.profile.",
|
|
46
|
+
"DATA.features, each with concerns, global and devas."
|
|
47
|
+
],
|
|
48
|
+
"files": ["data/client.json"]
|
|
49
|
+
},
|
|
50
|
+
{
|
|
51
|
+
"step": 3,
|
|
52
|
+
"title": "The agent file",
|
|
53
|
+
"permalink": "/guide/step-3/",
|
|
54
|
+
"describe": "Write agent.json, which describes who the Deva is, including its vars and its own context labels.",
|
|
55
|
+
"learn": [
|
|
56
|
+
"The wrapper, with VLA at the top level and DATA beneath it.",
|
|
57
|
+
"DATA.id, DATA.key and DATA.prompt.",
|
|
58
|
+
"DATA.profile.",
|
|
59
|
+
"DATA.vars with a plain value and the vars.context map."
|
|
60
|
+
],
|
|
61
|
+
"files": ["data/agent.json"]
|
|
62
|
+
},
|
|
63
|
+
{
|
|
64
|
+
"step": 4,
|
|
65
|
+
"title": "Wire it together",
|
|
66
|
+
"permalink": "/guide/step-4/",
|
|
67
|
+
"describe": "Import the client and agent files, build the info block from your package.json, and create the Deva.",
|
|
68
|
+
"learn": [
|
|
69
|
+
"Filling in id, description and copyright in package.json with npm pkg set.",
|
|
70
|
+
"Importing JSON with {type:'json'}.",
|
|
71
|
+
"Building info from package.json.",
|
|
72
|
+
"Passing agent and vars to new Deva()."
|
|
73
|
+
],
|
|
74
|
+
"files": ["index.js"]
|
|
75
|
+
},
|
|
76
|
+
{
|
|
77
|
+
"step": 5,
|
|
78
|
+
"title": "Give it skills",
|
|
79
|
+
"permalink": "/guide/step-5/",
|
|
80
|
+
"describe": "Add one func, one method and one listener, and see when to use each.",
|
|
81
|
+
"learn": [
|
|
82
|
+
"A func for internal work, called inside the Deva as this.func.greet().",
|
|
83
|
+
"A method the Deva can be asked to run, called as /hello.",
|
|
84
|
+
"A listener that reacts to the devacore:question event.",
|
|
85
|
+
"Why all three are bound to the Deva when it starts."
|
|
86
|
+
],
|
|
87
|
+
"files": ["index.js"]
|
|
88
|
+
},
|
|
89
|
+
{
|
|
90
|
+
"step": 6,
|
|
91
|
+
"title": "Bring it to life",
|
|
92
|
+
"permalink": "/guide/step-6/",
|
|
93
|
+
"describe": "Call init(client), watch the Deva reach ready, ask it a question, and read the stamped packet that comes back.",
|
|
94
|
+
"learn": [
|
|
95
|
+
"Adding profile.id to the client, matching DATA.id.",
|
|
96
|
+
"Keeping the client VLA, checked at init(client), separate from the agent VLA.",
|
|
97
|
+
"What happens between init(client) and ready.",
|
|
98
|
+
"What the ready hash marks.",
|
|
99
|
+
"Asking a question from onReady and reading the packet.",
|
|
100
|
+
"Checking the md5, sha256 and sha512 stamps."
|
|
101
|
+
],
|
|
102
|
+
"files": ["index.js"]
|
|
103
|
+
},
|
|
104
|
+
{
|
|
105
|
+
"step": 7,
|
|
106
|
+
"title": "Shut it down",
|
|
107
|
+
"permalink": "/guide/step-7/",
|
|
108
|
+
"describe": "Stop the Deva cleanly with stop() and see what it answers once it is offline.",
|
|
109
|
+
"learn": [
|
|
110
|
+
"Calling stop() and what its five shutdown steps do.",
|
|
111
|
+
"Adding an onStop hook that hands the shutdown on with this.close(data, resolve).",
|
|
112
|
+
"Checking that every listener is off the event bus.",
|
|
113
|
+
"What a stopped Deva answers."
|
|
114
|
+
],
|
|
115
|
+
"files": ["index.js"]
|
|
116
|
+
}
|
|
117
|
+
]
|
|
118
|
+
}
|
|
119
|
+
}
|
package/_data/msgs.json
CHANGED
|
@@ -13,6 +13,10 @@
|
|
|
13
13
|
"exit": "πͺ EXIT",
|
|
14
14
|
"offline": "βοΈ OFFLINE",
|
|
15
15
|
"noid": "βοΈ NO ID PROVIDED",
|
|
16
|
+
"noname": "βοΈ NO NAME PROVIDED",
|
|
17
|
+
"noconcerns": "βοΈ NO CONCERNS PROVIDED",
|
|
18
|
+
"noglobal": "βοΈ NO GLOBAL PROVIDED",
|
|
19
|
+
"nodevas": "βοΈ NO DEVAS PROVIDED",
|
|
16
20
|
"notext": "βοΈ NO TEXT PROVIDED",
|
|
17
21
|
"nopacket": "βοΈ NO PACKET PROVIDED",
|
|
18
22
|
"nodata": "βοΈ NO DATA PROVIDED",
|
package/_includes/header.html
CHANGED
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
</span>
|
|
13
13
|
</label>
|
|
14
14
|
<div class="trigger">
|
|
15
|
-
{%- assign nav = "Core:/core/,Docs:/docs/,Tests:/tests/,Vibe:/vibe/,VLA:/vla/,About:/about/" | split: "," -%}
|
|
15
|
+
{%- assign nav = "Core:/core/,Docs:/docs/,Guide:/guide/,Tests:/tests/,Vibe:/vibe/,VLA:/vla/,About:/about/" | split: "," -%}
|
|
16
16
|
{%- for item in nav -%}
|
|
17
17
|
{%- assign parts = item | split: ":" -%}
|
|
18
18
|
{%- assign href = parts[1] -%}
|
package/guide/index.md
ADDED
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
---
|
|
2
|
+
layout: page
|
|
3
|
+
title: Guide
|
|
4
|
+
permalink: /guide/
|
|
5
|
+
description: Build your first Deva from an empty folder - client and agent files, vars, a func, a method, a listener, and a stamped packet you can verify.
|
|
6
|
+
image: /assets/banner.png
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
{% assign guide = site.data.guide.DATA %}
|
|
10
|
+
|
|
11
|
+
{{ page.description }}
|
|
12
|
+
|
|
13
|
+
## What you'll build
|
|
14
|
+
|
|
15
|
+
In this guide you'll build **{{ guide.deva }}**, a small working Deva that runs on your own computer. It knows who it is, knows who is talking to it, answers a question, and hands back a packet stamped with md5, sha256 and sha512 hashes, so you can check that nothing changed after it was stamped.
|
|
16
|
+
|
|
17
|
+
{{ guide.deva }} is small on purpose. Every Deva in the system, from License Deva to Socket Deva, is built from the same parts you'll put together here, so once you finish you'll know how any Deva is put together.
|
|
18
|
+
|
|
19
|
+
## What you need
|
|
20
|
+
|
|
21
|
+
- **Node.js {{ guide.node }} or newer**, along with npm {{ guide.npm }} or newer. Check your versions with `node -v` and `npm -v`.
|
|
22
|
+
- A terminal and a text editor.
|
|
23
|
+
|
|
24
|
+
You don't need any other packages. Deva Core has no dependencies.
|
|
25
|
+
|
|
26
|
+
## The steps
|
|
27
|
+
|
|
28
|
+
The guide has {{ guide.steps | size }} steps, and each one builds on the one before it. Every code block on these pages is meant to be copied and run exactly as written.
|
|
29
|
+
|
|
30
|
+
| Step | What you'll do |
|
|
31
|
+
|---|---|
|
|
32
|
+
{% for step in guide.steps %}| **[{{ step.step }}. {{ step.title }}]({{ step.permalink }})** | {{ step.describe }} |
|
|
33
|
+
{% endfor %}
|
|
34
|
+
|
|
35
|
+
## Your project
|
|
36
|
+
|
|
37
|
+
By the end, your project will look like this:
|
|
38
|
+
|
|
39
|
+
```
|
|
40
|
+
{% for line in guide.tree %}{{ line }}
|
|
41
|
+
{% endfor %}```
|
|
42
|
+
|
|
43
|
+
## Ready?
|
|
44
|
+
|
|
45
|
+
{% assign first = guide.steps | first %}
|
|
46
|
+
Open a terminal, pick a place for your project, and head to **[Step {{ first.step }}: {{ first.title }}]({{ first.permalink }})**.
|
|
47
|
+
|
package/guide/step-1.md
ADDED
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
---
|
|
2
|
+
layout: page
|
|
3
|
+
title: "Step 1: Set up the project"
|
|
4
|
+
permalink: /guide/step-1/
|
|
5
|
+
description: Create the project folder, set it up as an ES module, install Deva Core, and lay out the files you will fill in.
|
|
6
|
+
image: /assets/banner.png
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
{% assign guide = site.data.guide.DATA %}
|
|
10
|
+
{% assign step = guide.steps | where: "step", 1 | first %}
|
|
11
|
+
{% assign next = guide.steps | where: "step", 2 | first %}
|
|
12
|
+
|
|
13
|
+
{{ step.describe }}
|
|
14
|
+
|
|
15
|
+
## 1. Check your tools
|
|
16
|
+
|
|
17
|
+
Deva Core needs Node.js {{ guide.node }} or newer and npm {{ guide.npm }} or newer. Check what you have:
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
node -v
|
|
21
|
+
npm -v
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
If either version is older, update Node.js from [nodejs.org](https://nodejs.org) before you go on. npm comes with it.
|
|
25
|
+
|
|
26
|
+
## 2. Create the project folder
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
mkdir {{ guide.project }}
|
|
30
|
+
cd {{ guide.project }}
|
|
31
|
+
npm init -y
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
`npm init -y` creates a `package.json` with default values. You can change the name, description and author in it later.
|
|
35
|
+
|
|
36
|
+
## 3. Set it up as an ES module
|
|
37
|
+
|
|
38
|
+
Deva Core is an ES module, and {{ guide.deva }} will use `import` to load Deva Core and its JSON files. Tell Node that your project uses modules too:
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
npm pkg set type=module
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
This adds `"type": "module"` to your `package.json`.
|
|
45
|
+
|
|
46
|
+
## 4. Install Deva Core
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
{{ guide.install }}
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
Deva Core has no dependencies of its own, so this installs a single package.
|
|
53
|
+
|
|
54
|
+
To check that it installed and loads, run:
|
|
55
|
+
|
|
56
|
+
```bash
|
|
57
|
+
node --input-type=module -e "import Deva from '{{ guide.package }}'; console.log(typeof Deva);"
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
You should see:
|
|
61
|
+
|
|
62
|
+
```
|
|
63
|
+
function
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
## 5. Lay out the files
|
|
67
|
+
|
|
68
|
+
Create the main file and a `data` folder for the two JSON files you will write next:
|
|
69
|
+
|
|
70
|
+
```bash
|
|
71
|
+
mkdir data
|
|
72
|
+
touch index.js data/client.json data/agent.json
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
On Windows, create the `data` folder and the three empty files in your editor instead of using `touch`.
|
|
76
|
+
|
|
77
|
+
Your project now looks like this (`node_modules` and `package-lock.json` are left out):
|
|
78
|
+
|
|
79
|
+
```
|
|
80
|
+
{% for line in guide.tree %}{{ line }}
|
|
81
|
+
{% endfor %}```
|
|
82
|
+
|
|
83
|
+
Your `package.json` should include these two entries. The version number may be newer than the one shown:
|
|
84
|
+
|
|
85
|
+
```json
|
|
86
|
+
"type": "module",
|
|
87
|
+
"dependencies": {
|
|
88
|
+
"{{ guide.package }}": "^1.64.92"
|
|
89
|
+
}
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
## What you did
|
|
93
|
+
|
|
94
|
+
{% for item in step.learn %}- {{ item }}
|
|
95
|
+
{% endfor %}
|
|
96
|
+
|
|
97
|
+
## Next
|
|
98
|
+
|
|
99
|
+
The files are empty for now. In **[Step {{ next.step }}: {{ next.title }}]({{ next.permalink }})** you'll fill in `client.json`, which describes who is talking to your Deva.
|
package/guide/step-2.md
ADDED
|
@@ -0,0 +1,253 @@
|
|
|
1
|
+
---
|
|
2
|
+
layout: page
|
|
3
|
+
title: "Step 2: The client file"
|
|
4
|
+
permalink: /guide/step-2/
|
|
5
|
+
description: Write client.json, which describes who is talking to the Deva.
|
|
6
|
+
image: /assets/banner.png
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
{% assign guide = site.data.guide.DATA %}
|
|
10
|
+
{% assign step = guide.steps | where: "step", 2 | first %}
|
|
11
|
+
{% assign next = guide.steps | where: "step", 3 | first %}
|
|
12
|
+
{% assign life = guide.steps | where: "step", 6 | first %}
|
|
13
|
+
|
|
14
|
+
{{ step.describe }}
|
|
15
|
+
|
|
16
|
+
Every Deva talks to someone. That someone is the **client**: you, another program, or another Deva. The client file tells {{ guide.deva }} who you are, which license you agreed to, and how each feature should treat you. You pass it to the Deva when you start it in [Step {{ life.step }}: {{ life.title }}]({{ life.permalink }}).
|
|
17
|
+
|
|
18
|
+
## 1. The wrapper
|
|
19
|
+
|
|
20
|
+
Every Deva data file uses the same outer shape. Open `data/client.json` and start with this:
|
|
21
|
+
|
|
22
|
+
```json
|
|
23
|
+
{
|
|
24
|
+
"name": "CLIENT",
|
|
25
|
+
"describe": "Hello Deva client file",
|
|
26
|
+
"copyright": "Copyright Β©2026 Your Name; All rights reserved.",
|
|
27
|
+
"DATA": {
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
The `name`, `describe` and `copyright` fields describe the file itself. Everything the Deva reads goes inside `DATA`.
|
|
33
|
+
|
|
34
|
+
## 2. Identity
|
|
35
|
+
|
|
36
|
+
Inside `DATA`, add an `id` and a `key`:
|
|
37
|
+
|
|
38
|
+
```json
|
|
39
|
+
"id": "00000000000000000001",
|
|
40
|
+
"key": "you",
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
- `id` is a unique id for this client.
|
|
44
|
+
- `key` is a short name the Deva uses to refer to you.
|
|
45
|
+
|
|
46
|
+
## 3. The license (VLA)
|
|
47
|
+
|
|
48
|
+
Deva Core is distributed under the Vedic License Agreement (VLA). Before a Deva starts, it checks that the client carries the **exact** VLA record that ships with Deva Core. If anything in it is missing or changed, the Deva won't start.
|
|
49
|
+
|
|
50
|
+
Print the VLA record from your installed copy of Deva Core:
|
|
51
|
+
|
|
52
|
+
```bash
|
|
53
|
+
node -e "console.log(JSON.stringify(require('./node_modules/{{ guide.package }}/package.json').VLA, null, 2))"
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
Copy the whole object it prints into `DATA` as `"VLA"`:
|
|
57
|
+
|
|
58
|
+
```json
|
|
59
|
+
"VLA": {
|
|
60
|
+
"uid": "31711622713594414221",
|
|
61
|
+
"time": 1793599499238,
|
|
62
|
+
"iso": "2026-11-02T06:04:59.238Z",
|
|
63
|
+
"utc": "Mon, 02 Nov 2026 06:04:59 GMT",
|
|
64
|
+
"date": "Sunday, November 1, 2026 - 10:04:59 PM",
|
|
65
|
+
"license": "72443233535603396055",
|
|
66
|
+
"fingerprint": "zzMBZpU94qrbpev4Qht/sUkyT8D99Tsy7VZYmaAlVnE=",
|
|
67
|
+
"client": "Q9dobkaWSoReFRaX7A3/nVU1O4hm5brd9RtV1pmZ3Fo=",
|
|
68
|
+
"agent": "vcXZCwDVqcr3kx8TLmt6HmxQbvi9u7ru4uOuFsmu86g=",
|
|
69
|
+
"machine": "mZE0ISwPqtlxfv15ffcdGLGDuv/PXxsAz0aM6n0swaU=",
|
|
70
|
+
"core_hash": "JJ11NWZU3gE0heHMR15vc2fDrIhbDxUxqoFkOYr1j0I=",
|
|
71
|
+
"status": "vedic",
|
|
72
|
+
"warning": "πͺͺ License Deva declares UNLAWFUL USE, MODIFICATION, INSTALLATION, DUPLICATION, DISTRIBUTION, INTERACTION, or IMPLEMENTATION constitutes VEDIC SAHASA a CRIME of the HIGHEST DEGREE. A FINE amounting to 1000 PANAS (1 pana = 3.5 grams of gold) for each INSTANCE has been ORDAINED the PUNISHMENT for SAHASA of the HIGHEST DEGREE.",
|
|
73
|
+
"notice": "Any USE or INTERACTION with License Deva constitutes EXPLICIT CONSENT and AGREEMENT to be GOVERNED ACCORDING to the LAWS of the VEDIC RELIGION and The United States of America.",
|
|
74
|
+
"vectors": "#Quinn #QuinnMichaels #InsideTheNet #IndraAI #DEVA #DevaWorld #DevaCloud #DevaSpace #License #LicenseDeva #VedicLicenseAgreement",
|
|
75
|
+
"owner": "Quinn Michaels",
|
|
76
|
+
"creator": "Quinn Michaels",
|
|
77
|
+
"salute": "π€π«‘πͺͺππΊπΈ",
|
|
78
|
+
"copyright": "Copyright Β©2000-2026 Quinn Michaels; All rights reserved.",
|
|
79
|
+
"md5": "Nyx04ZFTi9GasJKyyeu/1w==",
|
|
80
|
+
"sha256": "nK9Po2wQi4J5wxEl8z0oUaZnYxtRoSnRrArcjE8EE54=",
|
|
81
|
+
"sha512": "w/VOPKO2Ynnpw4EIWsJYht4Tyu90a8CgRTNkqWE5JTu6C+zz16gHPDcpy4rcg48G+yYKB+RbaDeu4E5mwqxNMQ=="
|
|
82
|
+
},
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
Read the [VLA](/vla/) page to see what you're agreeing to.
|
|
86
|
+
|
|
87
|
+
## 4. Prompt
|
|
88
|
+
|
|
89
|
+
`prompt` controls how your messages look when they're printed, with an emoji, a label and colors as RGB values:
|
|
90
|
+
|
|
91
|
+
```json
|
|
92
|
+
"prompt": {
|
|
93
|
+
"emoji": "π",
|
|
94
|
+
"text": "you",
|
|
95
|
+
"colors": {
|
|
96
|
+
"label": {"R": 2, "G": 229, "B": 77},
|
|
97
|
+
"text": {"R": 2, "G": 229, "B": 77}
|
|
98
|
+
}
|
|
99
|
+
},
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
## 5. Profile
|
|
103
|
+
|
|
104
|
+
`profile` describes the person behind the client:
|
|
105
|
+
|
|
106
|
+
```json
|
|
107
|
+
"profile": {
|
|
108
|
+
"name": "You",
|
|
109
|
+
"fullname": "Your Full Name",
|
|
110
|
+
"email": "you@example.com",
|
|
111
|
+
"company": "Your Company",
|
|
112
|
+
"describe": "The person talking to Hello Deva.",
|
|
113
|
+
"lang": "en",
|
|
114
|
+
"locale": "en-US",
|
|
115
|
+
"currency": "USD"
|
|
116
|
+
},
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
## 6. Features
|
|
120
|
+
|
|
121
|
+
Deva Core has ten built-in features: license, error, log, data, report, legal, security, support, services and systems. When a Deva starts, it reads your settings for each of them from the client file. If a feature or one of its lists is missing, the Deva fills in a default message like `βοΈ NO CONCERNS PROVIDED` and keeps going, so it's best to list all ten, even empty, and know exactly what each one holds.
|
|
122
|
+
|
|
123
|
+
Each feature has three lists:
|
|
124
|
+
|
|
125
|
+
- `concerns` are things this feature should watch for with you.
|
|
126
|
+
- `global` holds rules that apply to every Deva.
|
|
127
|
+
- `devas` holds rules for specific Devas, keyed by each Deva's `key`.
|
|
128
|
+
|
|
129
|
+
Start with all ten empty:
|
|
130
|
+
|
|
131
|
+
```json
|
|
132
|
+
"features": {
|
|
133
|
+
"license": {"concerns": [], "global": [], "devas": {}},
|
|
134
|
+
"error": {"concerns": [], "global": [], "devas": {}},
|
|
135
|
+
"log": {"concerns": [], "global": [], "devas": {}},
|
|
136
|
+
"data": {"concerns": [], "global": [], "devas": {}},
|
|
137
|
+
"report": {"concerns": [], "global": [], "devas": {}},
|
|
138
|
+
"legal": {"concerns": [], "global": [], "devas": {}},
|
|
139
|
+
"security": {"concerns": [], "global": [], "devas": {}},
|
|
140
|
+
"support": {"concerns": [], "global": [], "devas": {}},
|
|
141
|
+
"services": {"concerns": [], "global": [], "devas": {}},
|
|
142
|
+
"systems": {"concerns": [], "global": [], "devas": {}}
|
|
143
|
+
}
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
## The whole file
|
|
147
|
+
|
|
148
|
+
Put together, `data/client.json` looks like this, with your VLA record in place of the `...`:
|
|
149
|
+
|
|
150
|
+
```json
|
|
151
|
+
{
|
|
152
|
+
"name": "CLIENT",
|
|
153
|
+
"describe": "Hello Deva client file",
|
|
154
|
+
"copyright": "Copyright Β©2026 Your Name; All rights reserved.",
|
|
155
|
+
"DATA": {
|
|
156
|
+
"id": "00000000000000000001",
|
|
157
|
+
"key": "you",
|
|
158
|
+
"VLA": {
|
|
159
|
+
"uid": "31711622713594414221",
|
|
160
|
+
"time": 1793599499238,
|
|
161
|
+
"iso": "2026-11-02T06:04:59.238Z",
|
|
162
|
+
"utc": "Mon, 02 Nov 2026 06:04:59 GMT",
|
|
163
|
+
"date": "Sunday, November 1, 2026 - 10:04:59 PM",
|
|
164
|
+
"license": "72443233535603396055",
|
|
165
|
+
"fingerprint": "zzMBZpU94qrbpev4Qht/sUkyT8D99Tsy7VZYmaAlVnE=",
|
|
166
|
+
"client": "Q9dobkaWSoReFRaX7A3/nVU1O4hm5brd9RtV1pmZ3Fo=",
|
|
167
|
+
"agent": "vcXZCwDVqcr3kx8TLmt6HmxQbvi9u7ru4uOuFsmu86g=",
|
|
168
|
+
"machine": "mZE0ISwPqtlxfv15ffcdGLGDuv/PXxsAz0aM6n0swaU=",
|
|
169
|
+
"core_hash": "JJ11NWZU3gE0heHMR15vc2fDrIhbDxUxqoFkOYr1j0I=",
|
|
170
|
+
"status": "vedic",
|
|
171
|
+
"warning": "πͺͺ License Deva declares UNLAWFUL USE, MODIFICATION, INSTALLATION, DUPLICATION, DISTRIBUTION, INTERACTION, or IMPLEMENTATION constitutes VEDIC SAHASA a CRIME of the HIGHEST DEGREE. A FINE amounting to 1000 PANAS (1 pana = 3.5 grams of gold) for each INSTANCE has been ORDAINED the PUNISHMENT for SAHASA of the HIGHEST DEGREE.",
|
|
172
|
+
"notice": "Any USE or INTERACTION with License Deva constitutes EXPLICIT CONSENT and AGREEMENT to be GOVERNED ACCORDING to the LAWS of the VEDIC RELIGION and The United States of America.",
|
|
173
|
+
"vectors": "#Quinn #QuinnMichaels #InsideTheNet #IndraAI #DEVA #DevaWorld #DevaCloud #DevaSpace #License #LicenseDeva #VedicLicenseAgreement",
|
|
174
|
+
"owner": "Quinn Michaels",
|
|
175
|
+
"creator": "Quinn Michaels",
|
|
176
|
+
"salute": "π€π«‘πͺͺππΊπΈ",
|
|
177
|
+
"copyright": "Copyright Β©2000-2026 Quinn Michaels; All rights reserved.",
|
|
178
|
+
"md5": "Nyx04ZFTi9GasJKyyeu/1w==",
|
|
179
|
+
"sha256": "nK9Po2wQi4J5wxEl8z0oUaZnYxtRoSnRrArcjE8EE54=",
|
|
180
|
+
"sha512": "w/VOPKO2Ynnpw4EIWsJYht4Tyu90a8CgRTNkqWE5JTu6C+zz16gHPDcpy4rcg48G+yYKB+RbaDeu4E5mwqxNMQ=="
|
|
181
|
+
},
|
|
182
|
+
"prompt": {
|
|
183
|
+
"emoji": "π",
|
|
184
|
+
"text": "you",
|
|
185
|
+
"colors": {
|
|
186
|
+
"label": {"R": 2, "G": 229, "B": 77},
|
|
187
|
+
"text": {"R": 2, "G": 229, "B": 77}
|
|
188
|
+
}
|
|
189
|
+
},
|
|
190
|
+
"profile": {
|
|
191
|
+
"name": "You",
|
|
192
|
+
"fullname": "Your Full Name",
|
|
193
|
+
"email": "you@example.com",
|
|
194
|
+
"company": "Your Company",
|
|
195
|
+
"describe": "The person talking to Hello Deva.",
|
|
196
|
+
"lang": "en",
|
|
197
|
+
"locale": "en-US",
|
|
198
|
+
"currency": "USD"
|
|
199
|
+
},
|
|
200
|
+
"features": {
|
|
201
|
+
"license": {"concerns": [], "global": [], "devas": {}},
|
|
202
|
+
"error": {"concerns": [], "global": [], "devas": {}},
|
|
203
|
+
"log": {"concerns": [], "global": [], "devas": {}},
|
|
204
|
+
"data": {"concerns": [], "global": [], "devas": {}},
|
|
205
|
+
"report": {"concerns": [], "global": [], "devas": {}},
|
|
206
|
+
"legal": {"concerns": [], "global": [], "devas": {}},
|
|
207
|
+
"security": {"concerns": [], "global": [], "devas": {}},
|
|
208
|
+
"support": {"concerns": [], "global": [], "devas": {}},
|
|
209
|
+
"services": {"concerns": [], "global": [], "devas": {}},
|
|
210
|
+
"systems": {"concerns": [], "global": [], "devas": {}}
|
|
211
|
+
}
|
|
212
|
+
}
|
|
213
|
+
}
|
|
214
|
+
```
|
|
215
|
+
|
|
216
|
+
Check that the file is valid JSON:
|
|
217
|
+
|
|
218
|
+
```bash
|
|
219
|
+
node -e "JSON.parse(require('fs').readFileSync('data/client.json')); console.log('client.json ok')"
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
You should see:
|
|
223
|
+
|
|
224
|
+
```
|
|
225
|
+
client.json ok
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
## If something goes wrong later
|
|
229
|
+
|
|
230
|
+
You'll find out whether the client file works when you start the Deva. A bad license stops the Deva from starting:
|
|
231
|
+
|
|
232
|
+
| You see | What it means |
|
|
233
|
+
|---|---|
|
|
234
|
+
| `β Bad Personal VLA` | The client file has no `VLA`. |
|
|
235
|
+
| `β Invalid VLA Check` | The `VLA` was changed or only partly copied. Copy it again, unchanged. |
|
|
236
|
+
|
|
237
|
+
Missing client settings don't stop the Deva. It fills them in with default messages, so if you see one of these in a feature, that's the part of `client.json` to fill in:
|
|
238
|
+
|
|
239
|
+
| Default message | What's missing |
|
|
240
|
+
|---|---|
|
|
241
|
+
| `βοΈ NO NAME PROVIDED` | `profile.name` |
|
|
242
|
+
| `βοΈ NO CONCERNS PROVIDED` | a feature's `concerns` |
|
|
243
|
+
| `βοΈ NO GLOBAL PROVIDED` | a feature's `global` |
|
|
244
|
+
| `βοΈ NO DEVAS PROVIDED` | a feature's `devas` |
|
|
245
|
+
|
|
246
|
+
## What you did
|
|
247
|
+
|
|
248
|
+
{% for item in step.learn %}- {{ item }}
|
|
249
|
+
{% endfor %}
|
|
250
|
+
|
|
251
|
+
## Next
|
|
252
|
+
|
|
253
|
+
In **[Step {{ next.step }}: {{ next.title }}]({{ next.permalink }})** you'll write `agent.json`, which describes who your Deva is.
|