@gentid/sdk 1.0.1 → 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GentID (https://gentid.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import type { GentIDClientOptions, Agent, CreatedAgent, SignResult, VerifyResult, VerificationRecord, VerificationType, ListAgentsResult, LookupResult } from './types';
+import type { GentIDClientOptions, Agent, CreatedAgent, SignResult, VerifyResult, VerificationRecord, VerificationType, ListAgentsResult, LookupResult, AgentPermissions, AgentTrustGrant, BadgeData, PermissionToken, VerifiedToken, ApprovalRequest } from './types';
 export declare class GentIDError extends Error {
     readonly statusCode: number;
     readonly code?: string | undefined;
@@ -28,5 +28,32 @@ export declare class GentIDClient {
     lookupAgent(agentId: string): Promise<LookupResult>;
     requestVerification(agentId: string, type: VerificationType): Promise<VerificationRecord>;
     getVerificationStatus(agentId: string): Promise<VerificationRecord[]>;
+    getPermissions(agentId: string): Promise<AgentPermissions>;
+    setPermissions(agentId: string, permissions: Record<string, unknown>): Promise<AgentPermissions>;
+    listTrustedAgents(agentId: string): Promise<AgentTrustGrant[]>;
+    grantTrust(grantorAgentId: string, params: {
+        granteeAgentId: string;
+        scope?: string[];
+        expiresAt?: string;
+    }): Promise<AgentTrustGrant>;
+    revokeTrust(grantorAgentId: string, trustId: string): Promise<void>;
+    /** Returns badge data + embed snippet. No API key required. */
+    getBadge(agentId: string): Promise<BadgeData>;
+    /**
+     * Issue a signed permission token for an agent.
+     * The JWT encodes the agent's identity + permissions and can be verified
+     * by any third party without calling GentID (offline-verifiable).
+     */
+    getToken(agentId: string): Promise<PermissionToken>;
+    /**
+     * Verify a permission token issued by GentID.
+     * No API key required — useful for third-party server verification.
+     */
+    verifyToken(token: string): Promise<VerifiedToken>;
+    /**
+     * Request owner approval for an action above the agent's configured threshold.
+     * The org owner is notified in real time and has 15 minutes to approve or reject.
+     */
+    requestApproval(agentId: string, action: string, metadata?: Record<string, unknown>): Promise<ApprovalRequest>;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -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;CAI5E"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -76,6 +76,54 @@ class GentIDClient {
         const params = new URLSearchParams({ agentId });
         return this.request('GET', `/verification/status?${params}`);
     }
+    // ─── Permissions ──────────────────────────────────────────────────────────────
+    async getPermissions(agentId) {
+        return this.request('GET', `/portal/agents/${encodeURIComponent(agentId)}/permissions`);
+    }
+    async setPermissions(agentId, permissions) {
+        return this.request('PUT', `/portal/agents/${encodeURIComponent(agentId)}/permissions`, { permissions });
+    }
+    // ─── Trust ────────────────────────────────────────────────────────────────────
+    async listTrustedAgents(agentId) {
+        return this.request('GET', `/portal/agents/${encodeURIComponent(agentId)}/trust`);
+    }
+    async grantTrust(grantorAgentId, params) {
+        return this.request('POST', `/portal/agents/${encodeURIComponent(grantorAgentId)}/trust`, params);
+    }
+    async revokeTrust(grantorAgentId, trustId) {
+        return this.request('DELETE', `/portal/agents/${encodeURIComponent(grantorAgentId)}/trust/${encodeURIComponent(trustId)}`);
+    }
+    // ─── Badge ────────────────────────────────────────────────────────────────────
+    /** Returns badge data + embed snippet. No API key required. */
+    async getBadge(agentId) {
+        return this.request('GET', `/badge/${encodeURIComponent(agentId)}`, undefined, false);
+    }
+    // ─── Delegation ───────────────────────────────────────────────────────────────
+    /**
+     * Issue a signed permission token for an agent.
+     * The JWT encodes the agent's identity + permissions and can be verified
+     * by any third party without calling GentID (offline-verifiable).
+     */
+    async getToken(agentId) {
+        return this.request('GET', `/portal/agents/${encodeURIComponent(agentId)}/token`);
+    }
+    /**
+     * Verify a permission token issued by GentID.
+     * No API key required — useful for third-party server verification.
+     */
+    async verifyToken(token) {
+        return this.request('POST', '/verification/verify-token', { token }, false);
+    }
+    /**
+     * Request owner approval for an action above the agent's configured threshold.
+     * The org owner is notified in real time and has 15 minutes to approve or reject.
+     */
+    async requestApproval(agentId, action, metadata) {
+        return this.request('POST', `/agents/${encodeURIComponent(agentId)}/request-approval`, {
+            action,
+            metadata: metadata ?? {},
+        });
+    }
 }
 exports.GentIDClient = GentIDClient;
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { GentIDClient, GentIDError } from './client';
-export type { Agent, CreatedAgent, SignResult, VerifyResult, VerificationRecord, VerificationType, VerificationStatus, AgentStatus, LookupResult, ListAgentsResult, GentIDClientOptions, } from './types';
+export type { Agent, CreatedAgent, SignResult, VerifyResult, VerificationRecord, VerificationType, VerificationStatus, AgentStatus, LookupResult, ListAgentsResult, GentIDClientOptions, AgentPermissions, AgentTrustGrant, BadgeData, PermissionToken, VerifiedToken, ApprovalRequest, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -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,GACpB,MAAM,SAAS,CAAC"}
+{"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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAqD;AAA5C,sGAAA,YAAY,OAAA;AAAE,qGAAA,WAAW,OAAA;AAelC,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"}
+{"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

@@ -43,6 +43,55 @@ export interface LookupResult {
     algorithm: string;
     owner: string;
     issuedAt: string;
+    /** 0–100 trust score computed from age, owner verification, signature volume, and verified records. */
+    trustScore: number;
+}
+export interface AgentPermissions {
+    agentId: string;
+    permissions: Record<string, unknown>;
+}
+export interface AgentTrustGrant {
+    id: string;
+    granteeAgentId: string;
+    scope: string[];
+    expiresAt: string | null;
+    createdAt: string;
+}
+export interface BadgeData {
+    agentId: string;
+    name: string;
+    status: AgentStatus;
+    owner: string;
+    trustScore: number;
+    issuedAt: string;
+    embedUrl: string;
+    embedSnippet: string;
+}
+export interface PermissionToken {
+    token: string;
+    expiresAt: string;
+}
+export interface VerifiedToken {
+    valid: true;
+    agentId: string;
+    agentName: string;
+    owner: string;
+    status: string;
+    permissions: Record<string, unknown>;
+    issuedAt: string;
+    expiresAt: string;
+}
+export interface ApprovalRequest {
+    id: string;
+    agentId: string;
+    agentName: string;
+    orgId: string;
+    action: string;
+    metadata: Record<string, unknown>;
+    status: 'pending' | 'approved' | 'rejected' | 'expired';
+    requestedAt: string;
+    resolvedAt: string | null;
+    expiresAt: string;
 }
 export interface ListAgentsResult {
     agents: Agent[];

package/dist/types.d.ts.map

@@ -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;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,9 +1,56 @@
 {
   "name": "@gentid/sdk",
-  "version": "1.0.1",
-  "description": "TypeScript SDK for GentID — cryptographic identity for AI agents",
+  "version": "1.1.0",
+  "description": "TypeScript SDK for GentID — cryptographic identity, permissions, and agent gateway for AI agents",
+  "license": "MIT",
+  "homepage": "https://gentid.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/010101G/gentid-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/010101G/gentid-sdk/issues"
+  },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "keywords": [
+    "gentid",
+    "ai-agent",
+    "ai-identity",
+    "agent-identity",
+    "cryptographic-identity",
+    "ed25519",
+    "digital-signature",
+    "signature-verification",
+    "agent-verification",
+    "identity",
+    "identity-management",
+    "public-key",
+    "public-key-cryptography",
+    "keypair",
+    "signing",
+    "verification",
+    "trust",
+    "zero-trust",
+    "ai",
+    "artificial-intelligence",
+    "autonomous-agent",
+    "llm",
+    "agent",
+    "multi-agent",
+    "agentic",
+    "sdk",
+    "api-client",
+    "typescript",
+    "node",
+    "security",
+    "authentication",
+    "authorization",
+    "webhook",
+    "blockchain-alternative",
+    "provenance",
+    "audit-trail"
+  ],
   "files": [
     "dist"
   ],

package/README.md

@@ -1,130 +0,0 @@
-# @gentid/sdk
-
-TypeScript SDK for [GentID](https://gentid.com) — cryptographic identity infrastructure for AI agents.
-
-## Installation
-
-```bash
-npm install @gentid/sdk
-```
-
-Requires Node.js 18 or later.
-
-## Quick start
-
-```typescript
-import { GentIDClient } from '@gentid/sdk';
-
-const gentid = new GentIDClient({
-  apiKey: process.env.GENTID_API_KEY!, // gid_live_...
-});
-
-// 1. Create an agent identity
-const agent = await gentid.createAgent({ name: 'payments-bot', owner: 'acme-corp' });
-console.log(agent.id); // gentic:agent:a3f9d2c1e8b4
-
-// ⚠ Store agent.privateKey securely — it is returned only once, never again.
-
-// 2. Sign any action
-const { signature } = await gentid.signMessage(agent.id, 'approve-payment-$500');
-
-// 3. Verify from anywhere — no API key needed
-const { valid } = await gentid.verifySignature(agent.id, 'approve-payment-$500', signature);
-console.log(valid); // true
-```
-
-## API reference
-
-### Agents
-
-```typescript
-// Create a new agent identity
-const agent: CreatedAgent = await gentid.createAgent({ name: string, owner: string });
-// agent.privateKey is returned ONCE — store it in your secrets vault
-
-// Get an agent
-const agent: Agent = await gentid.getAgent(agentId);
-
-// List agents by owner
-const { agents, total } = await gentid.listAgents('acme-corp', { limit: 50, offset: 0 });
-
-// Status management
-await gentid.suspendAgent(agentId);    // temporarily disable
-await gentid.reactivateAgent(agentId); // re-enable
-await gentid.revokeAgent(agentId);     // permanent — cannot be undone
-```
-
-### Signatures
-
-```typescript
-// Sign a message with an agent's private key (stored server-side)
-const { signature, messageHash, logId } = await gentid.signMessage(agentId, message);
-
-// Verify a signature
-const { valid } = await gentid.verifySignature(agentId, message, signature);
-```
-
-### Verification
-
-```typescript
-// Public lookup — no API key required
-// Anyone can verify an agent's identity and public key
-const identity: LookupResult = await gentid.lookupAgent(agentId);
-// { id, name, status, publicKey, algorithm, owner, issuedAt }
-
-// Request human/domain verification for an agent
-const record = await gentid.requestVerification(agentId, 'manual'); // 'email' | 'domain' | 'manual'
-
-// Check verification status
-const records = await gentid.getVerificationStatus(agentId);
-```
-
-## Error handling
-
-All methods throw `GentIDError` on failure:
-
-```typescript
-import { GentIDClient, GentIDError } from '@gentid/sdk';
-
-try {
-  await gentid.getAgent('gentic:agent:invalid');
-} catch (err) {
-  if (err instanceof GentIDError) {
-    console.error(err.statusCode); // 404
-    console.error(err.message);   // "Agent not found"
-    console.error(err.code);      // "AGENT_NOT_FOUND"
-  }
-}
-```
-
-## Configuration
-
-```typescript
-const gentid = new GentIDClient({
-  apiKey: 'gid_live_...', // required
-  baseUrl: 'https://api.gentid.com', // optional — this is the default
-});
-```
-
-## Verifying webhook signatures
-
-If you use GentID webhooks, verify the `X-GentID-Signature` header:
-
-```typescript
-import crypto from 'crypto';
-
-function verifyWebhook(secret: string, rawBody: string, signatureHeader: string): boolean {
-  const [tPart, v1Part] = signatureHeader.split(',');
-  const timestamp = tPart.replace('t=', '');
-  const expected  = v1Part.replace('v1=', '');
-  const sig = crypto
-    .createHmac('sha256', secret)
-    .update(`${timestamp}.${rawBody}`)
-    .digest('hex');
-  return crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expected));
-}
-```
-
-## License
-
-MIT