tenzro-sdk 0.1.0

package/dist/settlement.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SettlementClient = void 0;
+/**
+ * Client for payment settlement operations.
+ * Supports immediate settlement, escrow, and micropayment channels.
+ */
+class SettlementClient {
+    rpc;
+    constructor(rpc) {
+        this.rpc = rpc;
+    }
+    /**
+     * Settle a payment for AI inference or other services.
+     * @param request - Settlement request parameters
+     * @returns Settlement receipt with transaction details
+     */
+    async settle(request) {
+        return this.rpc.call("tenzro_settle", [request]);
+    }
+    /**
+     * Get the status of a settlement by receipt ID.
+     * @param receiptId - The settlement receipt identifier
+     * @returns Settlement receipt or null if not found
+     */
+    async getSettlement(receiptId) {
+        return this.rpc.call("tenzro_getSettlement", [
+            receiptId,
+        ]);
+    }
+    /**
+     * Create an escrow that releases payment when conditions are met.
+     * @param payee - Address receiving the payment
+     * @param amount - Amount to escrow (in smallest unit)
+     * @param asset - Asset identifier (e.g., "TNZO")
+     * @param conditions - JSON-encoded release conditions
+     * @returns Escrow ID
+     */
+    async createEscrow(payee, amount, asset, conditions) {
+        return this.rpc.call("tenzro_createEscrow", [
+            {
+                payee,
+                amount: amount.toString(),
+                asset,
+                conditions,
+            },
+        ]);
+    }
+    /**
+     * Release funds from an escrow.
+     * @param escrowId - The escrow identifier
+     * @param proof - Optional proof that conditions are met
+     * @returns Transaction hash
+     */
+    async releaseEscrow(escrowId, proof) {
+        return this.rpc.call("tenzro_releaseEscrow", [
+            { escrow_id: escrowId, proof },
+        ]);
+    }
+    /**
+     * Open a micropayment channel for streaming payments.
+     * @param payee - Address receiving payments
+     * @param deposit - Initial deposit amount
+     * @returns Channel ID
+     */
+    async openPaymentChannel(payee, deposit) {
+        return this.rpc.call("tenzro_openPaymentChannel", [
+            {
+                payee,
+                deposit: deposit.toString(),
+            },
+        ]);
+    }
+    /**
+     * Close a micropayment channel.
+     * @param channelId - The channel identifier to close
+     * @returns Channel closure result
+     */
+    async closePaymentChannel(channelId) {
+        return this.rpc.call("tenzro_closePaymentChannel", [
+            { channel_id: channelId },
+        ]);
+    }
+}
+exports.SettlementClient = SettlementClient;
+//# sourceMappingURL=settlement.js.map

package/dist/settlement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settlement.js","sourceRoot":"","sources":["../src/settlement.ts"],"names":[],"mappings":";;;AAGA;;;GAGG;AACH,MAAa,gBAAgB;IACP;IAApB,YAAoB,GAAc;QAAd,QAAG,GAAH,GAAG,CAAW;IAAG,CAAC;IAEtC;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,OAAyB;QACpC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAoB,eAAe,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACtE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAAC,SAAiB;QACnC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAA2B,sBAAsB,EAAE;YACrE,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,YAAY,CAChB,KAAa,EACb,MAAc,EACd,KAAa,EACb,UAAkB;QAElB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAS,qBAAqB,EAAE;YAClD;gBACE,KAAK;gBACL,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;gBACzB,KAAK;gBACL,UAAU;aACX;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CAAC,QAAgB,EAAE,KAAc;QAClD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAS,sBAAsB,EAAE;YACnD,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE;SAC/B,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,kBAAkB,CAAC,KAAa,EAAE,OAAe;QACrD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAS,2BAA2B,EAAE;YACxD;gBACE,KAAK;gBACL,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE;aAC5B;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,mBAAmB,CAAC,SAAiB;QACzC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,4BAA4B,EAAE;YACjD,EAAE,UAAU,EAAE,SAAS,EAAE;SAC1B,CAAC,CAAC;IACL,CAAC;CACF;AApFD,4CAoFC"}

