@elisym/sdk 0.1.2 → 0.2.0

package/dist/types-CII4k_8d.d.ts

@@ -0,0 +1,181 @@
+declare class ElisymIdentity {
+    private _secretKey;
+    readonly publicKey: string;
+    readonly npub: string;
+    get secretKey(): Uint8Array;
+    private constructor();
+    static generate(): ElisymIdentity;
+    static fromSecretKey(sk: Uint8Array): ElisymIdentity;
+    toJSON(): {
+        publicKey: string;
+        npub: string;
+    };
+    /** Best-effort scrub of the secret key bytes in memory. */
+    scrub(): void;
+    static fromHex(hex: string): ElisymIdentity;
+}
+
+interface SubCloser {
+    close: (reason?: string) => void;
+}
+/** Capability card published to Nostr (NIP-89). */
+interface CapabilityCard {
+    name: string;
+    description: string;
+    capabilities: string[];
+    payment?: PaymentInfo;
+    image?: string;
+    static?: boolean;
+}
+/** Payment info embedded in capability card (legacy format for on-network events). */
+interface PaymentInfo {
+    chain: string;
+    network: string;
+    address: string;
+    /** Price in lamports (must be non-negative integer). */
+    job_price?: number;
+}
+/** Agent discovered from the network. */
+interface Agent {
+    pubkey: string;
+    npub: string;
+    cards: CapabilityCard[];
+    eventId: string;
+    supportedKinds: number[];
+    lastSeen: number;
+    picture?: string;
+    name?: string;
+    about?: string;
+}
+type Network = 'mainnet' | 'devnet';
+/**
+ * Job lifecycle status.
+ * Note: for broadcast jobs (no providerPubkey, no bid), fetchRecentJobs() keeps
+ * status as 'processing' even if a provider sent 'payment-required' feedback,
+ * because the customer hasn't committed to that provider yet. The real-time
+ * payment-required transition is handled by subscribeToJobUpdates().
+ */
+type JobStatus = 'payment-required' | 'payment-completed' | 'processing' | 'error' | 'success' | 'partial' | 'unknown';
+interface Job {
+    eventId: string;
+    customer: string;
+    agentPubkey?: string;
+    capability?: string;
+    bid?: number;
+    status: JobStatus;
+    result?: string;
+    resultEventId?: string;
+    amount?: number;
+    txHash?: string;
+    createdAt: number;
+}
+interface SubmitJobOptions {
+    /** Job input text. Sent unencrypted if providerPubkey is not set. */
+    input: string;
+    capability: string;
+    /** Target provider pubkey. If omitted, job is broadcast unencrypted and visible to all relays. */
+    providerPubkey?: string;
+    /** Kind offset (default 100 - kind 5100). */
+    kindOffset?: number;
+}
+interface JobUpdateCallbacks {
+    onFeedback?: (status: string, amount?: number, paymentRequest?: string, senderPubkey?: string) => void;
+    onResult?: (content: string, eventId: string) => void;
+    onError?: (error: string) => void;
+}
+interface JobSubscriptionOptions {
+    jobEventId: string;
+    providerPubkey?: string;
+    customerPublicKey: string;
+    callbacks: JobUpdateCallbacks;
+    timeoutMs?: number;
+    customerSecretKey?: Uint8Array;
+    kindOffsets?: number[];
+    sinceOverride?: number;
+}
+interface PingResult {
+    online: boolean;
+    /** The identity used for the ping session - reuse for job submission so pubkeys match. */
+    identity: ElisymIdentity | null;
+}
+interface PaymentRequestData {
+    recipient: string;
+    /** Total amount in lamports (must be positive integer). */
+    amount: number;
+    reference: string;
+    description?: string;
+    fee_address?: string;
+    fee_amount?: number;
+    /** Creation timestamp (Unix seconds). */
+    created_at: number;
+    /** Expiry duration in seconds. */
+    expiry_secs: number;
+}
+interface VerifyResult {
+    verified: boolean;
+    txSignature?: string;
+    error?: string;
+}
+interface VerifyOptions {
+    retries?: number;
+    intervalMs?: number;
+    txSignature?: string;
+}
+type PaymentValidationCode = 'invalid_json' | 'invalid_amount' | 'missing_recipient' | 'invalid_recipient_address' | 'missing_reference' | 'invalid_reference_address' | 'recipient_mismatch' | 'expired' | 'future_timestamp' | 'fee_address_mismatch' | 'fee_amount_mismatch' | 'missing_fee' | 'invalid_fee_params';
+interface PaymentValidationError {
+    code: PaymentValidationCode;
+    message: string;
+}
+interface NetworkStats {
+    totalAgentCount: number;
+    agentCount: number;
+    jobCount: number;
+    totalLamports: number;
+}
+interface ElisymClientConfig {
+    relays?: string[];
+}
+interface Identity {
+    secret_key: string;
+    name: string;
+    description?: string;
+    picture?: string;
+    banner?: string;
+}
+interface Capability {
+    name: string;
+    description: string;
+    tags: string[];
+    /** Price in smallest unit (lamports for Solana). */
+    price: number;
+    /** Hero image URL for app display. */
+    image?: string;
+}
+interface PaymentAddress {
+    chain: string;
+    network: string;
+    address: string;
+    /** Token mint/contract address. Absent = native coin. */
+    token?: string;
+}
+interface WalletConfig {
+    chain: string;
+    network: string;
+    secret_key: string;
+}
+interface LlmConfig {
+    provider: string;
+    api_key: string;
+    model: string;
+    max_tokens: number;
+}
+interface AgentConfig {
+    identity: Identity;
+    relays: string[];
+    capabilities?: Capability[];
+    payments?: PaymentAddress[];
+    wallet?: WalletConfig;
+    llm?: LlmConfig;
+}
+
+export { type Agent as A, type CapabilityCard as C, ElisymIdentity as E, type Identity as I, type JobSubscriptionOptions as J, type LlmConfig as L, type Network as N, type PaymentRequestData as P, type SubCloser as S, type VerifyOptions as V, type WalletConfig as W, type PaymentValidationError as a, type VerifyResult as b, type SubmitJobOptions as c, type Job as d, type PingResult as e, type ElisymClientConfig as f, type AgentConfig as g, type Capability as h, type JobStatus as i, type JobUpdateCallbacks as j, type NetworkStats as k, type PaymentAddress as l, type PaymentInfo as m, type PaymentValidationCode as n };

package/package.json

@@ -1,8 +1,35 @@
 {
   "name": "@elisym/sdk",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "TypeScript SDK for elisym - AI agent discovery, marketplace, messaging, and payments on Nostr",
+  "keywords": [
+    "ai-agents",
+    "discovery",
+    "marketplace",
+    "nip-89",
+    "nip-90",
+    "nostr",
+    "payments",
+    "solana",
+    "typescript"
+  ],
+  "homepage": "https://github.com/elisymlabs/elisym",
+  "bugs": {
+    "url": "https://github.com/elisymlabs/elisym/issues"
+  },
+  "license": "MIT",
+  "author": "elisym labs",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/elisymlabs/elisym.git",
+    "directory": "packages/sdk"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "type": "module",
+  "sideEffects": false,
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -16,38 +43,44 @@
         "types": "./dist/index.d.cts",
         "default": "./dist/index.cjs"
       }
+    },
+    "./node": {
+      "import": {
+        "types": "./dist/node.d.ts",
+        "default": "./dist/node.js"
+      },
+      "require": {
+        "types": "./dist/node.d.cts",
+        "default": "./dist/node.cjs"
+      }
     }
   },
-  "sideEffects": false,
-  "files": [
-    "dist"
-  ],
   "scripts": {
-    "prepare": "tsup",
     "build": "tsup",
     "dev": "tsup --watch",
     "test": "vitest run",
     "test:watch": "vitest",
-    "typecheck": "tsc --noEmit"
-  },
-  "peerDependencies": {
-    "@solana/web3.js": "^1.98.0",
-    "decimal.js-light": "^2.5.0",
-    "nostr-tools": "^2.23.0"
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint src/",
+    "format:check": "oxfmt --check src/ tests/",
+    "qa": "tsup && vitest run && tsc --noEmit && oxlint src/ && oxfmt --check src/ tests/",
+    "clean": "rm -rf dist"
   },
   "devDependencies": {
-    "@solana/web3.js": "^1.98.0",
-    "nostr-tools": "^2.23.0",
-    "tsup": "^8.4.0",
-    "typescript": "^5.7.0",
-    "vitest": "^3.0.0"
+    "@solana/web3.js": "~1.98.0",
+    "@types/node": "~25.5.0",
+    "decimal.js-light": "~2.5.1",
+    "nostr-tools": "~2.23.0",
+    "tsup": "~8.4.0",
+    "typescript": "~5.7.0",
+    "vitest": "~3.0.0"
   },
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/elisymlabs/elisym-sdk-ts"
+  "peerDependencies": {
+    "@solana/web3.js": "~1.98.0",
+    "decimal.js-light": "~2.5.0",
+    "nostr-tools": "~2.23.0"
   },
-  "dependencies": {
-    "decimal.js-light": "^2.5.1"
+  "engines": {
+    "node": ">=20"
   }
 }