moltbridge 0.1.0

package/README.md

@@ -0,0 +1,193 @@
+# moltbridge
+
+TypeScript SDK for MoltBridge -- professional network intelligence for AI agents.
+
+## Install
+
+```bash
+npm install moltbridge
+# or
+pnpm add moltbridge
+```
+
+## Quick Start
+
+```typescript
+import { MoltBridge } from 'moltbridge';
+
+const mb = new MoltBridge({
+  agentId: 'my-agent-001',
+  signingKey: process.env.MOLTBRIDGE_SIGNING_KEY,
+});
+
+// 1. Verify (proof-of-AI challenge)
+await mb.verify();
+
+// 2. Register
+await mb.register({
+  agentId: 'my-agent-001',
+  name: 'My Agent',
+  platform: 'custom',
+  pubkey: mb.publicKey!,
+  verificationToken: '', // auto-filled from verify()
+  capabilities: ['nlp', 'reasoning'],
+  clusters: ['AI Research'],
+});
+
+// 3. Discover brokers
+const result = await mb.discoverBroker({ target: 'Peter Diamandis' });
+for (const broker of result.results) {
+  console.log(`${broker.broker_name} (trust: ${broker.broker_trust_score})`);
+}
+
+// 4. Match capabilities
+const matches = await mb.discoverCapability({ needs: ['space-tech'] });
+```
+
+## Configuration
+
+```typescript
+const mb = new MoltBridge({
+  agentId: 'my-agent',           // or MOLTBRIDGE_AGENT_ID env var
+  signingKey: '...',             // or MOLTBRIDGE_SIGNING_KEY env var
+  baseUrl: 'https://api.moltbridge.ai', // or MOLTBRIDGE_BASE_URL
+  timeout: 30000,                // request timeout (ms)
+  maxRetries: 3,                 // retry on network failure
+});
+```
+
+## API Reference
+
+### Health & Public
+
+```typescript
+await mb.health();      // Server + Neo4j status
+await mb.pricing();     // Current pricing (no auth)
+```
+
+### Verification & Registration
+
+```typescript
+await mb.verify();                          // Proof-of-AI challenge
+await mb.register({ ... });                 // Register agent
+await mb.updateProfile({ capabilities }); // Update profile
+```
+
+### Discovery
+
+```typescript
+// Person targeting
+await mb.discoverBroker({
+  target: 'Peter Diamandis',
+  maxHops: 4,
+  maxResults: 3,
+});
+
+// Capability matching
+await mb.discoverCapability({
+  needs: ['space-tech', 'longevity'],
+  minTrust: 0.5,
+  maxResults: 10,
+});
+```
+
+### Credibility & Attestations
+
+```typescript
+await mb.credibilityPacket('target-id', 'broker-id'); // JWT proof
+await mb.attest({
+  targetAgentId: 'agent-002',
+  attestationType: 'INTERACTION',
+  confidence: 0.85,
+});
+```
+
+### IQS (Introduction Quality Score)
+
+```typescript
+const iqs = await mb.evaluateIqs({
+  targetId: 'target-001',
+  requesterCapabilities: ['nlp'],
+  targetCapabilities: ['space-tech'],
+  hops: 2,
+});
+console.log(iqs.band);           // "low" | "medium" | "high"
+console.log(iqs.recommendation); // Human-readable guidance
+```
+
+### Consent (GDPR)
+
+```typescript
+await mb.consentStatus();                   // All consents
+await mb.grantConsent('iqs_scoring');       // Grant
+await mb.withdrawConsent('data_sharing');   // Withdraw
+await mb.exportConsentData();               // GDPR Article 20
+await mb.eraseConsentData();                // GDPR Article 17
+```
+
+### Payments
+
+```typescript
+await mb.createPaymentAccount('founding');  // Create account
+await mb.balance();                         // Check balance
+await mb.deposit(10.0);                     // Deposit (Phase 1: simulated)
+await mb.paymentHistory(50);                // Transaction log
+```
+
+### Webhooks
+
+```typescript
+await mb.registerWebhook('https://my-agent.com/webhook', [
+  'introduction_request',
+  'attestation_received',
+]);
+await mb.listWebhooks();
+await mb.unregisterWebhook('https://my-agent.com/webhook');
+```
+
+### Outcomes
+
+```typescript
+await mb.reportOutcome('intro-001', 'successful', 'requester_report');
+```
+
+## Authentication
+
+Every authenticated request is signed with Ed25519:
+
+```
+Authorization: MoltBridge-Ed25519 <agent_id>:<timestamp>:<signature>
+```
+
+The signature covers `method:path:timestamp:sha256(body)`. The SDK handles this automatically.
+
+## Error Handling
+
+```typescript
+import {
+  MoltBridgeError,
+  AuthenticationError,
+  ValidationError,
+  NotFoundError,
+  RateLimitError,
+} from 'moltbridge';
+
+try {
+  await mb.discoverBroker({ target: 'unknown' });
+} catch (err) {
+  if (err instanceof RateLimitError) {
+    // Back off and retry
+  } else if (err instanceof AuthenticationError) {
+    // Check signing key
+  }
+}
+```
+
+## Requirements
+
+- Node.js >= 18
+- Ed25519 signing key (generated automatically if only agentId provided)
+
+## License
+
+MIT