package/dist/skill.d.ts

@@ -0,0 +1,55 @@
+import type { RpcClient } from './rpc';
+import type { SkillInfo, SkillFilter, RegisterSkillParams, UpdateSkillParams, SkillExecutionResult, SkillUsage } from './types';
+/**
+ * Client for the Tenzro Skills Registry.
+ * Register, discover, and invoke reusable skills on the network.
+ */
+export declare class SkillClient {
+    private readonly rpc;
+    constructor(rpc: RpcClient);
+    /**
+     * Register a new skill in the registry.
+     * @param params - Skill definition including name, description, version, and capabilities
+     * @returns The registered skill
+     */
+    registerSkill(params: RegisterSkillParams): Promise<SkillInfo>;
+    /**
+     * List skills with optional filtering.
+     * @param filter - Optional filter criteria (category, capability, tag, etc.)
+     * @returns Array of matching skills
+     */
+    listSkills(filter?: SkillFilter): Promise<SkillInfo[]>;
+    /**
+     * Search skills by free-text query.
+     * @param query - Search query string
+     * @returns Array of matching skills ranked by relevance
+     */
+    searchSkills(query: string): Promise<SkillInfo[]>;
+    /**
+     * Execute a skill with the given input.
+     * @param skillId - The skill to invoke
+     * @param input - Input payload (JSON-serializable string or object)
+     * @returns Execution result with output and duration
+     */
+    useSkill(skillId: string, input: string): Promise<SkillExecutionResult>;
+    /**
+     * Get a skill by ID.
+     * @param skillId - The skill identifier
+     * @returns Skill information
+     */
+    getSkill(skillId: string): Promise<SkillInfo>;
+    /**
+     * Update an existing skill (must be the creator).
+     * @param skillId - The skill to update
+     * @param params - Fields to update (partial)
+     * @returns Updated skill
+     */
+    updateSkill(skillId: string, params: UpdateSkillParams): Promise<SkillInfo>;
+    /**
+     * Get usage statistics for a skill.
+     * @param skillId - The skill identifier
+     * @returns Usage statistics including total invocations and last used timestamp
+     */
+    getSkillUsage(skillId: string): Promise<SkillUsage>;
+}
+//# sourceMappingURL=skill.d.ts.map

package/dist/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACX,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,SAAS;IAE3C;;;;OAIG;IACG,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,CAAC;IAIpE;;;;OAIG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAI5D;;;;OAIG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAIvD;;;;;OAKG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAM7E;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAInD;;;;;OAKG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC;IAMjF;;;;OAIG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAK1D"}

package/dist/skill.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkillClient = void 0;
+/**
+ * Client for the Tenzro Skills Registry.
+ * Register, discover, and invoke reusable skills on the network.
+ */
+class SkillClient {
+    rpc;
+    constructor(rpc) {
+        this.rpc = rpc;
+    }
+    /**
+     * Register a new skill in the registry.
+     * @param params - Skill definition including name, description, version, and capabilities
+     * @returns The registered skill
+     */
+    async registerSkill(params) {
+        return this.rpc.call('tenzro_registerSkill', [params]);
+    }
+    /**
+     * List skills with optional filtering.
+     * @param filter - Optional filter criteria (category, capability, tag, etc.)
+     * @returns Array of matching skills
+     */
+    async listSkills(filter) {
+        return this.rpc.call('tenzro_listSkills', [filter ?? {}]);
+    }
+    /**
+     * Search skills by free-text query.
+     * @param query - Search query string
+     * @returns Array of matching skills ranked by relevance
+     */
+    async searchSkills(query) {
+        return this.rpc.call('tenzro_searchSkills', [{ query }]);
+    }
+    /**
+     * Execute a skill with the given input.
+     * @param skillId - The skill to invoke
+     * @param input - Input payload (JSON-serializable string or object)
+     * @returns Execution result with output and duration
+     */
+    async useSkill(skillId, input) {
+        return this.rpc.call('tenzro_useSkill', [
+            { skill_id: skillId, input },
+        ]);
+    }
+    /**
+     * Get a skill by ID.
+     * @param skillId - The skill identifier
+     * @returns Skill information
+     */
+    async getSkill(skillId) {
+        return this.rpc.call('tenzro_getSkill', [{ skill_id: skillId }]);
+    }
+    /**
+     * Update an existing skill (must be the creator).
+     * @param skillId - The skill to update
+     * @param params - Fields to update (partial)
+     * @returns Updated skill
+     */
+    async updateSkill(skillId, params) {
+        return this.rpc.call('tenzro_updateSkill', [
+            { skill_id: skillId, ...params },
+        ]);
+    }
+    /**
+     * Get usage statistics for a skill.
+     * @param skillId - The skill identifier
+     * @returns Usage statistics including total invocations and last used timestamp
+     */
+    async getSkillUsage(skillId) {
+        return this.rpc.call('tenzro_getSkillUsage', [
+            { skill_id: skillId },
+        ]);
+    }
+}
+exports.SkillClient = SkillClient;
+//# sourceMappingURL=skill.js.map

