@vesper85/strategy-sdk 0.1.0 → 0.1.2

package/dist/types/event-types.d.ts

@@ -4,7 +4,7 @@
 /**
  * Supported event types
  */
-export type EventType = 'price' | 'orderbook' | 'time' | 'trade' | 'fill' | 'liquidation' | 'custom';
+export type EventType = 'price' | 'orderbook' | 'time' | 'trade' | 'fill' | 'liquidation' | 'wallet' | 'opportunity' | 'custom';
 /**
  * Conditions for filtering events
  */
@@ -25,22 +25,103 @@ export interface EventConditions {
     spreadBelow?: number;
     /** Trigger when volume exceeds this value */
     volumeAbove?: number;
+    /** Minimum smart score for wallet events */
+    minSmartScore?: number;
+    /** Minimum win rate for wallet events */
+    minWinRate?: number;
+    /** Minimum trade count for wallet events */
+    minTradeCount?: number;
+    /** Minimum conviction rate for wallet events */
+    minConvictionRate?: number;
+    /** Minimum opportunity score */
+    minScore?: number;
+    /** Filter by strategy type */
+    strategyType?: string;
+    /** Filter by status */
+    status?: 'active' | 'dismissed';
     [key: string]: any;
 }
 /**
- * Event subscription configuration
- * Defines what events a strategy wants to receive
+ * Event source type - determines which WebSocket server to connect to
  */
