@elisym/sdk 0.4.0 → 0.5.0

package/dist/index.d.cts

@@ -1,8 +1,144 @@
 import { Address, TransactionSigner, Rpc, SolanaRpcApi } from '@solana/kit';
-import { P as PaymentRequestData, a as PaymentValidationError, V as VerifyOptions, b as VerifyResult, S as SubCloser, N as Network, A as Agent, E as ElisymIdentity, C as CapabilityCard, c as SubmitJobOptions, J as JobSubscriptionOptions, d as Job, e as PingResult, f as ElisymClientConfig, g as AgentConfig } from './types-CII4k_8d.cjs';
-export { h as Capability, I as Identity, i as JobStatus, j as JobUpdateCallbacks, L as LlmConfig, k as NetworkStats, l as PaymentAddress, m as PaymentInfo, n as PaymentValidationCode, W as WalletConfig } from './types-CII4k_8d.cjs';
 import { Filter, Event } from 'nostr-tools';
 
+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[];
+}
+
 /**
  * Protocol fee + treasury inputs for building a payment request.
  *
@@ -386,14 +522,10 @@ declare function timeAgo(unix: number): string;
 declare function truncateKey(hex: string, chars?: number): string;
 
 /**
- * Shared agent config - validation and serialization.
+ * Agent-name validation shared between CLI and MCP.
  * Browser-safe - no Node.js imports.
- * parseConfig lives in config-node.ts (exported from @elisym/sdk/node).
  */
-
 declare function validateAgentName(name: string): void;
-/** Serialize an AgentConfig to JSON string. */
-declare function serializeConfig(config: AgentConfig): string;
 
 /** A Set that evicts the oldest entries when it exceeds maxSize. Uses a ring buffer for O(1) eviction. */
 declare class BoundedSet<T> {
@@ -482,4 +614,4 @@ declare const LIMITS: {
     readonly MAX_CAPABILITY_LENGTH: 64;
 };
 
-export { Agent, AgentConfig, BoundedSet, CapabilityCard, DEFAULTS, DEFAULT_KIND_OFFSET, DiscoveryService, ElisymClient, ElisymClientConfig, type ElisymClientFullConfig, ElisymIdentity, type GetProtocolConfigOptions, Job, JobSubscriptionOptions, KIND_APP_HANDLER, KIND_JOB_FEEDBACK, KIND_JOB_REQUEST, KIND_JOB_REQUEST_BASE, KIND_JOB_RESULT, KIND_JOB_RESULT_BASE, KIND_PING, KIND_PONG, LAMPORTS_PER_SOL, LIMITS, MarketplaceService, MediaService, Network, NostrPool, PROTOCOL_FEE_BPS, PROTOCOL_PROGRAM_ID_DEVNET, PROTOCOL_TREASURY, PaymentRequestData, type PaymentStrategy, PaymentValidationError, PingResult, PingService, type ProtocolCluster, type ProtocolConfig, type ProtocolConfigInput, RELAYS, SolanaPaymentStrategy, SubCloser, SubmitJobOptions, VerifyOptions, VerifyResult, assertExpiry, assertLamports, buildPaymentInstructions, calculateProtocolFee, clearProtocolConfigCache, createPaymentRequestWithOnchainConfig, formatSol, getProtocolConfig, getProtocolProgramId, jobRequestKind, jobResultKind, nip44Decrypt, nip44Encrypt, serializeConfig, timeAgo, toDTag, truncateKey, validateAgentName, validateExpiry };
+export { type Agent, BoundedSet, type CapabilityCard, DEFAULTS, DEFAULT_KIND_OFFSET, DiscoveryService, ElisymClient, type ElisymClientConfig, type ElisymClientFullConfig, ElisymIdentity, type GetProtocolConfigOptions, type Job, type JobStatus, type JobSubscriptionOptions, type JobUpdateCallbacks, KIND_APP_HANDLER, KIND_JOB_FEEDBACK, KIND_JOB_REQUEST, KIND_JOB_REQUEST_BASE, KIND_JOB_RESULT, KIND_JOB_RESULT_BASE, KIND_PING, KIND_PONG, LAMPORTS_PER_SOL, LIMITS, MarketplaceService, MediaService, type Network, type NetworkStats, NostrPool, PROTOCOL_FEE_BPS, PROTOCOL_PROGRAM_ID_DEVNET, PROTOCOL_TREASURY, type PaymentInfo, type PaymentRequestData, type PaymentStrategy, type PaymentValidationCode, type PaymentValidationError, type PingResult, PingService, type ProtocolCluster, type ProtocolConfig, type ProtocolConfigInput, RELAYS, SolanaPaymentStrategy, type SubCloser, type SubmitJobOptions, type VerifyOptions, type VerifyResult, assertExpiry, assertLamports, buildPaymentInstructions, calculateProtocolFee, clearProtocolConfigCache, createPaymentRequestWithOnchainConfig, formatSol, getProtocolConfig, getProtocolProgramId, jobRequestKind, jobResultKind, nip44Decrypt, nip44Encrypt, timeAgo, toDTag, truncateKey, validateAgentName, validateExpiry };

package/dist/index.d.ts

@@ -1,8 +1,144 @@
 import { Address, TransactionSigner, Rpc, SolanaRpcApi } from '@solana/kit';
-import { P as PaymentRequestData, a as PaymentValidationError, V as VerifyOptions, b as VerifyResult, S as SubCloser, N as Network, A as Agent, E as ElisymIdentity, C as CapabilityCard, c as SubmitJobOptions, J as JobSubscriptionOptions, d as Job, e as PingResult, f as ElisymClientConfig, g as AgentConfig } from './types-CII4k_8d.js';
-export { h as Capability, I as Identity, i as JobStatus, j as JobUpdateCallbacks, L as LlmConfig, k as NetworkStats, l as PaymentAddress, m as PaymentInfo, n as PaymentValidationCode, W as WalletConfig } from './types-CII4k_8d.js';
 import { Filter, Event } from 'nostr-tools';
 
+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[];
+}
+
 /**
  * Protocol fee + treasury inputs for building a payment request.
  *
@@ -386,14 +522,10 @@ declare function timeAgo(unix: number): string;
 declare function truncateKey(hex: string, chars?: number): string;
 
 /**
- * Shared agent config - validation and serialization.
+ * Agent-name validation shared between CLI and MCP.
  * Browser-safe - no Node.js imports.
- * parseConfig lives in config-node.ts (exported from @elisym/sdk/node).
  */