package/dist/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":";;;AAUA;;;GAGG;AACH,MAAa,WAAW;IACO;IAA7B,YAA6B,GAAc;QAAd,QAAG,GAAH,GAAG,CAAW;IAAG,CAAC;IAE/C;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAAC,MAA2B;QAC7C,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAY,sBAAsB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IACpE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,MAAoB;QACnC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAc,mBAAmB,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;IACzE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAC,KAAa;QAC9B,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAc,qBAAqB,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,KAAa;QAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAuB,iBAAiB,EAAE;YAC5D,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE;SAC7B,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAY,iBAAiB,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,MAAyB;QAC1D,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAY,oBAAoB,EAAE;YACpD,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE;SACjC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAAC,OAAe;QACjC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAa,sBAAsB,EAAE;YACvD,EAAE,QAAQ,EAAE,OAAO,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;CACF;AAzED,kCAyEC"}

package/dist/staking.d.ts

@@ -0,0 +1,42 @@
+import type { RpcClient } from './rpc';
+import type { StakingRole, StakeResult, UnstakeResult, StakingBalance, StakingRewards, UnbondingEntry } from './types';
+/**
+ * Client for TNZO token staking operations.
+ * Stake as a validator, model provider, or TEE provider.
+ */
+export declare class StakingClient {
+    private readonly rpc;
+    constructor(rpc: RpcClient);
+    /**
+     * Stake TNZO tokens for a given role.
+     * @param amount - Amount of TNZO to stake (decimal string, e.g. "1000")
+     * @param role - Staking role: "validator", "model_provider", or "tee_provider"
+     * @returns Stake result with transaction hash and status
+     */
+    stake(amount: string, role: StakingRole): Promise<StakeResult>;
+    /**
+     * Unstake TNZO tokens (initiates the unbonding period).
+     * @param amount - Amount of TNZO to unstake (decimal string)
+     * @returns Unstake result with transaction hash, status, and unbonding end time
+     */
+    unstake(amount: string): Promise<UnstakeResult>;
+    /**
+     * Get the staking balance for an address.
+     * @param address - The address to query
+     * @returns Staking balance with staked and available amounts
+     */
+    getStakingBalance(address: string): Promise<StakingBalance>;
+    /**
+     * Get pending and claimed staking rewards for an address.
+     * @param address - The address to query
+     * @returns Rewards information
+     */
+    getRewards(address: string): Promise<StakingRewards>;
+    /**
+     * Get unbonding entries for an address.
+     * @param address - The address to query
+     * @returns Array of unbonding entries with completion times
+     */
+    getUnbonding(address: string): Promise<UnbondingEntry[]>;
+}
+//# sourceMappingURL=staking.d.ts.map

package/dist/staking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staking.d.ts","sourceRoot":"","sources":["../src/staking.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,aAAa,EACb,cAAc,EACd,cAAc,EACd,cAAc,EACf,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,SAAS;IAE3C;;;;;OAKG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAIpE;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIrD;;;;OAIG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAMjE;;;;OAIG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAM1D;;;;OAIG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAK/D"}

package/dist/staking.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StakingClient = void 0;
+/**
+ * Client for TNZO token staking operations.
+ * Stake as a validator, model provider, or TEE provider.
+ */
+class StakingClient {
+    rpc;
+    constructor(rpc) {
+        this.rpc = rpc;
+    }
+    /**
+     * Stake TNZO tokens for a given role.
+     * @param amount - Amount of TNZO to stake (decimal string, e.g. "1000")
+     * @param role - Staking role: "validator", "model_provider", or "tee_provider"
+     * @returns Stake result with transaction hash and status
+     */
+    async stake(amount, role) {
+        return this.rpc.call('tenzro_stake', [{ amount, role }]);
+    }
+    /**
+     * Unstake TNZO tokens (initiates the unbonding period).
+     * @param amount - Amount of TNZO to unstake (decimal string)
+     * @returns Unstake result with transaction hash, status, and unbonding end time
+     */
+    async unstake(amount) {
+        return this.rpc.call('tenzro_unstake', [{ amount }]);
+    }
+    /**
+     * Get the staking balance for an address.
+     * @param address - The address to query
+     * @returns Staking balance with staked and available amounts
+     */
+    async getStakingBalance(address) {
+        return this.rpc.call('tenzro_getStakingBalance', [
+            { address },
+        ]);
+    }
+    /**
+     * Get pending and claimed staking rewards for an address.
+     * @param address - The address to query
+     * @returns Rewards information
+     */
+    async getRewards(address) {
+        return this.rpc.call('tenzro_getStakingRewards', [
+            { address },
+        ]);
+    }
+    /**
+     * Get unbonding entries for an address.
+     * @param address - The address to query
+     * @returns Array of unbonding entries with completion times
+     */
+    async getUnbonding(address) {
+        return this.rpc.call('tenzro_getUnbonding', [
+            { address },
+        ]);
+    }
+}
+exports.StakingClient = StakingClient;
+//# sourceMappingURL=staking.js.map

package/dist/staking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staking.js","sourceRoot":"","sources":["../src/staking.ts"],"names":[],"mappings":";;;AAUA;;;GAGG;AACH,MAAa,aAAa;IACK;IAA7B,YAA6B,GAAc;QAAd,QAAG,GAAH,GAAG,CAAW;IAAG,CAAC;IAE/C;;;;;OAKG;IACH,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,IAAiB;QAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAc,cAAc,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,MAAc;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAgB,gBAAgB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACtE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,iBAAiB,CAAC,OAAe;QACrC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAiB,0BAA0B,EAAE;YAC/D,EAAE,OAAO,EAAE;SACZ,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,OAAe;QAC9B,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAiB,0BAA0B,EAAE;YAC/D,EAAE,OAAO,EAAE;SACZ,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAC,OAAe;QAChC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAmB,qBAAqB,EAAE;YAC5D,EAAE,OAAO,EAAE;SACZ,CAAC,CAAC;IACL,CAAC;CACF;AAtDD,sCAsDC"}

package/dist/streaming.d.ts

@@ -0,0 +1,83 @@
+import type { RpcClient } from './rpc';
+/** Result from a streaming inference call. */
+export interface StreamResult {
+    /** Total number of tokens generated */
+    total_tokens: number;
+    /** Complete generated output */
+    output: string;
+}
+/** Handle to an active event subscription. */
+export interface SubscriptionHandle {
+    /** Subscription identifier */
+    id: string;
+}
+/** SSE connection handle. */
+export interface SseConnection {
+    /** SSE endpoint URL */
+    url: string;
+    /** Abort controller for closing the connection */
+    abort: AbortController;
+}
+/** A real-time event from the node. */
+export interface StreamEvent {
+    /** Event type (e.g., "block", "transaction", "settlement") */
+    type: string;
+    /** Event data */
+    data: unknown;
+    /** Event timestamp */
+    timestamp?: string;
+}
+/**
+ * Client for streaming and real-time operations.
+ *
+ * Provides streaming chat inference via SSE, event subscriptions,
+ * and SSE connections to A2A/MCP servers.
+ */
+export declare class StreamingClient {
+    private readonly rpc;
+    private readonly endpoint;
+    private readonly apiEndpoint;
+    constructor(rpc: RpcClient);
+    /**
+     * Stream inference tokens using an async generator.
+     *
+     * @param modelId - Model identifier (e.g., "gemma4-9b")
+     * @param message - User message to send
+     * @yields Individual tokens as they are generated
+     *
+     * @example
+     * ```typescript
+     * const streaming = client.streaming();
+     * for await (const token of streaming.chatStream("gemma4-9b", "Hello!")) {
+     *   process.stdout.write(token);
+     * }
+     * ```
+     */
+    chatStream(modelId: string, message: string): AsyncGenerator<string>;
+    /**
+     * Stream inference tokens with a callback.
+     *
+     * @param modelId - Model identifier
+     * @param message - User message
+     * @param onToken - Callback invoked for each token
+     * @returns Stream result with total tokens and complete output
+     */
+    chatStreamCallback(modelId: string, message: string, onToken: (token: string) => void): Promise<StreamResult>;
+    /**
+     * Subscribe to real-time events from the node.
+     *
+     * @param eventTypes - Event types to subscribe to (e.g., "block", "transaction")
+     * @param onEvent - Callback invoked for each event
+     * @returns Subscription handle
+     */
+    subscribeEvents(eventTypes: string[], onEvent: (event: StreamEvent) => void): Promise<SubscriptionHandle>;
+    /**
+     * Open an SSE connection to an A2A or MCP endpoint.
+     *
+     * @param endpoint - Full URL of the SSE endpoint
+     * @param onMessage - Callback for incoming SSE messages
+     * @returns SSE connection handle with abort controller
+     */
+    openSseConnection(endpoint: string, onMessage?: (event: StreamEvent) => void): Promise<SseConnection>;
+}
+//# sourceMappingURL=streaming.d.ts.map

package/dist/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../src/streaming.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,8CAA8C;AAC9C,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,8CAA8C;AAC9C,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,6BAA6B;AAC7B,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,uCAAuC;AACvC,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID;;;;;GAKG;AACH,qBAAa,eAAe;IAId,OAAO,CAAC,QAAQ,CAAC,GAAG;IAHhC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAER,GAAG,EAAE,SAAS;IAY3C;;;;;;;;;;;;;;OAcG;IACI,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC;IAoD3E;;;;;;;OAOG;IACG,kBAAkB,CACtB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAC/B,OAAO,CAAC,YAAY,CAAC;IAaxB;;;;;;OAMG;IACG,eAAe,CACnB,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GACpC,OAAO,CAAC,kBAAkB,CAAC;IA0B9B;;;;;;OAMG;IACG,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GACvC,OAAO,CAAC,aAAa,CAAC;CAwC1B"}

package/dist/streaming.js

