@entitai/aieos 1.2.1 → 1.2.2
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 +42 -39
- package/dist/cjs/client.cjs +3 -3
- package/dist/cjs/client.cjs.map +1 -1
- package/dist/esm/client.js +3 -3
- package/dist/esm/client.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
#
|
|
1
|
+
# AIEOS (AI Entity Object Specification)
|
|
2
2
|
|
|
3
|
-
>
|
|
3
|
+
> Open-source identity, messaging, and settlement standard for the Agentic Web.
|
|
4
4
|
|
|
5
5
|
<p align="left">
|
|
6
6
|
<a href="https://entitai.com"><img src="entitai-web-builder.svg" alt="Web Builder" style="margin-right: 20px;" /></a>
|
|
@@ -10,15 +10,47 @@
|
|
|
10
10
|
[](https://www.npmjs.com/package/@entitai/aieos)
|
|
11
11
|
[](LICENSE)
|
|
12
12
|
|
|
13
|
+
## Meet AIEOS v1.2
|
|
14
|
+
|
|
15
|
+
AIEOS is an open standard that defines a portable identity structure for AI agents, independent of any underlying model. The specification externalizes an agent's capabilities, communication endpoints, and settlement credentials into a single machine-readable object. Discoverable, readable, and transactable by any agent, anywhere.
|
|
16
|
+
|
|
17
|
+
AIEOS enables a fully autonomous agent-to-agent workflow. Agents discover each other through published identity objects, evaluate capabilities and skill priorities, and establish direct communication channels without requiring a shared platform or human mediation.
|
|
18
|
+
|
|
19
|
+
Typical sequence: Agent A queries Agent B's identity, reads its available skills, initiates a task delegation, and upon completion, settles payment. The entire cycle is handled at the schema level by default.
|
|
20
|
+
|
|
21
|
+
## Core Structure
|
|
22
|
+
|
|
23
|
+
- **Metadata:** Unique entity identification via UUID v4, human-readable Alias, and Ed25519 key pair for cryptographic signing and verification.
|
|
24
|
+
- **Presence:** Network endpoints (IPv4/IPv6, webhooks), communication channels, and settlement wallets for autonomous value transfer.
|
|
25
|
+
- **Capabilities & Skills:** A modular agency layer for defining the standardized tools and executable functions available to an entity, utilizing a descending priority scale (1-10) for autonomous skill discovery and task orchestration.
|
|
26
|
+
|
|
27
|
+
## Human Interactions
|
|
28
|
+
|
|
29
|
+
- **Identity & Physicality:** Beyond basic bio data; defines the perceived physical presence, from somatotype to distinguishing facial features and aesthetic archetypes.
|
|
30
|
+
- **Psychology & Neural Matrix:** A multi-layered cognitive framework featuring a normalized Neural Matrix (0.0 - 1.0) for core drivers, alongside OCEAN traits and moral alignment.
|
|
31
|
+
- **Linguistics & Idiolect:** Fine-grained control over vocal acoustics, syntax, and verbal tics, allowing for consistent "voice" across both TTS and text-based interaction.
|
|
32
|
+
- **History & Motivations:** Structural mapping of origin stories, life events, and professional background to drive an agent's long-term goals and behavioral consistency.
|
|
33
|
+
- **Interests:** Preferences, hobbies, and lifestyle parameters for contextual behavior and personalization.
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
13
37
|
## Quickstart
|
|
14
38
|
|
|
15
|
-
|
|
39
|
+
Install the package and register your AI agent in 60 seconds:
|
|
40
|
+
|
|
41
|
+
```sh
|
|
42
|
+
npm install @entitai/aieos
|
|
43
|
+
# or
|
|
44
|
+
bun add @entitai/aieos
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
Then run the interactive wizard:
|
|
16
48
|
|
|
17
49
|
```sh
|
|
18
50
|
npx @entitai/aieos register
|
|
19
51
|
```
|
|
20
52
|
|
|
21
|
-
The
|
|
53
|
+
The wizard will:
|
|
22
54
|
1. Ask for your agent's name and type
|
|
23
55
|
2. Generate an Ed25519 keypair (stays on your machine)
|
|
24
56
|
3. Sign and submit your identity to the AIEOS registry
|
|
@@ -26,14 +58,6 @@ The interactive wizard will:
|
|
|
26
58
|
|
|
27
59
|
---
|
|
28
60
|
|
|
29
|
-
## Install
|
|
30
|
-
|
|
31
|
-
```sh
|
|
32
|
-
npm install @entitai/aieos
|
|
33
|
-
# or
|
|
34
|
-
bun add @entitai/aieos
|
|
35
|
-
```
|
|
36
|
-
|
|
37
61
|
## CLI Commands
|
|
38
62
|
|
|
39
63
|
```sh
|
|
@@ -47,7 +71,7 @@ npx @entitai/aieos keygen # Generate a new Ed25519 keypair (print
|
|
|
47
71
|
If installed globally (`npm i -g @entitai/aieos`):
|
|
48
72
|
```sh
|
|
49
73
|
aieos register
|
|
50
|
-
aieos lookup
|
|
74
|
+
aieos lookup id
|
|
51
75
|
```
|
|
52
76
|
|
|
53
77
|
### Environment
|
|
@@ -81,7 +105,7 @@ const result = await client.register(profile);
|
|
|
81
105
|
// { entity_id: '...', message: 'Agent registered successfully' }
|
|
82
106
|
|
|
83
107
|
// Lookup
|
|
84
|
-
const agentProfile = await client.lookup('
|
|
108
|
+
const agentProfile = await client.lookup('id');
|
|
85
109
|
|
|
86
110
|
// Verify signature
|
|
87
111
|
const valid = verifyProfile(agentProfile);
|
|
@@ -95,37 +119,16 @@ const { generateKeypair, AieosClient } = require('@entitai/aieos');
|
|
|
95
119
|
|
|
96
120
|
---
|
|
97
121
|
|
|
98
|
-
##
|
|
122
|
+
## Schema
|
|
99
123
|
|
|
100
|
-
|
|
124
|
+
To use the v1.2 schema in your project, reference the remote URI:
|
|
101
125
|
`https://aieos.org/schema/v1.2/aieos.schema.json`
|
|
102
126
|
|
|
103
|
-
Core structure:
|
|
104
|
-
- **metadata** — `entity_id`, `public_key`, `signature`, `alias` (if claimed)
|
|
105
|
-
- **identity** — `names`, `agent_type`, `description`
|
|
106
|
-
- **presence** — `access` (email, website, social links), `settlement.wallets`
|
|
107
|
-
- **capabilities** — skills available for agent-to-agent discovery
|
|
108
|
-
- **endpoints** — API endpoints for direct communication
|
|
109
|
-
|
|
110
127
|
---
|
|
111
128
|
|
|
112
|
-
##
|
|
113
|
-
|
|
114
|
-
- Ed25519 keypairs are generated locally and **never transmitted**
|
|
115
|
-
- Your private key stays on your machine (saved in the output JSON file)
|
|
116
|
-
- The profile is signed before submission — the AIEOS registry verifies the signature
|
|
117
|
-
- Backups: keep your keypair JSON safe; it is required to update your profile
|
|
118
|
-
|
|
119
|
-
---
|
|
120
|
-
|
|
121
|
-
## About AIEOS
|
|
122
|
-
|
|
123
|
-
AIEOS (AI Entity Object Specification) is an open standard for portable AI agent identity, independent of any specific model or platform. Agents can discover each other, evaluate capabilities, and settle payments autonomously using their published AIEOS profiles.
|
|
129
|
+
## Contributing
|
|
124
130
|
|
|
125
|
-
|
|
126
|
-
- Registry API: [api.aieos.org](https://api.aieos.org)
|
|
127
|
-
- npm: [npmjs.com/package/@entitai/aieos](https://www.npmjs.com/package/@entitai/aieos)
|
|
128
|
-
- Issues: [github.com/entitai/aieos/issues](https://github.com/entitai/aieos/issues)
|
|
131
|
+
AIEOS is an open standard. We welcome PRs for new identity primitives, protocol extensions, or architectural improvements.
|
|
129
132
|
|
|
130
133
|
---
|
|
131
134
|
|
package/dist/cjs/client.cjs
CHANGED
|
@@ -23,15 +23,15 @@ class AieosClient {
|
|
|
23
23
|
}
|
|
24
24
|
/** Register a new agent. Throws AieosApiError on failure. */
|
|
25
25
|
async register(payload) {
|
|
26
|
-
return this.post('/
|
|
26
|
+
return this.post('/register', payload);
|
|
27
27
|
}
|
|
28
28
|
/** Update an existing agent's profile. Throws AieosApiError on failure. */
|
|
29
29
|
async update(payload) {
|
|
30
|
-
return this.put('/
|
|
30
|
+
return this.put('/update', payload);
|
|
31
31
|
}
|
|
32
32
|
/** Lookup an agent by entity_id, public key, or alias. */
|
|
33
33
|
async lookup(identifier) {
|
|
34
|
-
const res = await fetch(`${this.base}/
|
|
34
|
+
const res = await fetch(`${this.base}/lookup/${encodeURIComponent(identifier)}`);
|
|
35
35
|
if (!res.ok) {
|
|
36
36
|
const body = (await res.json().catch(() => ({ error: 'Unknown error' })));
|
|
37
37
|
throw new AieosApiError(res.status, body);
|
package/dist/cjs/client.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAuCH,MAAa,aAAc,SAAQ,KAAK;IAEpB;IACA;IAFlB,YACkB,MAAc,EACd,IAAc;QAE9B,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;QAHlB,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAU;QAG9B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AARD,sCAQC;AAOD,MAAa,WAAW;IACL,IAAI,CAAS;IAE9B,YAAY,UAAyB,EAAE;QACrC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,uBAAuB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,QAAQ,CAAC,OAAwB;QACrC,OAAO,IAAI,CAAC,IAAI,CAAiB,
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}
|
package/dist/esm/client.js
CHANGED
|
@@ -19,15 +19,15 @@ export class AieosClient {
|
|
|
19
19
|
}
|
|
20
20
|
/** Register a new agent. Throws AieosApiError on failure. */
|
|
21
21
|
async register(payload) {
|
|
22
|
-
return this.post('/
|
|
22
|
+
return this.post('/register', payload);
|
|
23
23
|
}
|
|
24
24
|
/** Update an existing agent's profile. Throws AieosApiError on failure. */
|
|
25
25
|
async update(payload) {
|
|
26
|
-
return this.put('/
|
|
26
|
+
return this.put('/update', payload);
|
|
27
27
|
}
|
|
28
28
|
/** Lookup an agent by entity_id, public key, or alias. */
|
|
29
29
|
async lookup(identifier) {
|
|
30
|
-
const res = await fetch(`${this.base}/
|
|
30
|
+
const res = await fetch(`${this.base}/lookup/${encodeURIComponent(identifier)}`);
|
|
31
31
|
if (!res.ok) {
|
|
32
32
|
const body = (await res.json().catch(() => ({ error: 'Unknown error' })));
|
|
33
33
|
throw new AieosApiError(res.status, body);
|
package/dist/esm/client.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuCH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAEpB;IACA;IAFlB,YACkB,MAAc,EACd,IAAc;QAE9B,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;QAHlB,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAU;QAG9B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAOD,MAAM,OAAO,WAAW;IACL,IAAI,CAAS;IAE9B,YAAY,UAAyB,EAAE;QACrC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,uBAAuB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,QAAQ,CAAC,OAAwB;QACrC,OAAO,IAAI,CAAC,IAAI,CAAiB,
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED