@elisym/sdk 0.1.3 → 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.3",
+  "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,36 +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",
-    "decimal.js-light": "^2.5.1",
-    "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"
+  },
+  "engines": {
+    "node": ">=20"
   }
 }

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Igor Peregudov
-
-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.