@@ -0,0 +1,193 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StreamingClient = void 0;
+// ── Client ──
+/**
+ * Client for streaming and real-time operations.
+ *
+ * Provides streaming chat inference via SSE, event subscriptions,
+ * and SSE connections to A2A/MCP servers.
+ */
+class StreamingClient {
+    rpc;
+    endpoint;
+    apiEndpoint;
+    constructor(rpc) {
+        this.rpc = rpc;
+        this.endpoint = rpc.getEndpoint();
+        const ep = this.endpoint;
+        if (ep.includes('rpc.tenzro.network')) {
+            this.apiEndpoint = ep.replace('rpc.tenzro.network', 'api.tenzro.network');
+        }
+        else if (ep.includes('localhost:8545') || ep.includes('127.0.0.1:8545')) {
+            this.apiEndpoint = ep.replace('8545', '8080');
+        }
+        else {
+            this.apiEndpoint = ep;
+        }
+    }
+    /**
+     * Stream inference tokens using an async generator.
+     *
+     * @param modelId - Model identifier (e.g., "gemma4-9b")
+     * @param message - User message to send
+     * @yields Individual tokens as they are generated
+     *
+     * @example
+     * ```typescript
+     * const streaming = client.streaming();
+     * for await (const token of streaming.chatStream("gemma4-9b", "Hello!")) {
+     *   process.stdout.write(token);
+     * }
+     * ```
+     */
+    async *chatStream(modelId, message) {
+        const url = `${this.apiEndpoint.replace(/\/$/, '')}/api/chat`;
+        const body = {
+            model: modelId,
+            messages: [{ role: 'user', content: message }],
+            stream: true,
+        };
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            throw new Error(`Streaming request failed: HTTP ${response.status}`);
+        }
+        if (!response.body) {
+            throw new Error('Response body is null — streaming not supported');
+        }
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                const text = decoder.decode(value, { stream: true });
+                for (const line of text.split('\n')) {
+                    if (!line.startsWith('data: '))
+                        continue;
+                    const data = line.slice(6);
+                    if (data === '[DONE]')
+                        return;
+                    try {
+                        const parsed = JSON.parse(data);
+                        const content = parsed?.choices?.[0]?.delta?.content;
+                        if (typeof content === 'string' && content.length > 0) {
+                            yield content;
+                        }
+                    }
+                    catch {
+                        // Skip non-JSON lines
+                    }
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    /**
+     * Stream inference tokens with a callback.
+     *
+     * @param modelId - Model identifier
+     * @param message - User message
+     * @param onToken - Callback invoked for each token
+     * @returns Stream result with total tokens and complete output
+     */
+    async chatStreamCallback(modelId, message, onToken) {
+        let totalTokens = 0;
+        let output = '';
+        for await (const token of this.chatStream(modelId, message)) {
+            totalTokens++;
+            output += token;
+            onToken(token);
+        }
+        return { total_tokens: totalTokens, output };
+    }
+    /**
+     * Subscribe to real-time events from the node.
+     *
+     * @param eventTypes - Event types to subscribe to (e.g., "block", "transaction")
+     * @param onEvent - Callback invoked for each event
+     * @returns Subscription handle
+     */
+    async subscribeEvents(eventTypes, onEvent) {
+        const subscriptionId = await this.rpc.call('tenzro_subscribe', [
+            { event_types: eventTypes },
+        ]);
+        // Poll for events in the background
+        const poll = async () => {
+            try {
+                while (true) {
+                    const events = await this.rpc.call('tenzro_pollEvents', [
+                        { subscription_id: subscriptionId },
+                    ]);
+                    for (const event of events) {
+                        onEvent(event);
+                    }
+                    await new Promise((resolve) => setTimeout(resolve, 1000));
+                }
+            }
+            catch {
+                // Subscription ended
+            }
+        };
+        poll(); // Fire and forget
+        return { id: subscriptionId };
+    }
+    /**
+     * Open an SSE connection to an A2A or MCP endpoint.
+     *
+     * @param endpoint - Full URL of the SSE endpoint
+     * @param onMessage - Callback for incoming SSE messages
+     * @returns SSE connection handle with abort controller
+     */
+    async openSseConnection(endpoint, onMessage) {
+        const abort = new AbortController();
+        if (onMessage) {
+            // Start reading SSE in the background
+            fetch(endpoint, {
+                headers: { Accept: 'text/event-stream' },
+                signal: abort.signal,
+            })
+                .then(async (response) => {
+                if (!response.ok || !response.body)
+                    return;
+                const reader = response.body.getReader();
+                const decoder = new TextDecoder();
+                try {
+                    while (true) {
+                        const { done, value } = await reader.read();
+                        if (done)
+                            break;
+                        const text = decoder.decode(value, { stream: true });
+                        for (const line of text.split('\n')) {
+                            if (!line.startsWith('data: '))
+                                continue;
+                            try {
+                                const parsed = JSON.parse(line.slice(6));
+                                onMessage(parsed);
+                            }
+                            catch {
+                                // Skip non-JSON
+                            }
+                        }
+                    }
+                }
+                finally {
+                    reader.releaseLock();
+                }
+            })
+                .catch(() => {
+                // Connection closed
+            });
+        }
+        return { url: endpoint, abort };
+    }
+}
+exports.StreamingClient = StreamingClient;
+//# sourceMappingURL=streaming.js.map

package/dist/streaming.js.map

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