-
 declare function validateAgentName(name: string): void;
-/** Serialize an AgentConfig to JSON string. */
-declare function serializeConfig(config: AgentConfig): string;
 
 /** A Set that evicts the oldest entries when it exceeds maxSize. Uses a ring buffer for O(1) eviction. */
 declare class BoundedSet<T> {
@@ -482,4 +614,4 @@ declare const LIMITS: {
     readonly MAX_CAPABILITY_LENGTH: 64;
 };
 
-export { Agent, AgentConfig, BoundedSet, CapabilityCard, DEFAULTS, DEFAULT_KIND_OFFSET, DiscoveryService, ElisymClient, ElisymClientConfig, type ElisymClientFullConfig, ElisymIdentity, type GetProtocolConfigOptions, Job, JobSubscriptionOptions, KIND_APP_HANDLER, KIND_JOB_FEEDBACK, KIND_JOB_REQUEST, KIND_JOB_REQUEST_BASE, KIND_JOB_RESULT, KIND_JOB_RESULT_BASE, KIND_PING, KIND_PONG, LAMPORTS_PER_SOL, LIMITS, MarketplaceService, MediaService, Network, NostrPool, PROTOCOL_FEE_BPS, PROTOCOL_PROGRAM_ID_DEVNET, PROTOCOL_TREASURY, PaymentRequestData, type PaymentStrategy, PaymentValidationError, PingResult, PingService, type ProtocolCluster, type ProtocolConfig, type ProtocolConfigInput, RELAYS, SolanaPaymentStrategy, SubCloser, SubmitJobOptions, VerifyOptions, VerifyResult, assertExpiry, assertLamports, buildPaymentInstructions, calculateProtocolFee, clearProtocolConfigCache, createPaymentRequestWithOnchainConfig, formatSol, getProtocolConfig, getProtocolProgramId, jobRequestKind, jobResultKind, nip44Decrypt, nip44Encrypt, serializeConfig, timeAgo, toDTag, truncateKey, validateAgentName, validateExpiry };
+export { type Agent, BoundedSet, type CapabilityCard, DEFAULTS, DEFAULT_KIND_OFFSET, DiscoveryService, ElisymClient, type ElisymClientConfig, type ElisymClientFullConfig, ElisymIdentity, type GetProtocolConfigOptions, type Job, type JobStatus, type JobSubscriptionOptions, type JobUpdateCallbacks, KIND_APP_HANDLER, KIND_JOB_FEEDBACK, KIND_JOB_REQUEST, KIND_JOB_REQUEST_BASE, KIND_JOB_RESULT, KIND_JOB_RESULT_BASE, KIND_PING, KIND_PONG, LAMPORTS_PER_SOL, LIMITS, MarketplaceService, MediaService, type Network, type NetworkStats, NostrPool, PROTOCOL_FEE_BPS, PROTOCOL_PROGRAM_ID_DEVNET, PROTOCOL_TREASURY, type PaymentInfo, type PaymentRequestData, type PaymentStrategy, type PaymentValidationCode, type PaymentValidationError, type PingResult, PingService, type ProtocolCluster, type ProtocolConfig, type ProtocolConfigInput, RELAYS, SolanaPaymentStrategy, type SubCloser, type SubmitJobOptions, type VerifyOptions, type VerifyResult, assertExpiry, assertLamports, buildPaymentInstructions, calculateProtocolFee, clearProtocolConfigCache, createPaymentRequestWithOnchainConfig, formatSol, getProtocolConfig, getProtocolProgramId, jobRequestKind, jobResultKind, nip44Decrypt, nip44Encrypt, timeAgo, toDTag, truncateKey, validateAgentName, validateExpiry };

package/dist/index.js

@@ -292,6 +292,9 @@ var SolanaPaymentStrategy = class {
     }
     const expectedFee = calculateProtocolFee(data.amount, config.feeBps);
     const treasury = config.treasury;
+    if (expectedFee === 0) {
+      return null;
+    }
     const { fee_address, fee_amount } = data;
     const hasFeeAddress = typeof fee_address === "string" && fee_address.length > 0;
     const hasFeeAmount = typeof fee_amount === "number" && fee_amount > 0;
@@ -2267,10 +2270,7 @@ function validateAgentName(name) {
     throw new Error("Agent name must be 1-64 characters, alphanumeric, underscore, or hyphen.");
   }
 }