-export interface EventSubscription {
-    /** Type of event to subscribe to */
-    type: EventType;
-    /** Market/asset identifier (e.g., token ID, trading pair like "BTC-USD") */
-    market?: string;
+export type EventSourceType = 'osiris' | 'polymarket';
+/**
+ * Base subscription properties shared by all subscription types
+ */
+interface BaseSubscription {
+    /** Event source type (default: 'osiris') */
+    eventSource?: EventSourceType;
     /** Optional filter conditions */
     conditions?: EventConditions;
-    /** Optional custom channel name for the event source */
-    channel?: string;
 }
+/**
+ * Market subscription for price, orderbook, trade, and fill events
+ * Maps to Osiris topic: market:{market}
+ * Maps to Polymarket RTDS topics: crypto_prices, trades, orders
+ */
+export interface MarketSubscription extends BaseSubscription {
+    /** Type of market event to subscribe to */
+    type: 'price' | 'orderbook' | 'trade' | 'fill';
+    /** Market/asset identifier (e.g., market slug, token ID, trading pair like "BTC-USD") */
+    market: string;
+}
+/**
+ * Wallet subscription for wallet analysis events (Osiris only)
+ * Maps to Osiris topic: wallet:{wallet}
+ * Not supported by Polymarket RTDS
+ */
+export interface WalletSubscription extends BaseSubscription {
+    /** Wallet subscription type */
+    type: 'wallet';
+    /** Wallet address to subscribe to */
+    wallet: string;
+}
+/**
+ * Opportunity subscription for trading opportunity events (Osiris only)
+ * Maps to Osiris topic: opps:{filter}
+ * Not supported by Polymarket RTDS
+ */
+export interface OpportunitySubscription extends BaseSubscription {
+    /** Opportunity subscription type */
+    type: 'opportunity';
+    /**
+     * Optional filter for opportunities:
+     * - 'all' - All opportunities (default)
+     * - Strategy type (e.g., 'wide_spread_markets', 'closing_soon')
+     * - Market slug for specific market opportunities
+     */
+    filter?: string;
+}
+/**
+ * Custom subscription for user-defined event topics
+ * Allows direct topic specification for advanced use cases
+ */
+export interface CustomSubscription extends BaseSubscription {
+    /** Custom subscription type */
+    type: 'custom';
+    /** Full topic string (e.g., 'custom:my-topic' or any valid topic) */
+    topic: string;
+}
+/**
+ * Event subscription configuration (discriminated union)
+ * Defines what events a strategy wants to receive
+ *
+ * @example Market subscription
+ * ```typescript
+ * { type: 'price', market: 'BTC-USD' }
+ * ```
+ *
+ * @example Wallet subscription
+ * ```typescript
+ * { type: 'wallet', wallet: '0x123...', conditions: { minWinRate: 60 } }
+ * ```
+ *
+ * @example Opportunity subscription
+ * ```typescript
+ * { type: 'opportunity', filter: 'wide_spread_markets' }
+ * ```
+ */
+export type EventSubscription = MarketSubscription | WalletSubscription | OpportunitySubscription | CustomSubscription;
 /**
  * Data payload for strategy events
  */
@@ -82,8 +163,10 @@ export interface StrategyEvent {
     type: EventType;
     /** Timestamp when event occurred (Unix milliseconds) */
     timestamp: number;
-    /** Market/asset this event relates to */
+    /** Market/asset this event relates to (for market events) */
     market?: string;
+    /** Wallet address this event relates to (for wallet events) */
+    wallet?: string;
     /** Event-specific data payload */
     data: EventData;
 }
@@ -99,4 +182,21 @@ export interface EventSourceUnsubscribeMessage {
     subscriptions: EventSubscription[];
 }
 export type EventSourceMessage = EventSourceSubscribeMessage | EventSourceUnsubscribeMessage;
+/**
+ * Check if subscription is a MarketSubscription
+ */
+export declare function isMarketSubscription(sub: EventSubscription): sub is MarketSubscription;
+/**
+ * Check if subscription is a WalletSubscription
+ */
+export declare function isWalletSubscription(sub: EventSubscription): sub is WalletSubscription;
+/**
+ * Check if subscription is an OpportunitySubscription
+ */
+export declare function isOpportunitySubscription(sub: EventSubscription): sub is OpportunitySubscription;
+/**
+ * Check if subscription is a CustomSubscription
+ */
+export declare function isCustomSubscription(sub: EventSubscription): sub is CustomSubscription;
+export {};
 //# sourceMappingURL=event-types.d.ts.map

package/dist/types/osiris.d.ts

@@ -1,4 +1,4 @@
-import type { OHLCV, TAParams } from "@vesper85/technical-indicators";
+import type { OHLCV, TAParams } from "@osiris-ai/technical-indicators";
 import type { GammaMarket, Event as GammaEvent, Tag, Team, Sport, Series, Comment as GammaComment, SearchResults, PaginatedResponse, MarketFilters, EventFilters, EventPaginationFilters, PaginationParams, SearchParams } from "polymarket-gamma";
 import type { ClearinghouseState, SpotMeta, SpotClearinghouseState, SpotMetaAndAssetCtxs, Meta, MetaAndAssetCtxs, UserFunding, UserNonFundingLedgerUpdates, FundingHistory, PredictedFundings, PerpsAtOpenInterestCap, PerpDexLimits, AllMids, UserOpenOrders, FrontendOpenOrders, UserFills, UserRateLimit, OrderStatus, L2Book, CandleSnapshot, HistoricalOrder, TwapSliceFill, SubAccount, VaultDetails, VaultEquity, UserRole, Delegation, DelegatorSummary, DelegatorHistoryEntry, DelegatorReward, ValidatorSummary, VaultSummary, UserFees, PortfolioPeriods, PreTransferCheck, Referral, ExtraAgent, LegalCheck, TwapHistory, MultiSigSigners, BuilderFeeApproval, UserOrderHistory } from "hyperliquid";
 export interface OsirisState {
@@ -128,10 +128,7 @@ export interface PolymarketClientOptions {
     mcpUrl?: string;
     /**
      * MCP OAuth access token for authenticated MCP calls.
-     * IMPORTANT: This must be an MCP-specific token obtained through the Osiris Hub
-     * OAuth flow for MCP packages (via /hub/authorize endpoint with MCP scopes).
-     * This is NOT the same as the general backend access token.
-     * Required scopes: osiris:auth, osiris:auth:action
+     * Required when using MCP mode for order placement.
      */
     mcpAccessToken?: string;
     /**
@@ -278,50 +275,16 @@ export interface PolymarketAPI {
      * @returns Order book data
      */
     getOrderBook(tokenId: string): Promise<PolymarketOrderBook>;
-    /**
-     * Place a limit buy order
-     * @param tokenId Token ID of the outcome
-     * @param price Price per share (0-1 range)
-     * @param size Number of shares to buy
-     * @returns Order response
-     */
-    buyLimit(tokenId: string, price: number, size: number): Promise<PolymarketOrderResponse>;
-    /**
-     * Place a limit sell order
-     * @param tokenId Token ID of the outcome
-     * @param price Price per share (0-1 range)
-     * @param size Number of shares to sell
-     * @returns Order response
-     */
-    sellLimit(tokenId: string, price: number, size: number): Promise<PolymarketOrderResponse>;
-    /**
-     * Place a market buy order (executes immediately at best price)
-     * @param tokenId Token ID of the outcome
-     * @param amount Amount in USDC to spend
-     * @param slippage Slippage tolerance as decimal (e.g., 0.05 for 5%). Default: 0.05
-     * @returns Order response
-     */
-    buyMarket(tokenId: string, amount: number, slippage?: number): Promise<PolymarketOrderResponse>;
-    /**
-     * Place a market sell order (executes immediately at best price)
-     * @param tokenId Token ID of the outcome
-     * @param size Number of shares to sell
-     * @param slippage Slippage tolerance as decimal (e.g., 0.05 for 5%). Default: 0.05
-     * @returns Order response
-     */
-    sellMarket(tokenId: string, size: number, slippage?: number): Promise<PolymarketOrderResponse>;
     /**
      * Buy shares of an outcome token (uses market order)
      * @param tokenId Token ID of the outcome
      * @param size Amount in USDC to spend
-     * @deprecated Use buyMarket() instead
      */
     buy(tokenId: string, size: number): Promise<void>;
     /**
      * Sell shares of an outcome token (uses market order)
      * @param tokenId Token ID of the outcome
      * @param size Number of shares to sell
-     * @deprecated Use sellMarket() instead
      */
     sell(tokenId: string, size: number): Promise<void>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vesper85/strategy-sdk",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "description": "SDK for writing and running trading strategies with Polymarket and Hyperliquid integrations",
   "keywords": [
@@ -15,8 +15,9 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "default": "./dist/index.js"
     },
     "./package.json": "./package.json"
   },