@gentid/sdk 1.0.2 → 1.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.
- package/LICENSE +21 -0
- package/dist/client.d.ts +28 -1
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +48 -0
- package/dist/client.js.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js.map +1 -1
- package/dist/types.d.ts +49 -0
- package/dist/types.d.ts.map +1 -1
- package/package.json +11 -2
- package/README.md +0 -130
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 GentID (https://gentid.com)
|
|
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/dist/client.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { GentIDClientOptions, Agent, CreatedAgent, SignResult, VerifyResult, VerificationRecord, VerificationType, ListAgentsResult, LookupResult } from './types';
|
|
1
|
+
import type { GentIDClientOptions, Agent, CreatedAgent, SignResult, VerifyResult, VerificationRecord, VerificationType, ListAgentsResult, LookupResult, AgentPermissions, AgentTrustGrant, BadgeData, PermissionToken, VerifiedToken, ApprovalRequest } from './types';
|
|
2
2
|
export declare class GentIDError extends Error {
|
|
3
3
|
readonly statusCode: number;
|
|
4
4
|
readonly code?: string | undefined;
|
|
@@ -28,5 +28,32 @@ export declare class GentIDClient {
|
|
|
28
28
|
lookupAgent(agentId: string): Promise<LookupResult>;
|
|
29
29
|
requestVerification(agentId: string, type: VerificationType): Promise<VerificationRecord>;
|
|
30
30
|
getVerificationStatus(agentId: string): Promise<VerificationRecord[]>;
|
|
31
|
+
getPermissions(agentId: string): Promise<AgentPermissions>;
|
|
32
|
+
setPermissions(agentId: string, permissions: Record<string, unknown>): Promise<AgentPermissions>;
|
|
33
|
+
listTrustedAgents(agentId: string): Promise<AgentTrustGrant[]>;
|
|
34
|
+
grantTrust(grantorAgentId: string, params: {
|
|
35
|
+
granteeAgentId: string;
|
|
36
|
+
scope?: string[];
|
|
37
|
+
expiresAt?: string;
|
|
38
|
+
}): Promise<AgentTrustGrant>;
|
|
39
|
+
revokeTrust(grantorAgentId: string, trustId: string): Promise<void>;
|
|
40
|
+
/** Returns badge data + embed snippet. No API key required. */
|
|
41
|
+
getBadge(agentId: string): Promise<BadgeData>;
|
|
42
|
+
/**
|
|
43
|
+
* Issue a signed permission token for an agent.
|
|
44
|
+
* The JWT encodes the agent's identity + permissions and can be verified
|
|
45
|
+
* by any third party without calling GentID (offline-verifiable).
|
|
46
|
+
*/
|
|
47
|
+
getToken(agentId: string): Promise<PermissionToken>;
|
|
48
|
+
/**
|
|
49
|
+
* Verify a permission token issued by GentID.
|
|
50
|
+
* No API key required — useful for third-party server verification.
|
|
51
|
+
*/
|
|
52
|
+
verifyToken(token: string): Promise<VerifiedToken>;
|
|
53
|
+
/**
|
|
54
|
+
* Request owner approval for an action above the agent's configured threshold.
|
|
55
|
+
* The org owner is notified in real time and has 15 minutes to approve or reject.
|
|
56
|
+
*/
|
|
57
|
+
requestApproval(agentId: string, action: string, metadata?: Record<string, unknown>): Promise<ApprovalRequest>;
|
|
31
58
|
}
|
|
32
59
|
//# sourceMappingURL=client.d.ts.map
|
package/dist/client.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,KAAK,EACL,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACb,MAAM,SAAS,CAAC;AAEjB,qBAAa,WAAY,SAAQ,KAAK;aAElB,UAAU,EAAE,MAAM;aAElB,IAAI,CAAC,EAAE,MAAM;gBAFb,UAAU,EAAE,MAAM,EAClC,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA;CAKhC;AAID,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,EAAE,OAA0B,EAAE,MAAM,EAAE,EAAE,mBAAmB;YAKzD,OAAO;IA0BrB,4FAA4F;IACtF,WAAW,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAI3E,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAIpC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAOnG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAIvC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAIxC,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAM3C,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIlE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAMjG,gFAAgF;IAC1E,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAInD,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIzF,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,KAAK,EACL,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,eAAe,EACf,aAAa,EACb,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB,qBAAa,WAAY,SAAQ,KAAK;aAElB,UAAU,EAAE,MAAM;aAElB,IAAI,CAAC,EAAE,MAAM;gBAFb,UAAU,EAAE,MAAM,EAClC,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA;CAKhC;AAID,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,EAAE,OAA0B,EAAE,MAAM,EAAE,EAAE,mBAAmB;YAKzD,OAAO;IA0BrB,4FAA4F;IACtF,WAAW,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAI3E,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAIpC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAOnG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAIvC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAIxC,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAM3C,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIlE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAMjG,gFAAgF;IAC1E,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAInD,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIzF,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAOrE,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI1D,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAMhG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAI9D,UAAU,CACd,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACvE,OAAO,CAAC,eAAe,CAAC;IAIrB,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzE,+DAA+D;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAMnD;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAIzD;;;OAGG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIxD;;;OAGG;IACG,eAAe,CACnB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,eAAe,CAAC;CAM5B"}
|
package/dist/client.js
CHANGED
|
@@ -76,6 +76,54 @@ class GentIDClient {
|
|
|
76
76
|
const params = new URLSearchParams({ agentId });
|
|
77
77
|
return this.request('GET', `/verification/status?${params}`);
|
|
78
78
|
}
|
|
79
|
+
// ─── Permissions ──────────────────────────────────────────────────────────────
|
|
80
|
+
async getPermissions(agentId) {
|
|
81
|
+
return this.request('GET', `/portal/agents/${encodeURIComponent(agentId)}/permissions`);
|
|
82
|
+
}
|
|
83
|
+
async setPermissions(agentId, permissions) {
|
|
84
|
+
return this.request('PUT', `/portal/agents/${encodeURIComponent(agentId)}/permissions`, { permissions });
|
|
85
|
+
}
|
|
86
|
+
// ─── Trust ────────────────────────────────────────────────────────────────────
|
|
87
|
+
async listTrustedAgents(agentId) {
|
|
88
|
+
return this.request('GET', `/portal/agents/${encodeURIComponent(agentId)}/trust`);
|
|
89
|
+
}
|
|
90
|
+
async grantTrust(grantorAgentId, params) {
|
|
91
|
+
return this.request('POST', `/portal/agents/${encodeURIComponent(grantorAgentId)}/trust`, params);
|
|
92
|
+
}
|
|
93
|
+
async revokeTrust(grantorAgentId, trustId) {
|
|
94
|
+
return this.request('DELETE', `/portal/agents/${encodeURIComponent(grantorAgentId)}/trust/${encodeURIComponent(trustId)}`);
|
|
95
|
+
}
|
|
96
|
+
// ─── Badge ────────────────────────────────────────────────────────────────────
|
|
97
|
+
/** Returns badge data + embed snippet. No API key required. */
|
|
98
|
+
async getBadge(agentId) {
|
|
99
|
+
return this.request('GET', `/badge/${encodeURIComponent(agentId)}`, undefined, false);
|
|
100
|
+
}
|
|
101
|
+
// ─── Delegation ───────────────────────────────────────────────────────────────
|
|
102
|
+
/**
|
|
103
|
+
* Issue a signed permission token for an agent.
|
|
104
|
+
* The JWT encodes the agent's identity + permissions and can be verified
|
|
105
|
+
* by any third party without calling GentID (offline-verifiable).
|
|
106
|
+
*/
|
|
107
|
+
async getToken(agentId) {
|
|
108
|
+
return this.request('GET', `/portal/agents/${encodeURIComponent(agentId)}/token`);
|
|
109
|
+
}
|
|
110
|
+
/**
|
|
111
|
+
* Verify a permission token issued by GentID.
|
|
112
|
+
* No API key required — useful for third-party server verification.
|
|
113
|
+
*/
|
|
114
|
+
async verifyToken(token) {
|
|
115
|
+
return this.request('POST', '/verification/verify-token', { token }, false);
|
|
116
|
+
}
|
|
117
|
+
/**
|
|
118
|
+
* Request owner approval for an action above the agent's configured threshold.
|
|
119
|
+
* The org owner is notified in real time and has 15 minutes to approve or reject.
|
|
120
|
+
*/
|
|
121
|
+
async requestApproval(agentId, action, metadata) {
|
|
122
|
+
return this.request('POST', `/agents/${encodeURIComponent(agentId)}/request-approval`, {
|
|
123
|
+
action,
|
|
124
|
+
metadata: metadata ?? {},
|
|
125
|
+
});
|
|
126
|
+
}
|
|
79
127
|
}
|
|
80
128
|
exports.GentIDClient = GentIDClient;
|
|
81
129
|
//# sourceMappingURL=client.js.map
|
package/dist/client.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;;
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
1
|
export { GentIDClient, GentIDError } from './client';
|
|
2
|
-
export type { Agent, CreatedAgent, SignResult, VerifyResult, VerificationRecord, VerificationType, VerificationStatus, AgentStatus, LookupResult, ListAgentsResult, GentIDClientOptions, } from './types';
|
|
2
|
+
export type { Agent, CreatedAgent, SignResult, VerifyResult, VerificationRecord, VerificationType, VerificationStatus, AgentStatus, LookupResult, ListAgentsResult, GentIDClientOptions, AgentPermissions, AgentTrustGrant, BadgeData, PermissionToken, VerifiedToken, ApprovalRequest, } from './types';
|
|
3
3
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACrD,YAAY,EACV,KAAK,EACL,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACrD,YAAY,EACV,KAAK,EACL,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,eAAe,EACf,aAAa,EACb,eAAe,GAChB,MAAM,SAAS,CAAC"}
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAqD;AAA5C,sGAAA,YAAY,OAAA;AAAE,qGAAA,WAAW,OAAA;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAqD;AAA5C,sGAAA,YAAY,OAAA;AAAE,qGAAA,WAAW,OAAA;AAqBlC,eAAe;AACf,EAAE;AACF,8CAA8C;AAC9C,EAAE;AACF,gEAAgE;AAChE,EAAE;AACF,wFAAwF;AACxF,4DAA4D;AAC5D,EAAE;AACF,kFAAkF;AAClF,6FAA6F;AAC7F,EAAE;AACF,uCAAuC;AACvC,uDAAuD"}
|
package/dist/types.d.ts
CHANGED
|
@@ -43,6 +43,55 @@ export interface LookupResult {
|
|
|
43
43
|
algorithm: string;
|
|
44
44
|
owner: string;
|
|
45
45
|
issuedAt: string;
|
|
46
|
+
/** 0–100 trust score computed from age, owner verification, signature volume, and verified records. */
|
|
47
|
+
trustScore: number;
|
|
48
|
+
}
|
|
49
|
+
export interface AgentPermissions {
|
|
50
|
+
agentId: string;
|
|
51
|
+
permissions: Record<string, unknown>;
|
|
52
|
+
}
|
|
53
|
+
export interface AgentTrustGrant {
|
|
54
|
+
id: string;
|
|
55
|
+
granteeAgentId: string;
|
|
56
|
+
scope: string[];
|
|
57
|
+
expiresAt: string | null;
|
|
58
|
+
createdAt: string;
|
|
59
|
+
}
|
|
60
|
+
export interface BadgeData {
|
|
61
|
+
agentId: string;
|
|
62
|
+
name: string;
|
|
63
|
+
status: AgentStatus;
|
|
64
|
+
owner: string;
|
|
65
|
+
trustScore: number;
|
|
66
|
+
issuedAt: string;
|
|
67
|
+
embedUrl: string;
|
|
68
|
+
embedSnippet: string;
|
|
69
|
+
}
|
|
70
|
+
export interface PermissionToken {
|
|
71
|
+
token: string;
|
|
72
|
+
expiresAt: string;
|
|
73
|
+
}
|
|
74
|
+
export interface VerifiedToken {
|
|
75
|
+
valid: true;
|
|
76
|
+
agentId: string;
|
|
77
|
+
agentName: string;
|
|
78
|
+
owner: string;
|
|
79
|
+
status: string;
|
|
80
|
+
permissions: Record<string, unknown>;
|
|
81
|
+
issuedAt: string;
|
|
82
|
+
expiresAt: string;
|
|
83
|
+
}
|
|
84
|
+
export interface ApprovalRequest {
|
|
85
|
+
id: string;
|
|
86
|
+
agentId: string;
|
|
87
|
+
agentName: string;
|
|
88
|
+
orgId: string;
|
|
89
|
+
action: string;
|
|
90
|
+
metadata: Record<string, unknown>;
|
|
91
|
+
status: 'pending' | 'approved' | 'rejected' | 'expired';
|
|
92
|
+
requestedAt: string;
|
|
93
|
+
resolvedAt: string | null;
|
|
94
|
+
expiresAt: string;
|
|
46
95
|
}
|
|
47
96
|
export interface ListAgentsResult {
|
|
48
97
|
agents: Agent[];
|
package/dist/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;AAC7D,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAC7D,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEnE,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAa,SAAQ,KAAK;IACzC,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,7 +1,16 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@gentid/sdk",
|
|
3
|
-
"version": "1.0
|
|
4
|
-
"description": "TypeScript SDK for GentID — cryptographic identity for AI agents",
|
|
3
|
+
"version": "1.1.0",
|
|
4
|
+
"description": "TypeScript SDK for GentID — cryptographic identity, permissions, and agent gateway for AI agents",
|
|
5
|
+
"license": "MIT",
|
|
6
|
+
"homepage": "https://gentid.com",
|
|
7
|
+
"repository": {
|
|
8
|
+
"type": "git",
|
|
9
|
+
"url": "https://github.com/010101G/gentid-sdk.git"
|
|
10
|
+
},
|
|
11
|
+
"bugs": {
|
|
12
|
+
"url": "https://github.com/010101G/gentid-sdk/issues"
|
|
13
|
+
},
|
|
5
14
|
"main": "dist/index.js",
|
|
6
15
|
"types": "dist/index.d.ts",
|
|
7
16
|
"keywords": [
|
package/README.md
DELETED
|
@@ -1,130 +0,0 @@
|
|
|
1
|
-
# @gentid/sdk
|
|
2
|
-
|
|
3
|
-
TypeScript SDK for [GentID](https://gentid.com) — cryptographic identity infrastructure for AI agents.
|
|
4
|
-
|
|
5
|
-
## Installation
|
|
6
|
-
|
|
7
|
-
```bash
|
|
8
|
-
npm install @gentid/sdk
|
|
9
|
-
```
|
|
10
|
-
|
|
11
|
-
Requires Node.js 18 or later.
|
|
12
|
-
|
|
13
|
-
## Quick start
|
|
14
|
-
|
|
15
|
-
```typescript
|
|
16
|
-
import { GentIDClient } from '@gentid/sdk';
|
|
17
|
-
|
|
18
|
-
const gentid = new GentIDClient({
|
|
19
|
-
apiKey: process.env.GENTID_API_KEY!, // gid_live_...
|
|
20
|
-
});
|
|
21
|
-
|
|
22
|
-
// 1. Create an agent identity
|
|
23
|
-
const agent = await gentid.createAgent({ name: 'payments-bot', owner: 'acme-corp' });
|
|
24
|
-
console.log(agent.id); // gentic:agent:a3f9d2c1e8b4
|
|
25
|
-
|
|
26
|
-
// ⚠ Store agent.privateKey securely — it is returned only once, never again.
|
|
27
|
-
|
|
28
|
-
// 2. Sign any action
|
|
29
|
-
const { signature } = await gentid.signMessage(agent.id, 'approve-payment-$500');
|
|
30
|
-
|
|
31
|
-
// 3. Verify from anywhere — no API key needed
|
|
32
|
-
const { valid } = await gentid.verifySignature(agent.id, 'approve-payment-$500', signature);
|
|
33
|
-
console.log(valid); // true
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
## API reference
|
|
37
|
-
|
|
38
|
-
### Agents
|
|
39
|
-
|
|
40
|
-
```typescript
|
|
41
|
-
// Create a new agent identity
|
|
42
|
-
const agent: CreatedAgent = await gentid.createAgent({ name: string, owner: string });
|
|
43
|
-
// agent.privateKey is returned ONCE — store it in your secrets vault
|
|
44
|
-
|
|
45
|
-
// Get an agent
|
|
46
|
-
const agent: Agent = await gentid.getAgent(agentId);
|
|
47
|
-
|
|
48
|
-
// List agents by owner
|
|
49
|
-
const { agents, total } = await gentid.listAgents('acme-corp', { limit: 50, offset: 0 });
|
|
50
|
-
|
|
51
|
-
// Status management
|
|
52
|
-
await gentid.suspendAgent(agentId); // temporarily disable
|
|
53
|
-
await gentid.reactivateAgent(agentId); // re-enable
|
|
54
|
-
await gentid.revokeAgent(agentId); // permanent — cannot be undone
|
|
55
|
-
```
|
|
56
|
-
|
|
57
|
-
### Signatures
|
|
58
|
-
|
|
59
|
-
```typescript
|
|
60
|
-
// Sign a message with an agent's private key (stored server-side)
|
|
61
|
-
const { signature, messageHash, logId } = await gentid.signMessage(agentId, message);
|
|
62
|
-
|
|
63
|
-
// Verify a signature
|
|
64
|
-
const { valid } = await gentid.verifySignature(agentId, message, signature);
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
### Verification
|
|
68
|
-
|
|
69
|
-
```typescript
|
|
70
|
-
// Public lookup — no API key required
|
|
71
|
-
// Anyone can verify an agent's identity and public key
|
|
72
|
-
const identity: LookupResult = await gentid.lookupAgent(agentId);
|
|
73
|
-
// { id, name, status, publicKey, algorithm, owner, issuedAt }
|
|
74
|
-
|
|
75
|
-
// Request human/domain verification for an agent
|
|
76
|
-
const record = await gentid.requestVerification(agentId, 'manual'); // 'email' | 'domain' | 'manual'
|
|
77
|
-
|
|
78
|
-
// Check verification status
|
|
79
|
-
const records = await gentid.getVerificationStatus(agentId);
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
## Error handling
|
|
83
|
-
|
|
84
|
-
All methods throw `GentIDError` on failure:
|
|
85
|
-
|
|
86
|
-
```typescript
|
|
87
|
-
import { GentIDClient, GentIDError } from '@gentid/sdk';
|
|
88
|
-
|
|
89
|
-
try {
|
|
90
|
-
await gentid.getAgent('gentic:agent:invalid');
|
|
91
|
-
} catch (err) {
|
|
92
|
-
if (err instanceof GentIDError) {
|
|
93
|
-
console.error(err.statusCode); // 404
|
|
94
|
-
console.error(err.message); // "Agent not found"
|
|
95
|
-
console.error(err.code); // "AGENT_NOT_FOUND"
|
|
96
|
-
}
|
|
97
|
-
}
|
|
98
|
-
```
|
|
99
|
-
|
|
100
|
-
## Configuration
|
|
101
|
-
|
|
102
|
-
```typescript
|
|
103
|
-
const gentid = new GentIDClient({
|
|
104
|
-
apiKey: 'gid_live_...', // required
|
|
105
|
-
baseUrl: 'https://api.gentid.com', // optional — this is the default
|
|
106
|
-
});
|
|
107
|
-
```
|
|
108
|
-
|
|
109
|
-
## Verifying webhook signatures
|
|
110
|
-
|
|
111
|
-
If you use GentID webhooks, verify the `X-GentID-Signature` header:
|
|
112
|
-
|
|
113
|
-
```typescript
|
|
114
|
-
import crypto from 'crypto';
|
|
115
|
-
|
|
116
|
-
function verifyWebhook(secret: string, rawBody: string, signatureHeader: string): boolean {
|
|
117
|
-
const [tPart, v1Part] = signatureHeader.split(',');
|
|
118
|
-
const timestamp = tPart.replace('t=', '');
|
|
119
|
-
const expected = v1Part.replace('v1=', '');
|
|
120
|
-
const sig = crypto
|
|
121
|
-
.createHmac('sha256', secret)
|
|
122
|
-
.update(`${timestamp}.${rawBody}`)
|
|
123
|
-
.digest('hex');
|
|
124
|
-
return crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expected));
|
|
125
|
-
}
|
|
126
|
-
```
|
|
127
|
-
|
|
128
|
-
## License
|
|
129
|
-
|
|
130
|
-
MIT
|