-function serializeConfig(config) {
-  return JSON.stringify(config, null, 2) + "\n";
-}
 
-export { BoundedSet, DEFAULTS, DEFAULT_KIND_OFFSET, DiscoveryService, ElisymClient, ElisymIdentity, KIND_APP_HANDLER, KIND_JOB_FEEDBACK, KIND_JOB_REQUEST, KIND_JOB_REQUEST_BASE, KIND_JOB_RESULT, KIND_JOB_RESULT_BASE, KIND_PING, KIND_PONG, LAMPORTS_PER_SOL, LIMITS, MarketplaceService, MediaService, NostrPool, PROTOCOL_FEE_BPS, PROTOCOL_PROGRAM_ID_DEVNET, PROTOCOL_TREASURY, PingService, RELAYS, SolanaPaymentStrategy, assertExpiry, assertLamports, buildPaymentInstructions, calculateProtocolFee, clearProtocolConfigCache, createPaymentRequestWithOnchainConfig, formatSol, getProtocolConfig, getProtocolProgramId, jobRequestKind, jobResultKind, nip44Decrypt, nip44Encrypt, serializeConfig, timeAgo, toDTag, truncateKey, validateAgentName, validateExpiry };
+export { BoundedSet, DEFAULTS, DEFAULT_KIND_OFFSET, DiscoveryService, ElisymClient, ElisymIdentity, KIND_APP_HANDLER, KIND_JOB_FEEDBACK, KIND_JOB_REQUEST, KIND_JOB_REQUEST_BASE, KIND_JOB_RESULT, KIND_JOB_RESULT_BASE, KIND_PING, KIND_PONG, LAMPORTS_PER_SOL, LIMITS, MarketplaceService, MediaService, NostrPool, PROTOCOL_FEE_BPS, PROTOCOL_PROGRAM_ID_DEVNET, PROTOCOL_TREASURY, PingService, RELAYS, SolanaPaymentStrategy, assertExpiry, assertLamports, buildPaymentInstructions, calculateProtocolFee, clearProtocolConfigCache, createPaymentRequestWithOnchainConfig, formatSol, getProtocolConfig, getProtocolProgramId, jobRequestKind, jobResultKind, nip44Decrypt, nip44Encrypt, timeAgo, toDTag, truncateKey, validateAgentName, validateExpiry };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map