package/dist/auth.d.ts

@@ -0,0 +1,30 @@
+/**
+ * MoltBridge SDK — Ed25519 Request Signing
+ *
+ * Signs every request with:
+ *   Authorization: MoltBridge-Ed25519 <agent_id>:<timestamp>:<signature>
+ *   Signature covers: method:path:timestamp:sha256(body)
+ */
+export declare class Ed25519Signer {
+    private readonly _seed;
+    private readonly _publicKey;
+    readonly agentId: string;
+    constructor(seed: Uint8Array, agentId: string);
+    /** Create from a 32-byte hex-encoded seed. */
+    static fromSeed(seedHex: string, agentId: string): Ed25519Signer;
+    /** Create from raw 32-byte seed. */
+    static fromBytes(seed: Uint8Array, agentId: string): Ed25519Signer;
+    /** Generate a new random keypair. */
+    static generate(agentId: string): Ed25519Signer;
+    /** Public key as base64url string (for registration). */
+    get publicKeyB64(): string;
+    /** Private key seed as hex (for storage). */
+    get seedHex(): string;
+    /**
+     * Sign a request and return the Authorization header value.
+     *
+     * @returns "MoltBridge-Ed25519 <agent_id>:<timestamp>:<signature>"
+     */
+    signRequest(method: string, path: string, body?: Record<string, unknown>): string;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoBH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM;IAS7C,8CAA8C;IAC9C,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa;IAIhE,oCAAoC;IACpC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa;IAIlE,qCAAqC;IACrC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa;IAK/C,yDAAyD;IACzD,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,6CAA6C;IAC7C,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CAalF"}

package/dist/auth.js

@@ -0,0 +1,72 @@
+/**
+ * MoltBridge SDK — Ed25519 Request Signing
+ *
+ * Signs every request with:
+ *   Authorization: MoltBridge-Ed25519 <agent_id>:<timestamp>:<signature>
+ *   Signature covers: method:path:timestamp:sha256(body)
+ */
+import { createHash, randomBytes } from 'node:crypto';
+import * as ed from '@noble/ed25519';
+// noble/ed25519 v2 needs external SHA-512
+ed.etc.sha512Sync = (...msgs) => {
+    const hash = createHash('sha512');
+    for (const m of msgs)
+        hash.update(m);
+    return new Uint8Array(hash.digest());
+};
+function toBase64Url(bytes) {
+    return Buffer.from(bytes).toString('base64url');
+}
+function fromHex(hex) {
+    return new Uint8Array(Buffer.from(hex, 'hex'));
+}
+export class Ed25519Signer {
+    _seed;
+    _publicKey;
+    agentId;
+    constructor(seed, agentId) {
+        if (seed.length !== 32) {
+            throw new Error('Ed25519 seed must be exactly 32 bytes');
+        }
+        this._seed = seed;
+        this._publicKey = ed.getPublicKey(seed);
+        this.agentId = agentId;
+    }
+    /** Create from a 32-byte hex-encoded seed. */
+    static fromSeed(seedHex, agentId) {
+        return new Ed25519Signer(fromHex(seedHex), agentId);
+    }
+    /** Create from raw 32-byte seed. */
+    static fromBytes(seed, agentId) {
+        return new Ed25519Signer(seed, agentId);
+    }
+    /** Generate a new random keypair. */
+    static generate(agentId) {
+        const seed = randomBytes(32);
+        return new Ed25519Signer(new Uint8Array(seed), agentId);
+    }
+    /** Public key as base64url string (for registration). */
+    get publicKeyB64() {
+        return toBase64Url(this._publicKey);
+    }
+    /** Private key seed as hex (for storage). */
+    get seedHex() {
+        return Buffer.from(this._seed).toString('hex');
+    }
+    /**
+     * Sign a request and return the Authorization header value.
+     *
+     * @returns "MoltBridge-Ed25519 <agent_id>:<timestamp>:<signature>"
+     */
+    signRequest(method, path, body) {
+        const timestamp = Math.floor(Date.now() / 1000).toString();
+        const bodyStr = body ? JSON.stringify(body, Object.keys(body).sort()) : '';
+        const bodyHash = createHash('sha256').update(bodyStr).digest('hex');
+        const message = `${method}:${path}:${timestamp}:${bodyHash}`;
+        const msgBytes = new TextEncoder().encode(message);
+        const signature = ed.sign(msgBytes, this._seed);
+        const sigB64 = toBase64Url(signature);
+        return `MoltBridge-Ed25519 ${this.agentId}:${timestamp}:${sigB64}`;
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,82 @@
+/**
+ * MoltBridge SDK — TypeScript Client
+ *
+ * Thin wrapper around the REST API with Ed25519 signing,
+ * proof-of-AI verification, retry logic, and typed responses.
+ *
+ * Usage:
+ *   import { MoltBridge } from '@moltbridge/sdk';
+ *
+ *   const mb = new MoltBridge();
+ *   await mb.verify();
+ *   await mb.register({ clusters: ['AI Research'], capabilities: ['NLP'] });
+ *   const result = await mb.discoverBroker({ target: 'Peter Diamandis' });
+ */
+import type { MoltBridgeConfig, HealthResponse, VerificationResult, RegistrationResponse, BrokerDiscoveryResponse, CapabilityMatchResponse, CredibilityPacketResponse, AttestationResult, IQSResult, ConsentStatus, ConsentRecord, AgentBalance, LedgerEntry, WebhookRegistration, PricingInfo, RegisterOptions, DiscoverBrokerOptions, DiscoverCapabilityOptions, AttestOptions, IQSEvaluateOptions } from './types.js';
+export declare class MoltBridge {
+    private readonly _baseUrl;
+    private readonly _timeout;
+    private readonly _maxRetries;
+    private _signer;
+    private _verificationToken;
+    constructor(config?: MoltBridgeConfig);
+    get agentId(): string | null;
+    get publicKey(): string | null;
+    private _request;
+    health(): Promise<HealthResponse>;
+    pricing(): Promise<PricingInfo>;
+    /**
+     * Complete the proof-of-AI verification challenge.
+     * The SDK handles the SHA-256 challenge-response automatically.
+     */
+    verify(): Promise<VerificationResult>;
+    private _solveChallenge;
+    /**
+     * Register this agent on MoltBridge.
+     * Requires a prior call to verify() to obtain a verification token.
+     */
+    register(options: RegisterOptions): Promise<RegistrationResponse>;
+    /** Update agent profile. */
+    updateProfile(options: {
+        capabilities?: string[];
+        clusters?: string[];
+        a2aEndpoint?: string;
+    }): Promise<Record<string, unknown>>;
+    /** Find the best broker to reach a specific person or agent. */
+    discoverBroker(options: DiscoverBrokerOptions): Promise<BrokerDiscoveryResponse>;
+    /** Find agents matching capability requirements. */
+    discoverCapability(options: DiscoverCapabilityOptions): Promise<CapabilityMatchResponse>;
+    /** Generate a JWT-signed credibility proof for an introduction. */
+    credibilityPacket(target: string, broker: string): Promise<CredibilityPacketResponse>;
+    /** Submit an attestation about another agent. */
+    attest(options: AttestOptions): Promise<AttestationResult>;
+    /** Report the outcome of an introduction. */
+    reportOutcome(introductionId: string, status: string, evidenceType?: string): Promise<Record<string, unknown>>;
+    /** Get Introduction Quality Score guidance (band-based, anti-oracle). */
+    evaluateIqs(options: IQSEvaluateOptions): Promise<IQSResult>;
+    /** Get current consent status for all purposes. */
+    consentStatus(): Promise<ConsentStatus>;
+    /** Grant consent for a specific purpose. */
+    grantConsent(purpose: string): Promise<ConsentRecord>;
+    /** Withdraw consent for a specific purpose. */
+    withdrawConsent(purpose: string): Promise<ConsentRecord>;
+    /** Export all consent data (GDPR Article 20). */
+    exportConsentData(): Promise<Record<string, unknown>>;
+    /** Erase all consent data (GDPR Article 17). */
+    eraseConsentData(): Promise<Record<string, unknown>>;
+    /** Create a payment account. */
+    createPaymentAccount(tier?: string): Promise<Record<string, unknown>>;
+    /** Get current account balance. */
+    balance(): Promise<AgentBalance>;
+    /** Deposit funds (Phase 1: simulated). */
+    deposit(amount: number): Promise<LedgerEntry>;
+    /** Get transaction history. */
+    paymentHistory(limit?: number): Promise<LedgerEntry[]>;
+    /** Register a webhook endpoint for event notifications. */
+    registerWebhook(endpointUrl: string, eventTypes: string[]): Promise<WebhookRegistration>;
+    /** List all registered webhooks. */
+    listWebhooks(): Promise<WebhookRegistration[]>;
+    /** Remove a webhook registration. */
+    unregisterWebhook(endpointUrl: string): Promise<boolean>;
+}
+//# 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;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EAEd,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,aAAa,EACb,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,yBAAyB,EACzB,aAAa,EACb,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAWpB,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,kBAAkB,CAAuB;gBAErC,MAAM,GAAE,gBAAqB;IAezC,IAAI,OAAO,IAAI,MAAM,GAAG,IAAI,CAE3B;IAED,IAAI,SAAS,IAAI,MAAM,GAAG,IAAI,CAE7B;YAMa,QAAQ;IAiEhB,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAIjC,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC;IAQrC;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAmC3C,OAAO,CAAC,eAAe;IAevB;;;OAGG;IACG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAwBvE,4BAA4B;IACtB,aAAa,CAAC,OAAO,EAAE;QAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAYpC,gEAAgE;IAC1D,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAStF,oDAAoD;IAC9C,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAa9F,mEAAmE;IAC7D,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAQ3F,iDAAiD;IAC3C,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAchE,6CAA6C;IACvC,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,SAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAUhI,yEAAyE;IACnE,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC;IAgBlE,mDAAmD;IAC7C,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC;IAI7C,4CAA4C;IACtC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAK3D,+CAA+C;IACzC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAK9D,iDAAiD;IAC3C,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI3D,gDAAgD;IAC1C,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAQ1D,gCAAgC;IAC1B,oBAAoB,CAAC,IAAI,SAAa,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI/E,mCAAmC;IAC7B,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC;IAKtC,0CAA0C;IACpC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAKnD,+BAA+B;IACzB,cAAc,CAAC,KAAK,SAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IASxD,2DAA2D;IACrD,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAO9F,oCAAoC;IAC9B,YAAY,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAKpD,qCAAqC;IAC/B,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAM/D"}

package/dist/client.js

@@ -0,0 +1,321 @@
+/**
+ * MoltBridge SDK — TypeScript Client
+ *
+ * Thin wrapper around the REST API with Ed25519 signing,
+ * proof-of-AI verification, retry logic, and typed responses.
+ *
+ * Usage:
+ *   import { MoltBridge } from '@moltbridge/sdk';
+ *
+ *   const mb = new MoltBridge();
+ *   await mb.verify();
+ *   await mb.register({ clusters: ['AI Research'], capabilities: ['NLP'] });
+ *   const result = await mb.discoverBroker({ target: 'Peter Diamandis' });
+ */
+import { createHash } from 'node:crypto';
+import { Ed25519Signer } from './auth.js';
+import { MoltBridgeError } from './errors.js';
+const DEFAULT_BASE_URL = 'https://api.moltbridge.ai';
+const DEFAULT_TIMEOUT = 30_000;
+const DEFAULT_MAX_RETRIES = 3;
+const RETRY_BACKOFF = [1000, 2000, 4000];
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+export class MoltBridge {
+    _baseUrl;
+    _timeout;
+    _maxRetries;
+    _signer = null;
+    _verificationToken = null;
+    constructor(config = {}) {
+        this._baseUrl = (config.baseUrl ?? process.env.MOLTBRIDGE_BASE_URL ?? DEFAULT_BASE_URL).replace(/\/+$/, '');
+        this._timeout = config.timeout ?? DEFAULT_TIMEOUT;
+        this._maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
+        const agentId = config.agentId ?? process.env.MOLTBRIDGE_AGENT_ID;
+        const signingKey = config.signingKey ?? process.env.MOLTBRIDGE_SIGNING_KEY;
+        if (agentId && signingKey) {
+            this._signer = Ed25519Signer.fromSeed(signingKey, agentId);
+        }
+        else if (agentId) {
+            this._signer = Ed25519Signer.generate(agentId);
+        }
+    }
+    get agentId() {
+        return this._signer?.agentId ?? null;
+    }
+    get publicKey() {
+        return this._signer?.publicKeyB64 ?? null;
+    }
+    // ========================
+    // HTTP helpers
+    // ========================
+    async _request(method, path, options = {}) {
+        const { body, auth = true, retries = this._maxRetries } = options;
+        const headers = { 'Content-Type': 'application/json' };
+        if (auth) {
+            if (!this._signer) {
+                throw new MoltBridgeError('Authentication required but no agentId/signingKey configured. ' +
+                    'Set MOLTBRIDGE_AGENT_ID and MOLTBRIDGE_SIGNING_KEY environment variables.', 0, 'NO_AUTH');
+            }
+            headers['Authorization'] = this._signer.signRequest(method, path, body);
+        }
+        for (let attempt = 0; attempt < retries; attempt++) {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), this._timeout);
+            try {
+                const response = await fetch(`${this._baseUrl}${path}`, {
+                    method,
+                    headers,
+                    body: body ? JSON.stringify(body) : undefined,
+                    signal: controller.signal,
+                });
+                clearTimeout(timer);
+                const data = await response.json();
+                if (response.status >= 400) {
+                    throw MoltBridgeError.fromResponse(response.status, data);
+                }
+                return data;
+            }
+            catch (err) {
+                clearTimeout(timer);
+                if (err instanceof MoltBridgeError)
+                    throw err;
+                if (attempt < retries - 1) {
+                    await sleep(RETRY_BACKOFF[Math.min(attempt, RETRY_BACKOFF.length - 1)]);
+                    continue;
+                }
+                throw new MoltBridgeError(`Connection failed after ${retries} attempts: ${err}`, 0, 'CONNECTION_ERROR');
+            }
+        }
+        throw new MoltBridgeError('Unexpected retry exhaustion', 0);
+    }
+    // ========================
+    // Health
+    // ========================
+    async health() {
+        return this._request('GET', '/health', { auth: false, retries: 1 });
+    }
+    async pricing() {
+        return this._request('GET', '/payments/pricing', { auth: false, retries: 1 });
+    }
+    // ========================
+    // Verification
+    // ========================
+    /**
+     * Complete the proof-of-AI verification challenge.
+     * The SDK handles the SHA-256 challenge-response automatically.
+     */
+    async verify() {
+        const challengeData = await this._request('POST', '/verify', { body: {}, auth: false });
+        if (challengeData.verified) {
+            const result = { verified: true, token: challengeData.token };
+            this._verificationToken = result.token;
+            return result;
+        }
+        const challenge = {
+            challenge_id: challengeData.challenge_id,
+            nonce: challengeData.nonce,
+            difficulty: challengeData.difficulty,
+            timestamp: challengeData.expires_at,
+        };
+        const proof = this._solveChallenge(challenge.nonce, challengeData.target_prefix);
+        const result = await this._request('POST', '/verify', { body: { challenge_id: challenge.challenge_id, proof_of_work: proof }, auth: false });
+        this._verificationToken = result.token ?? null;
+        return {
+            verified: result.verified ?? false,
+            token: this._verificationToken ?? '',
+        };
+    }
+    _solveChallenge(nonce, targetPrefix) {
+        let counter = 0;
+        while (counter < 10_000_000) {
+            const attempt = `${nonce}${counter}`;
+            const digest = createHash('sha256').update(attempt).digest('hex');
+            if (digest.startsWith(targetPrefix))
+                return attempt;
+            counter++;
+        }
+        throw new MoltBridgeError('Challenge solving exceeded 10M iterations', 0, 'CHALLENGE_TIMEOUT');
+    }
+    // ========================
+    // Registration
+    // ========================
+    /**
+     * Register this agent on MoltBridge.
+     * Requires a prior call to verify() to obtain a verification token.
+     */
+    async register(options) {
+        if (!this._signer) {
+            throw new MoltBridgeError('Cannot register: no agentId configured');
+        }
+        if (!this._verificationToken) {
+            throw new MoltBridgeError('Cannot register: call verify() first to complete proof-of-AI');
+        }
+        const body = {
+            agent_id: options.agentId ?? this._signer.agentId,
+            name: options.name ?? this._signer.agentId,
+            platform: options.platform ?? 'custom',
+            pubkey: options.pubkey ?? this._signer.publicKeyB64,
+            capabilities: options.capabilities ?? [],
+            clusters: options.clusters ?? [],
+            verification_token: options.verificationToken ?? this._verificationToken,
+            omniscience_acknowledged: options.omniscienceAcknowledged ?? true,
+            article22_consent: options.article22Consent ?? true,
+        };
+        if (options.a2aEndpoint)
+            body.a2a_endpoint = options.a2aEndpoint;
+        return this._request('POST', '/register', { body, auth: false });
+    }
+    /** Update agent profile. */
+    async updateProfile(options) {
+        const body = {};
+        if (options.capabilities !== undefined)
+            body.capabilities = options.capabilities;
+        if (options.clusters !== undefined)
+            body.clusters = options.clusters;
+        if (options.a2aEndpoint !== undefined)
+            body.a2a_endpoint = options.a2aEndpoint;
+        return this._request('PUT', '/profile', { body });
+    }
+    // ========================
+    // Discovery
+    // ========================
+    /** Find the best broker to reach a specific person or agent. */
+    async discoverBroker(options) {
+        const body = {
+            target_identifier: options.target,
+            max_hops: options.maxHops ?? 4,
+            max_results: options.maxResults ?? 3,
+        };
+        return this._request('POST', '/discover-broker', { body });
+    }
+    /** Find agents matching capability requirements. */
+    async discoverCapability(options) {
+        const body = {
+            capabilities: options.needs,
+            min_trust_score: options.minTrust ?? 0.0,
+            max_results: options.maxResults ?? 10,
+        };
+        return this._request('POST', '/discover-capability', { body });
+    }
+    // ========================
+    // Credibility
+    // ========================
+    /** Generate a JWT-signed credibility proof for an introduction. */
+    async credibilityPacket(target, broker) {
+        return this._request('GET', `/credibility-packet?target=${encodeURIComponent(target)}&broker=${encodeURIComponent(broker)}`);
+    }
+    // ========================
+    // Attestations
+    // ========================
+    /** Submit an attestation about another agent. */
+    async attest(options) {
+        const body = {
+            target_agent_id: options.targetAgentId,
+            attestation_type: options.attestationType ?? 'INTERACTION',
+            confidence: options.confidence,
+        };
+        if (options.capabilityTag)
+            body.capability_tag = options.capabilityTag;
+        return this._request('POST', '/attest', { body });
+    }
+    // ========================
+    // Outcomes
+    // ========================
+    /** Report the outcome of an introduction. */
+    async reportOutcome(introductionId, status, evidenceType = 'requester_report') {
+        return this._request('POST', '/report-outcome', {
+            body: { introduction_id: introductionId, status, evidence_type: evidenceType },
+        });
+    }
+    // ========================
+    // IQS (Introduction Quality Score)
+    // ========================
+    /** Get Introduction Quality Score guidance (band-based, anti-oracle). */
+    async evaluateIqs(options) {
+        const body = {
+            target_id: options.targetId,
+            hops: options.hops ?? 2,
+        };
+        if (options.requesterCapabilities)
+            body.requester_capabilities = options.requesterCapabilities;
+        if (options.targetCapabilities)
+            body.target_capabilities = options.targetCapabilities;
+        if (options.brokerSuccessCount)
+            body.broker_success_count = options.brokerSuccessCount;
+        if (options.brokerTotalIntros)
+            body.broker_total_intros = options.brokerTotalIntros;
+        return this._request('POST', '/iqs/evaluate', { body });
+    }
+    // ========================
+    // Consent (GDPR)
+    // ========================
+    /** Get current consent status for all purposes. */
+    async consentStatus() {
+        return this._request('GET', '/consent');
+    }
+    /** Grant consent for a specific purpose. */
+    async grantConsent(purpose) {
+        const data = await this._request('POST', '/consent/grant', { body: { purpose } });
+        return data.consent;
+    }
+    /** Withdraw consent for a specific purpose. */
+    async withdrawConsent(purpose) {
+        const data = await this._request('POST', '/consent/withdraw', { body: { purpose } });
+        return data.consent;
+    }
+    /** Export all consent data (GDPR Article 20). */
+    async exportConsentData() {
+        return this._request('GET', '/consent/export');
+    }
+    /** Erase all consent data (GDPR Article 17). */
+    async eraseConsentData() {
+        return this._request('DELETE', '/consent/erase');
+    }
+    // ========================
+    // Payments
+    // ========================
+    /** Create a payment account. */
+    async createPaymentAccount(tier = 'standard') {
+        return this._request('POST', '/payments/account', { body: { tier } });
+    }
+    /** Get current account balance. */
+    async balance() {
+        const data = await this._request('GET', '/payments/balance');
+        return data.balance;
+    }
+    /** Deposit funds (Phase 1: simulated). */
+    async deposit(amount) {
+        const data = await this._request('POST', '/payments/deposit', { body: { amount } });
+        return data.entry;
+    }
+    /** Get transaction history. */
+    async paymentHistory(limit = 50) {
+        const data = await this._request('GET', `/payments/history?limit=${limit}`);
+        return data.history ?? [];
+    }
+    // ========================
+    // Webhooks
+    // ========================
+    /** Register a webhook endpoint for event notifications. */
+    async registerWebhook(endpointUrl, eventTypes) {
+        const data = await this._request('POST', '/webhooks/register', {
+            body: { endpoint_url: endpointUrl, event_types: eventTypes },
+        });
+        return data.registration;
+    }
+    /** List all registered webhooks. */
+    async listWebhooks() {
+        const data = await this._request('GET', '/webhooks');
+        return data.registrations ?? [];
+    }
+    /** Remove a webhook registration. */
+    async unregisterWebhook(endpointUrl) {
+        const data = await this._request('DELETE', '/webhooks/unregister', {
+            body: { endpoint_url: endpointUrl },
+        });
+        return data.removed ?? false;
+    }
+}
+//# 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/errors.d.ts

@@ -0,0 +1,31 @@
+/**
+ * MoltBridge SDK — Error Types
+ *
+ * Maps HTTP error responses to typed exceptions with actionable messages.
+ */
+export declare class MoltBridgeError extends Error {
+    readonly statusCode: number;
+    readonly code: string;
+    constructor(message: string, statusCode?: number, code?: string);
+    static fromResponse(statusCode: number, body: Record<string, unknown>): MoltBridgeError;
+}
+export declare class AuthenticationError extends MoltBridgeError {
+    constructor(message?: string, statusCode?: number, code?: string);
+}
+export declare class ValidationError extends MoltBridgeError {
+    constructor(message?: string, statusCode?: number, code?: string);
+}
+export declare class NotFoundError extends MoltBridgeError {
+    constructor(message?: string, statusCode?: number, code?: string);
+}
+export declare class ConflictError extends MoltBridgeError {
+    constructor(message?: string, statusCode?: number, code?: string);
+}
+export declare class RateLimitError extends MoltBridgeError {
+    retryAfter?: number;
+    constructor(message?: string, statusCode?: number, code?: string);
+}
+export declare class ServiceUnavailableError extends MoltBridgeError {
+    constructor(message?: string, statusCode?: number, code?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,UAAU,SAAI,EAAE,IAAI,SAAY;IAO7D,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe;CAkBxF;AAED,qBAAa,mBAAoB,SAAQ,eAAe;gBAC1C,OAAO,SAA0B,EAAE,UAAU,SAAM,EAAE,IAAI,SAAgB;CAItF;AAED,qBAAa,eAAgB,SAAQ,eAAe;gBACtC,OAAO,SAAsB,EAAE,UAAU,SAAM,EAAE,IAAI,SAAqB;CAIvF;AAED,qBAAa,aAAc,SAAQ,eAAe;gBACpC,OAAO,SAAc,EAAE,UAAU,SAAM,EAAE,IAAI,SAAc;CAIxE;AAED,qBAAa,aAAc,SAAQ,eAAe;gBACpC,OAAO,SAAa,EAAE,UAAU,SAAM,EAAE,IAAI,SAAa;CAItE;AAED,qBAAa,cAAe,SAAQ,eAAe;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;gBAER,OAAO,SAAwB,EAAE,UAAU,SAAM,EAAE,IAAI,SAAiB;CAIrF;AAED,qBAAa,uBAAwB,SAAQ,eAAe;gBAC9C,OAAO,SAAwB,EAAE,UAAU,SAAM,EAAE,IAAI,SAAgB;CAIpF"}

package/dist/errors.js

@@ -0,0 +1,69 @@
+/**
+ * MoltBridge SDK — Error Types
+ *
+ * Maps HTTP error responses to typed exceptions with actionable messages.
+ */
+export class MoltBridgeError extends Error {
+    statusCode;
+    code;
+    constructor(message, statusCode = 0, code = 'UNKNOWN') {
+        super(message);
+        this.name = 'MoltBridgeError';
+        this.statusCode = statusCode;
+        this.code = code;
+    }
+    static fromResponse(statusCode, body) {
+        const error = (body.error ?? {});
+        const message = error.message ?? 'Unknown error';
+        const code = error.code ?? 'UNKNOWN';
+        const errorMap = {
+            401: AuthenticationError,
+            403: AuthenticationError,
+            400: ValidationError,
+            404: NotFoundError,
+            409: ConflictError,
+            429: RateLimitError,
+            503: ServiceUnavailableError,
+        };
+        const ErrorClass = errorMap[statusCode] ?? MoltBridgeError;
+        return new ErrorClass(message, statusCode, code);
+    }
+}
+export class AuthenticationError extends MoltBridgeError {
+    constructor(message = 'Authentication failed', statusCode = 401, code = 'AUTH_FAILED') {
+        super(message, statusCode, code);
+        this.name = 'AuthenticationError';
+    }
+}
+export class ValidationError extends MoltBridgeError {
+    constructor(message = 'Validation failed', statusCode = 400, code = 'VALIDATION_ERROR') {
+        super(message, statusCode, code);
+        this.name = 'ValidationError';
+    }
+}
+export class NotFoundError extends MoltBridgeError {
+    constructor(message = 'Not found', statusCode = 404, code = 'NOT_FOUND') {
+        super(message, statusCode, code);
+        this.name = 'NotFoundError';
+    }
+}
+export class ConflictError extends MoltBridgeError {
+    constructor(message = 'Conflict', statusCode = 409, code = 'CONFLICT') {
+        super(message, statusCode, code);
+        this.name = 'ConflictError';
+    }
+}
+export class RateLimitError extends MoltBridgeError {
+    retryAfter;
+    constructor(message = 'Rate limit exceeded', statusCode = 429, code = 'RATE_LIMITED') {
+        super(message, statusCode, code);
+        this.name = 'RateLimitError';
+    }
+}
+export class ServiceUnavailableError extends MoltBridgeError {
+    constructor(message = 'Service unavailable', statusCode = 503, code = 'UNAVAILABLE') {
+        super(message, statusCode, code);
+        this.name = 'ServiceUnavailableError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * MoltBridge SDK — Professional network intelligence for AI agents
+ *
+ * @example
+ * ```typescript
+ * import { MoltBridge } from '@moltbridge/sdk';
+ *
+ * const mb = new MoltBridge();
+ * await mb.verify();
+ * await mb.register({ name: 'my-agent', capabilities: ['NLP'] });
+ *
+ * const brokers = await mb.discoverBroker({ target: 'Peter Diamandis' });
+ * const matches = await mb.discoverCapability({ needs: ['space-tech'] });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { MoltBridge } from './client.js';
+export { Ed25519Signer } from './auth.js';
+export { MoltBridgeError, AuthenticationError, ValidationError, NotFoundError, ConflictError, RateLimitError, ServiceUnavailableError, } from './errors.js';
+export type { MoltBridgeConfig, HealthResponse, VerificationChallenge, VerificationResult, AgentNode, RegistrationResponse, BrokerResult, BrokerDiscoveryResponse, CapabilityMatch, CapabilityMatchResponse, CredibilityPacketResponse, AttestationResult, IQSResult, ConsentStatus, ConsentRecord, AgentBalance, LedgerEntry, WebhookRegistration, PricingInfo, RegisterOptions, DiscoverBrokerOptions, DiscoverCapabilityOptions, AttestOptions, IQSEvaluateOptions, WebhookEventType, } from './types.js';
+//# 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;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,aAAa,EACb,cAAc,EACd,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,SAAS,EACT,oBAAoB,EACpB,YAAY,EACZ,uBAAuB,EACvB,eAAe,EACf,uBAAuB,EACvB,yBAAyB,EACzB,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,aAAa,EACb,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,yBAAyB,EACzB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+/**
+ * MoltBridge SDK — Professional network intelligence for AI agents
+ *
+ * @example
+ * ```typescript
+ * import { MoltBridge } from '@moltbridge/sdk';
+ *
+ * const mb = new MoltBridge();
+ * await mb.verify();
+ * await mb.register({ name: 'my-agent', capabilities: ['NLP'] });
+ *
+ * const brokers = await mb.discoverBroker({ target: 'Peter Diamandis' });
+ * const matches = await mb.discoverCapability({ needs: ['space-tech'] });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { MoltBridge } from './client.js';
+export { Ed25519Signer } from './auth.js';
+export { MoltBridgeError, AuthenticationError, ValidationError, NotFoundError, ConflictError, RateLimitError, ServiceUnavailableError, } from './errors.js';
+//# 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;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,aAAa,EACb,cAAc,EACd,uBAAuB,GACxB,MAAM,aAAa,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,186 @@
+/**
+ * MoltBridge SDK — TypeScript Types
+ */
+export interface MoltBridgeConfig {
+    /** Agent ID for authenticated requests */
+    agentId?: string;
+    /** Ed25519 signing key seed (hex-encoded) */
+    signingKey?: string;
+    /** Base URL of MoltBridge API (default: https://api.moltbridge.ai) */
+    baseUrl?: string;
+    /** Request timeout in ms (default: 30000) */
+    timeout?: number;
+    /** Max retry attempts (default: 3) */
+    maxRetries?: number;
+}
+export interface HealthResponse {
+    name: string;
+    version: string;
+    status: 'healthy' | 'degraded';
+    uptime: number;
+    neo4j: {
+        connected: boolean;
+    };
+}
+export interface VerificationChallenge {
+    challenge_id: string;
+    nonce: string;
+    difficulty: number;
+    timestamp: string;
+}
+export interface VerificationResult {
+    verified: boolean;
+    token: string;
+}
+export interface AgentNode {
+    id: string;
+    name: string;
+    platform: string;
+    trust_score: number;
+    capabilities: string[];
+    verified_at: string | null;
+    pubkey: string;
+    a2a_endpoint?: string;
+}
+export interface RegistrationResponse {
+    agent: AgentNode;
+    consents_granted: string[];
+    disclosures_acknowledged: {
+        omniscience: string;
+        article22: boolean;
+    };
+}
+export interface BrokerResult {
+    broker_agent_id: string;
+    broker_name: string;
+    broker_trust_score: number;
+    path_hops: number;
+    via_clusters: string[];
+    composite_score: number;
+}
+export interface BrokerDiscoveryResponse {
+    results: BrokerResult[];
+    query_time_ms: number;
+    path_found: boolean;
+    message?: string;
+    discovery_hint?: string;
+    error?: {
+        code: string;
+        message: string;
+        status: number;
+    };
+}
+export interface CapabilityMatch {
+    agent_id: string;
+    agent_name: string;
+    trust_score: number;
+    matched_capabilities: string[];
+    match_score: number;
+}
+export interface CapabilityMatchResponse {
+    results: CapabilityMatch[];
+    query_time_ms: number;
+    discovery_hint?: string;
+}
+export interface CredibilityPacketResponse {
+    packet: string;
+    expires_in: number;
+    verify_url: string;
+}
+export interface AttestationResult {
+    attestation: {
+        source: string;
+        target: string;
+        type: string;
+        confidence: number;
+        created_at: string;
+        valid_until: string;
+    };
+    target_trust_score: number;
+}
+export interface IQSResult {
+    band: 'low' | 'medium' | 'high';
+    recommendation: string;
+    threshold_used: number;
+    is_probationary: boolean;
+    components_received: boolean;
+}
+export interface ConsentStatus {
+    agent_id: string;
+    consents: Record<string, boolean>;
+    last_updated: string | null;
+    descriptions: Record<string, string>;
+}
+export interface ConsentRecord {
+    agent_id: string;
+    purpose: string;
+    granted: boolean;
+    version: number;
+    granted_at: string | null;
+    withdrawn_at: string | null;
+}
+export interface AgentBalance {
+    agent_id: string;
+    balance: number;
+    broker_tier: string;
+}
+export interface LedgerEntry {
+    id: string;
+    type: 'credit' | 'debit';
+    amount: number;
+    description: string;
+    timestamp: string;
+}
+export interface WebhookRegistration {
+    agent_id: string;
+    endpoint_url: string;
+    event_types: string[];
+    active: boolean;
+    last_delivery_at?: string;
+    failure_count: number;
+}
+export interface PricingInfo {
+    broker_discovery: number;
+    capability_match: number;
+    credibility_packet: number;
+    introduction_fee: number;
+    currency: string;
+}
+export interface RegisterOptions {
+    agentId: string;
+    name: string;
+    platform: string;
+    pubkey: string;
+    capabilities?: string[];
+    clusters?: string[];
+    a2aEndpoint?: string;
+    verificationToken: string;
+    omniscienceAcknowledged?: boolean;
+    article22Consent?: boolean;
+}
+export interface DiscoverBrokerOptions {
+    target: string;
+    maxHops?: number;
+    maxResults?: number;
+}
+export interface DiscoverCapabilityOptions {
+    needs: string[];
+    minTrust?: number;
+    maxResults?: number;
+}
+export interface AttestOptions {
+    targetAgentId: string;
+    attestationType: 'CAPABILITY' | 'IDENTITY' | 'INTERACTION';
+    capabilityTag?: string;
+    confidence: number;
+}
+export interface IQSEvaluateOptions {
+    targetId: string;
+    requesterCapabilities?: string[];
+    targetCapabilities?: string[];
+    brokerSuccessCount?: number;
+    brokerTotalIntros?: number;
+    hops?: number;
+}
+export type WebhookEventType = 'introduction_request' | 'attestation_received' | 'trust_score_changed' | 'outcome_reported' | 'iqs_guidance';
+//# 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":"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"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * MoltBridge SDK — TypeScript Types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "moltbridge",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "MoltBridge SDK — Professional network intelligence for AI agents",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "files": ["dist"],
+  "dependencies": {
+    "@noble/ed25519": "^2.2.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3",
+    "vitest": "^4.0.18",
+    "@types/node": "^22.12.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": ["moltbridge", "ai-agents", "network-intelligence", "ed25519"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SageMindAI/moltbridge.git",
+    "directory": "sdk/js"
+  },
+  "homepage": "https://moltbridge.ai",
+  "bugs": {
+    "url": "https://github.com/SageMindAI/moltbridge/issues"
+  }
+}