@gentid/sdk 1.0.0

package/dist/client.d.ts

@@ -0,0 +1,32 @@
+import type { GentIDClientOptions, Agent, CreatedAgent, SignResult, VerifyResult, VerificationRecord, VerificationType, ListAgentsResult, LookupResult } from './types';
+export declare class GentIDError extends Error {
+    readonly statusCode: number;
+    readonly code?: string | undefined;
+    constructor(statusCode: number, message: string, code?: string | undefined);
+}
+export declare class GentIDClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor({ baseUrl, apiKey }: GentIDClientOptions);
+    private request;
+    /** Create a new agent identity. Store the returned privateKey — it is never shown again. */
+    createAgent(params: {
+        name: string;
+        owner: string;
+    }): Promise<CreatedAgent>;
+    getAgent(id: string): Promise<Agent>;
+    listAgents(owner: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<ListAgentsResult>;
+    revokeAgent(id: string): Promise<Agent>;
+    suspendAgent(id: string): Promise<Agent>;
+    reactivateAgent(id: string): Promise<Agent>;
+    signMessage(agentId: string, message: string): Promise<SignResult>;
+    verifySignature(agentId: string, message: string, signature: string): Promise<VerifyResult>;
+    /** Public — no API key required. Verify any agent's identity and public key. */
+    lookupAgent(agentId: string): Promise<LookupResult>;
+    requestVerification(agentId: string, type: VerificationType): Promise<VerificationRecord>;
+    getVerificationStatus(agentId: string): Promise<VerificationRecord[]>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +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"}

package/dist/client.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GentIDClient = exports.GentIDError = void 0;
+class GentIDError extends Error {
+    constructor(statusCode, message, code) {
+        super(message);
+        this.statusCode = statusCode;
+        this.code = code;
+        this.name = 'GentIDError';
+    }
+}
+exports.GentIDError = GentIDError;
+const DEFAULT_BASE_URL = 'https://api.gentid.com';
+class GentIDClient {
+    constructor({ baseUrl = DEFAULT_BASE_URL, apiKey }) {
+        this.baseUrl = baseUrl.replace(/\/$/, '');
+        this.apiKey = apiKey;
+    }
+    async request(method, path, body, auth = true) {
+        const url = `${this.baseUrl}/api/v1${path}`;
+        const headers = { 'Content-Type': 'application/json' };
+        if (auth)
+            headers['Authorization'] = `Bearer ${this.apiKey}`;
+        const res = await fetch(url, {
+            method,
+            headers,
+            ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+        });
+        const data = await res.json().catch(() => ({}));
+        if (!res.ok) {
+            throw new GentIDError(res.status, data.error ?? res.statusText, data.code);
+        }
+        return data;
+    }
+    // ─── Agents ───────────────────────────────────────────────────────────────────
+    /** Create a new agent identity. Store the returned privateKey — it is never shown again. */
+    async createAgent(params) {
+        return this.request('POST', '/agents', params);
+    }
+    async getAgent(id) {
+        return this.request('GET', `/agents/${encodeURIComponent(id)}`);
+    }
+    async listAgents(owner, options) {
+        const params = new URLSearchParams({ owner });
+        if (options?.limit !== undefined)
+            params.set('limit', String(options.limit));
+        if (options?.offset !== undefined)
+            params.set('offset', String(options.offset));
+        return this.request('GET', `/agents?${params}`);
+    }
+    async revokeAgent(id) {
+        return this.request('POST', `/agents/${encodeURIComponent(id)}/revoke`);
+    }
+    async suspendAgent(id) {
+        return this.request('POST', `/agents/${encodeURIComponent(id)}/suspend`);
+    }
+    async reactivateAgent(id) {
+        return this.request('POST', `/agents/${encodeURIComponent(id)}/reactivate`);
+    }
+    // ─── Signatures ───────────────────────────────────────────────────────────────
+    async signMessage(agentId, message) {
+        return this.request('POST', '/signatures/sign', { agentId, message });
+    }
+    async verifySignature(agentId, message, signature) {
+        return this.request('POST', '/signatures/verify', { agentId, message, signature });
+    }
+    // ─── Verification ─────────────────────────────────────────────────────────────
+    /** Public — no API key required. Verify any agent's identity and public key. */
+    async lookupAgent(agentId) {
+        return this.request('GET', `/verification/lookup/${encodeURIComponent(agentId)}`, undefined, false);
+    }
+    async requestVerification(agentId, type) {
+        return this.request('POST', '/verification/request', { agentId, type });
+    }
+    async getVerificationStatus(agentId) {
+        const params = new URLSearchParams({ agentId });
+        return this.request('GET', `/verification/status?${params}`);
+    }
+}
+exports.GentIDClient = GentIDClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

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

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GentIDError = exports.GentIDClient = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "GentIDClient", { enumerable: true, get: function () { return client_1.GentIDClient; } });
+Object.defineProperty(exports, "GentIDError", { enumerable: true, get: function () { return client_1.GentIDError; } });
+// Quick start:
+//
+// import { GentIDClient } from '@gentid/sdk';
+//
+// const gentid = new GentIDClient({ apiKey: 'gid_live_xxxx' });
+//
+// const agent = await gentid.createAgent({ name: 'payments-bot', owner: 'acme-corp' });
+// // ⚠  store agent.privateKey — it is never returned again
+//
+// const { signature } = await gentid.signMessage(agent.id, 'approve-payment-42');
+// const { valid } = await gentid.verifySignature(agent.id, 'approve-payment-42', signature);
+//
+// // Public lookup — no API key needed
+// const identity = await gentid.lookupAgent(agent.id);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/types.d.ts

@@ -0,0 +1,56 @@
+export type AgentStatus = 'active' | 'revoked' | 'suspended';
+export type VerificationType = 'email' | 'domain' | 'manual';
+export type VerificationStatus = 'pending' | 'verified' | 'failed';
+export interface Agent {
+    id: string;
+    name: string;
+    owner: string;
+    publicKey: string;
+    status: AgentStatus;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreatedAgent extends Agent {
+    /** Returned only once at creation — store it securely. */
+    privateKey: string;
+}
+export interface SignResult {
+    agentId: string;
+    messageHash: string;
+    signature: string;
+    logId: string;
+}
+export interface VerifyResult {
+    valid: boolean;
+    agentId: string;
+    messageHash: string;
+}
+export interface VerificationRecord {
+    id: string;
+    agentId: string;
+    type: VerificationType;
+    status: VerificationStatus;
+    createdAt: string;
+    updatedAt: string;
+    hint?: string;
+}
+/** Public lookup result — no API key required. */
+export interface LookupResult {
+    id: string;
+    name: string;
+    status: AgentStatus;
+    publicKey: string;
+    algorithm: string;
+    owner: string;
+    issuedAt: string;
+}
+export interface ListAgentsResult {
+    agents: Agent[];
+    total: number;
+}
+export interface GentIDClientOptions {
+    apiKey: string;
+    /** Defaults to https://api.gentid.com */
+    baseUrl?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +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"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@gentid/sdk",
+  "version": "1.0.0",
+  "description": "TypeScript SDK for GentID — cryptographic identity for AI agents",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.21",
+    "typescript": "^5.8.3"
+  }
+}