investing 0.1.63 → 0.1.64

package/dist/predictos/arbitrage.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../searchQueryGenerator-rCVblXJS.cjs"),t=require("../callGrok-DWO719mN.cjs"),r=require("./data/kalshi.js"),s="https://gamma-api.polymarket.com",o=["gpt-5.2","gpt-5.1","gpt-5-nano","gpt-4.1","gpt-4.1-mini"];function a(e){return o.includes(e)||e.startsWith("gpt-")}function n(e,t){return"polymarket"===e?`https://polymarket.com/event/${t}`:`https://kalshi.com/events/${t}`}exports.findArbitrage=async function(o,i={}){const c=Date.now(),{url:l,model:m}=o;if(!l)throw new Error("Missing required parameter: 'url'");if(!m)throw new Error("Missing required parameter: 'model'");const u=function(e){const t=e.toLowerCase();return t.includes("polymarket.com")?"polymarket":t.includes("kalshi.com")?"kalshi":null}(l);if(!u)throw new Error("Invalid URL. Must be a Polymarket or Kalshi market URL.");let p=null;const y="polymarket"===u?"kalshi":"polymarket";if("polymarket"===u){const e=function(e){try{const t=new URL(e).pathname.split("/").filter(e=>e);return"event"===t[0]&&t.length>=2?t[1]:null}catch{return null}}(l);if(!e)throw new Error("Could not extract event slug from Polymarket URL");p=await async function(e){try{const t=`${s}/events/slug/${e}`,r=await fetch(t);if(!r.ok)return console.error("Polymarket event fetch error:",r.status),null;const o=await r.json(),a=[];if(o.markets&&Array.isArray(o.markets))for(const e of o.markets){const t=e.question||e.title||"";let r=50;if(e.outcomePrices)try{const t=JSON.parse(e.outcomePrices);r=100*parseFloat(t[0])}catch{}t&&a.push({title:t,yesPrice:r})}return{eventTitle:o.title||e.replace(/-/g," "),markets:a,source:"polymarket",identifier:o.slug||e}}catch(t){return console.error("Error fetching Polymarket event:",t),null}}(e)}else{const e=function(e){try{const t=new URL(e).pathname.split("/").filter(e=>e);return("markets"===t[0]||"events"===t[0])&&t.length>=2?(t.length>=4?t[t.length-1]:t[1]).toUpperCase():null}catch{return null}}(l);if(!e)throw new Error("Could not extract ticker from Kalshi URL");p=await async function(e,t){try{const s=await r.dflowRequest(`/event/${e}`,{params:{withNestedMarkets:!0},apiKey:t}),o=[];if(s.markets&&Array.isArray(s.markets))for(const e of s.markets){const t=e.yesSubTitle||"";let r=50;if(e.yesBid&&e.yesAsk){r=(parseFloat(e.yesBid)+parseFloat(e.yesAsk))/2*100}else e.yesBid?r=100*parseFloat(e.yesBid):e.yesAsk&&(r=100*parseFloat(e.yesAsk));t&&o.push({title:t,yesPrice:r})}return{eventTitle:s.title||e,markets:o,source:"kalshi",identifier:e}}catch(s){return console.error("Error fetching Kalshi event:",s),null}}(e,i.dflowApiKey)}if(!p||0===p.markets.length)throw new Error(`Could not fetch event data from ${u}. The event may not exist or have no markets.`);const f=await async function(r,s,o,n,i){const{systemPrompt:c,userPrompt:l}=e.searchQueryGeneratorPrompt({title:r,sourcePlatform:s,targetPlatform:o});let m;if(a(n)){const e=await t.callOpenAIResponses(l,c,"text",n,1,{apiKey:i.openaiApiKey}),r=[];for(const t of e.output)if("message"===t.type){const e=t;r.push(...e.content)}m=r.map(e=>e.text).filter(e=>void 0!==e).join("").trim()}else{const e=await t.callGrokResponses(l,c,"text",n,1,void 0,{apiKey:i.xaiApiKey}),r=[];for(const t of e.output)if("message"===t.type){const e=t;r.push(...e.content)}m=r.map(e=>e.text).filter(e=>void 0!==e).join("").trim()}return m.replace(/['"]/g,"").trim().split(/\s+/).slice(0,2).join(" ")}(p.eventTitle,u,y,m,i);let k;if(k="polymarket"===y?await async function(e){try{const t=`${s}/public-search?q=${encodeURIComponent(e)}&events_status=open`,r=await fetch(t);if(!r.ok)return console.error("Polymarket search error:",r.status),[];const o=await r.json(),a=[];if(o.events&&Array.isArray(o.events))for(const e of o.events){const t=e.slug;if(e.markets&&Array.isArray(e.markets))for(const r of e.markets){const e=r.question||r.title||"";let s=50;if(r.outcomePrices)try{const e=JSON.parse(r.outcomePrices);s=100*parseFloat(e[0])}catch{}e&&a.push({title:e,yesPrice:s,identifier:t})}}return a}catch(t){return console.error("Error searching Polymarket:",t),[]}}(f):await async function(e,t){try{const s=await r.dflowRequest("/search",{params:{q:e,event_status:"open",withNestedMarkets:!0},apiKey:t}),o=[];if(s.events&&Array.isArray(s.events))for(const e of s.events){const t=e.ticker;if(e.markets&&Array.isArray(e.markets))for(const r of e.markets){const e=r.yesSubTitle||r.title||"";let s=50;if(r.yesAsk&&r.yesBid){s=(parseFloat(r.yesAsk)+parseFloat(r.yesBid))/2*100}else r.yesAsk?s=100*parseFloat(r.yesAsk):r.yesBid&&(s=100*parseFloat(r.yesBid));e&&o.push({title:e,yesPrice:s,identifier:t})}}return o}catch(s){return console.error("Error searching Kalshi:",s),[]}}(f,i.dflowApiKey),0===k.length){const e={source:u,name:p.eventTitle,identifier:p.identifier,yesPrice:p.markets[0]?.yesPrice||50,noPrice:100-(p.markets[0]?.yesPrice||50),url:n(u,p.identifier),rawData:{eventTitle:p.eventTitle,markets:p.markets}};return{analysis:{isSameMarket:!1,sameMarketConfidence:0,marketComparisonReasoning:`No matching markets found on ${y} for query "${f}"`,polymarketData:"polymarket"===u?e:void 0,kalshiData:"kalshi"===u?e:void 0,arbitrage:{hasArbitrage:!1},summary:`No matching markets found on ${y}. Cannot determine arbitrage opportunity.`,risks:["No matching market found on the other platform"],recommendation:"Try a different event or check if the market exists on both platforms."},model:"none",sourceMarket:u,searchedMarket:y,processingTimeMs:Date.now()-c}}const{analysis:h,modelUsed:d,tokensUsed:g}=await async function(r,s,o,i,c){const l={source:r.source,name:r.eventTitle,identifier:r.identifier,yesPrice:r.markets[0]?.yesPrice||50,noPrice:100-(r.markets[0]?.yesPrice||50),url:n(r.source,r.identifier)};l.rawData={eventTitle:r.eventTitle,markets:r.markets};const{systemPrompt:m,userPrompt:u}=e.arbitrageAnalysisPrompt({sourceMarket:l,searchResults:s,searchPlatform:o});let p,y,f;if(a(i)){const e=await t.callOpenAIResponses(u,m,"json_object",i,3,{apiKey:c.openaiApiKey});y=e.model,f=e.usage?.total_tokens;const r=[];for(const t of e.output)if("message"===t.type){const e=t;r.push(...e.content)}p=r.map(e=>e.text).filter(e=>void 0!==e).join("\n")}else{const e=await t.callGrokResponses(u,m,"json_object",i,3,void 0,{apiKey:c.xaiApiKey});y=e.model,f=e.usage?.total_tokens;const r=[];for(const t of e.output)if("message"===t.type){const e=t;r.push(...e.content)}p=r.map(e=>e.text).filter(e=>void 0!==e).join("\n")}const k=JSON.parse(p);return{analysis:{isSameMarket:k.isSameMarket,sameMarketConfidence:k.sameMarketConfidence,marketComparisonReasoning:k.marketComparisonReasoning,polymarketData:"polymarket"===r.source?l:k.matchedMarket||void 0,kalshiData:"kalshi"===r.source?l:k.matchedMarket||void 0,arbitrage:k.arbitrage,summary:k.summary,risks:k.risks,recommendation:k.recommendation},modelUsed:y,tokensUsed:f}}(p,k,y,m,i);return{analysis:h,model:d,tokensUsed:g,sourceMarket:u,searchedMarket:y,processingTimeMs:Date.now()-c}};

package/dist/predictos/arbitrage.mjs

@@ -0,0 +1 @@
+import{s as e,a as t}from"../searchQueryGenerator-DIIs9xw5.js";import{a as r,c as s}from"../callGrok-D0D7zBHK.js";import{dflowRequest as o}from"./data/kalshi.mjs";const a="https://gamma-api.polymarket.com",n=["gpt-5.2","gpt-5.1","gpt-5-nano","gpt-4.1","gpt-4.1-mini"];function i(e){return n.includes(e)||e.startsWith("gpt-")}function c(e,t){return"polymarket"===e?`https://polymarket.com/event/${t}`:`https://kalshi.com/events/${t}`}async function l(n,l={}){const m=Date.now(),{url:u,model:p}=n;if(!u)throw new Error("Missing required parameter: 'url'");if(!p)throw new Error("Missing required parameter: 'model'");const y=function(e){const t=e.toLowerCase();return t.includes("polymarket.com")?"polymarket":t.includes("kalshi.com")?"kalshi":null}(u);if(!y)throw new Error("Invalid URL. Must be a Polymarket or Kalshi market URL.");let f=null;const k="polymarket"===y?"kalshi":"polymarket";if("polymarket"===y){const e=function(e){try{const t=new URL(e).pathname.split("/").filter(e=>e);return"event"===t[0]&&t.length>=2?t[1]:null}catch{return null}}(u);if(!e)throw new Error("Could not extract event slug from Polymarket URL");f=await async function(e){try{const t=`${a}/events/slug/${e}`,r=await fetch(t);if(!r.ok)return console.error("Polymarket event fetch error:",r.status),null;const s=await r.json(),o=[];if(s.markets&&Array.isArray(s.markets))for(const e of s.markets){const t=e.question||e.title||"";let r=50;if(e.outcomePrices)try{const t=JSON.parse(e.outcomePrices);r=100*parseFloat(t[0])}catch{}t&&o.push({title:t,yesPrice:r})}return{eventTitle:s.title||e.replace(/-/g," "),markets:o,source:"polymarket",identifier:s.slug||e}}catch(t){return console.error("Error fetching Polymarket event:",t),null}}(e)}else{const e=function(e){try{const t=new URL(e).pathname.split("/").filter(e=>e);return("markets"===t[0]||"events"===t[0])&&t.length>=2?(t.length>=4?t[t.length-1]:t[1]).toUpperCase():null}catch{return null}}(u);if(!e)throw new Error("Could not extract ticker from Kalshi URL");f=await async function(e,t){try{const r=await o(`/event/${e}`,{params:{withNestedMarkets:!0},apiKey:t}),s=[];if(r.markets&&Array.isArray(r.markets))for(const e of r.markets){const t=e.yesSubTitle||"";let r=50;if(e.yesBid&&e.yesAsk){r=(parseFloat(e.yesBid)+parseFloat(e.yesAsk))/2*100}else e.yesBid?r=100*parseFloat(e.yesBid):e.yesAsk&&(r=100*parseFloat(e.yesAsk));t&&s.push({title:t,yesPrice:r})}return{eventTitle:r.title||e,markets:s,source:"kalshi",identifier:e}}catch(r){return console.error("Error fetching Kalshi event:",r),null}}(e,l.dflowApiKey)}if(!f||0===f.markets.length)throw new Error(`Could not fetch event data from ${y}. The event may not exist or have no markets.`);const h=await async function(t,o,a,n,c){const{systemPrompt:l,userPrompt:m}=e({title:t,sourcePlatform:o,targetPlatform:a});let u;if(i(n)){const e=await r(m,l,"text",n,1,{apiKey:c.openaiApiKey}),t=[];for(const r of e.output)if("message"===r.type){const e=r;t.push(...e.content)}u=t.map(e=>e.text).filter(e=>void 0!==e).join("").trim()}else{const e=await s(m,l,"text",n,1,void 0,{apiKey:c.xaiApiKey}),t=[];for(const r of e.output)if("message"===r.type){const e=r;t.push(...e.content)}u=t.map(e=>e.text).filter(e=>void 0!==e).join("").trim()}return u.replace(/['"]/g,"").trim().split(/\s+/).slice(0,2).join(" ")}(f.eventTitle,y,k,p,l);let d;if(d="polymarket"===k?await async function(e){try{const t=`${a}/public-search?q=${encodeURIComponent(e)}&events_status=open`,r=await fetch(t);if(!r.ok)return console.error("Polymarket search error:",r.status),[];const s=await r.json(),o=[];if(s.events&&Array.isArray(s.events))for(const e of s.events){const t=e.slug;if(e.markets&&Array.isArray(e.markets))for(const r of e.markets){const e=r.question||r.title||"";let s=50;if(r.outcomePrices)try{const e=JSON.parse(r.outcomePrices);s=100*parseFloat(e[0])}catch{}e&&o.push({title:e,yesPrice:s,identifier:t})}}return o}catch(t){return console.error("Error searching Polymarket:",t),[]}}(h):await async function(e,t){try{const r=await o("/search",{params:{q:e,event_status:"open",withNestedMarkets:!0},apiKey:t}),s=[];if(r.events&&Array.isArray(r.events))for(const e of r.events){const t=e.ticker;if(e.markets&&Array.isArray(e.markets))for(const r of e.markets){const e=r.yesSubTitle||r.title||"";let o=50;if(r.yesAsk&&r.yesBid){o=(parseFloat(r.yesAsk)+parseFloat(r.yesBid))/2*100}else r.yesAsk?o=100*parseFloat(r.yesAsk):r.yesBid&&(o=100*parseFloat(r.yesBid));e&&s.push({title:e,yesPrice:o,identifier:t})}}return s}catch(r){return console.error("Error searching Kalshi:",r),[]}}(h,l.dflowApiKey),0===d.length){const e={source:y,name:f.eventTitle,identifier:f.identifier,yesPrice:f.markets[0]?.yesPrice||50,noPrice:100-(f.markets[0]?.yesPrice||50),url:c(y,f.identifier),rawData:{eventTitle:f.eventTitle,markets:f.markets}};return{analysis:{isSameMarket:!1,sameMarketConfidence:0,marketComparisonReasoning:`No matching markets found on ${k} for query "${h}"`,polymarketData:"polymarket"===y?e:void 0,kalshiData:"kalshi"===y?e:void 0,arbitrage:{hasArbitrage:!1},summary:`No matching markets found on ${k}. Cannot determine arbitrage opportunity.`,risks:["No matching market found on the other platform"],recommendation:"Try a different event or check if the market exists on both platforms."},model:"none",sourceMarket:y,searchedMarket:k,processingTimeMs:Date.now()-m}}const{analysis:g,modelUsed:v,tokensUsed:w}=await async function(e,o,a,n,l){const m={source:e.source,name:e.eventTitle,identifier:e.identifier,yesPrice:e.markets[0]?.yesPrice||50,noPrice:100-(e.markets[0]?.yesPrice||50),url:c(e.source,e.identifier)};m.rawData={eventTitle:e.eventTitle,markets:e.markets};const{systemPrompt:u,userPrompt:p}=t({sourceMarket:m,searchResults:o,searchPlatform:a});let y,f,k;if(i(n)){const e=await r(p,u,"json_object",n,3,{apiKey:l.openaiApiKey});f=e.model,k=e.usage?.total_tokens;const t=[];for(const r of e.output)if("message"===r.type){const e=r;t.push(...e.content)}y=t.map(e=>e.text).filter(e=>void 0!==e).join("\n")}else{const e=await s(p,u,"json_object",n,3,void 0,{apiKey:l.xaiApiKey});f=e.model,k=e.usage?.total_tokens;const t=[];for(const r of e.output)if("message"===r.type){const e=r;t.push(...e.content)}y=t.map(e=>e.text).filter(e=>void 0!==e).join("\n")}const h=JSON.parse(y);return{analysis:{isSameMarket:h.isSameMarket,sameMarketConfidence:h.sameMarketConfidence,marketComparisonReasoning:h.marketComparisonReasoning,polymarketData:"polymarket"===e.source?m:h.matchedMarket||void 0,kalshiData:"kalshi"===e.source?m:h.matchedMarket||void 0,arbitrage:h.arbitrage,summary:h.summary,risks:h.risks,recommendation:h.recommendation},modelUsed:f,tokensUsed:k}}(f,d,k,p,l);return{analysis:g,model:v,tokensUsed:w,sourceMarket:y,searchedMarket:k,processingTimeMs:Date.now()-m}}export{l as findArbitrage};

package/dist/predictos/clients/polyfactual.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Polyfactual Deep Research API client.
+ *
+ * A client for the Polyfactual Deep Research API that provides research
+ * capabilities with citations. Ported from the PredictOS `polyfactual` shared
+ * client.
+ *
+ * API Documentation:
+ * - Base URL: https://deep-research-api.thekid-solana.workers.dev/
+ * - Rate Limit: 60 requests per minute
+ * - Query Limit: 1,000 characters
+ * - Default Timeout: 5 minutes
+ *
+ * The API key is read from `process.env.POLYFACTUAL_API_KEY`.
+ */
+/** Request payload for the `/answer` endpoint. */
+export interface PolyfactualAnswerRequest {
+    /** The research query (max 1000 characters) */
+    query: string;
+    /** Whether to return text output (default: true) */
+    text?: boolean;
+}
+/** Success response from the Polyfactual API. */
+export interface PolyfactualSuccessResponse {
+    success: true;
+    /** The generated answer and metadata */
+    data: PolyfactualAnswerData;
+    /** ISO 8601 timestamp */
+    timestamp: string;
+}
+/** Error response from the Polyfactual API. */
+export interface PolyfactualErrorResponse {
+    success: false;
+    /** Error message */
+    error: string;
+    /** ISO 8601 timestamp */
+    timestamp: string;
+}
+/** Union type for Polyfactual API responses. */
+export type PolyfactualResponse = PolyfactualSuccessResponse | PolyfactualErrorResponse;
+/** Answer data structure from Polyfactual. */
+export interface PolyfactualAnswerData {
+    /** The generated answer text */
+    answer?: string;
+    /** Citation sources */
+    citations?: PolyfactualCitation[];
+    /** Additional metadata */
+    [key: string]: unknown;
+}
+/** Citation structure. */
+export interface PolyfactualCitation {
+    /** Source URL */
+    url?: string;
+    /** Source title */
+    title?: string;
+    /** Snippet from the source */
+    snippet?: string;
+}
+/**
+ * Check the health status of the Polyfactual API.
+ */
+export declare function checkPolyfactualHealth(): Promise<boolean>;
+/**
+ * Generate an answer with citations using the Polyfactual Deep Research API.
+ *
+ * @param query - The research question (max 1000 characters)
+ * @param text - Whether to return text output (default: true)
+ * @returns The research response with answer and citations
+ * @throws Error if the API key is missing, query is too long, or the request fails
+ */
+export declare function generatePolyfactualAnswer(query: string, text?: boolean): Promise<PolyfactualSuccessResponse>;
+//# sourceMappingURL=polyfactual.d.ts.map

package/dist/predictos/clients/polyfactual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polyfactual.d.ts","sourceRoot":"","sources":["../../../src/predictos/clients/polyfactual.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACvC,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,iDAAiD;AACjD,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,IAAI,CAAC;IACd,wCAAwC;IACxC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,+CAA+C;AAC/C,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,KAAK,CAAC;IACf,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,gDAAgD;AAChD,MAAM,MAAM,mBAAmB,GAAG,0BAA0B,GAAG,wBAAwB,CAAC;AAExF,8CAA8C;AAC9C,MAAM,WAAW,qBAAqB;IACpC,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAClC,0BAA0B;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,0BAA0B;AAC1B,MAAM,WAAW,mBAAmB;IAClC,iBAAiB;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAgDD;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,OAAO,CAAC,CAW/D;AAED;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,OAAc,GACnB,OAAO,CAAC,0BAA0B,CAAC,CA0ErC"}

package/dist/predictos/clients/polymarket.d.ts

@@ -0,0 +1,283 @@
+/**
+ * Polymarket CLOB client (ported from the PredictOS `polymarket` shared client).
+ *
+ * Provides functionality to:
+ * - Fetch market data from the Gamma API
+ * - Place orders on the Polymarket CLOB using the official
+ *   `@polymarket/clob-client`
+ * - Read positions/activity from the public Data API
+ *
+ * This is distinct from the Dome-based market-data client in
+ * `data/polymarket.ts`: this module is the order-placement / trading-bot client
+ * for the 15-minute up/down markets.
+ */
+/** Supported assets for 15-minute up/down markets. */
+export type SupportedAsset = "BTC" | "SOL" | "ETH" | "XRP";
+/** Market data from the Gamma API. */
+export interface PolymarketMarket {
+    id: string;
+    question: string;
+    conditionId: string;
+    slug: string;
+    title: string;
+    description: string;
+    outcomes: string;
+    outcomePrices: string;
+    volume: string;
+    volume24hr: number;
+    clobTokenIds: string;
+    acceptingOrders: boolean;
+    active: boolean;
+    closed: boolean;
+    endDate: string;
+    startDate: string;
+}
+/** Parsed token IDs for Up and Down outcomes. */
+export interface TokenIds {
+    up: string;
+    down: string;
+}
+/** Order side type. */
+export type OrderSideType = "BUY" | "SELL";
+/** Order arguments for creating a new order. */
+export interface OrderArgs {
+    tokenId: string;
+    price: number;
+    size: number;
+    side: OrderSideType;
+}
+/** Order response from the CLOB API. */
+export interface OrderResponse {
+    success: boolean;
+    orderId?: string;
+    errorMsg?: string;
+    transactionHash?: string;
+    status?: string;
+}
+/** Log entry for bot execution. */
+export interface BotLogEntry {
+    timestamp: string;
+    level: "INFO" | "WARN" | "ERROR" | "SUCCESS";
+    message: string;
+    details?: Record<string, unknown>;
+}
+/** Polymarket client configuration. */
+export interface PolymarketClientConfig {
+    /** Private key for signing orders */
+    privateKey: string;
+    /** Proxy/funder address (shown under profile pic on Polymarket) */
+    proxyAddress: string;
+    /** Signature type: 0 = EOA, 1 = Magic/Email, 2 = Browser Wallet */
+    signatureType?: number;
+}
+/** Order status from CLOB API. */
+export type OrderStatus = "LIVE" | "MATCHED" | "CANCELLED" | "EXPIRED" | "FILLED" | "PARTIALLY_FILLED";
+/** Open order from CLOB API. */
+export interface OpenOrder {
+    id: string;
+    market: string;
+    asset_id: string;
+    side: OrderSideType;
+    price: string;
+    size_matched: string;
+    original_size: string;
+    status: OrderStatus;
+    created_at: number;
+    expiration: number;
+}
+/** Trade/fill from CLOB API. */
+export interface Trade {
+    id: string;
+    taker_order_id: string;
+    market: string;
+    asset_id: string;
+    side: OrderSideType;
+    price: string;
+    size: string;
+    fee_rate_bps: string;
+    status: string;
+    match_time: number;
+    owner: string;
+    transaction_hash?: string;
+}
+/** Position for a single side (YES or NO). */
+export interface SidePosition {
+    /** Total shares filled */
+    shares: number;
+    /** Total cost in USD */
+    costUsd: number;
+    /** Average price per share */
+    avgPrice: number;
+    /** Number of orders placed */
+    ordersPlaced: number;
+    /** Number of orders filled (partially or fully) */
+    ordersFilled: number;
+    /** Pending shares (orders placed but not filled) */
+    pendingShares: number;
+}
+/** Pair position status. */
+export type PairStatus = "PROFIT_LOCKED" | "BREAK_EVEN" | "LOSS_RISK" | "DIRECTIONAL_YES" | "DIRECTIONAL_NO" | "PENDING" | "NO_POSITION";
+/** Combined position for a market. */
+export interface MarketPosition {
+    /** Market slug identifier */
+    marketSlug: string;
+    /** Market title */
+    marketTitle?: string;
+    /** Token IDs */
+    tokenIds: TokenIds;
+    /** YES side position */
+    yes: SidePosition;
+    /** NO side position */
+    no: SidePosition;
+    /** Combined pair cost (avgYes + avgNo) - only valid when both sides have shares */
+    pairCost: number | null;
+    /** Position status */
+    status: PairStatus;
+    /** Minimum shares between YES and NO (determines guaranteed payout) */
+    minShares: number;
+    /** Guaranteed payout (minShares * $1.00) */
+    guaranteedPayout: number;
+    /** Total cost for matched pairs */
+    totalCost: number;
+    /** Guaranteed profit for matched pairs */
+    guaranteedProfit: number;
+    /** Return percentage for matched pairs */
+    returnPercent: number;
+    /** Timestamp of last update */
+    lastUpdated: string;
+}
+/** Asset slug prefixes for 15-minute up/down markets. */
+export declare const ASSET_SLUG_PREFIXES: Record<SupportedAsset, string>;
+/** Get the market slug for a given asset and timestamp. */
+export declare function buildMarketSlug(asset: SupportedAsset, timestamp: number): string;
+/** Format a Unix timestamp to a short time string (HH:MM:SS UTC). */
+export declare function formatTimeShort(ts: number): string;
+/** Create a log entry with current timestamp. */
+export declare function createLogEntry(level: BotLogEntry["level"], message: string, details?: Record<string, unknown>): BotLogEntry;
+/**
+ * Parse token IDs from market data.
+ * Returns [upTokenId, downTokenId].
+ */
+export declare function parseTokenIds(clobTokenIdsStr: string): [string, string];
+/**
+ * Polymarket Client Class
+ */
+export declare class PolymarketClient {
+    private config;
+    private logs;
+    private clobClient;
+    constructor(config: PolymarketClientConfig);
+    /**
+     * Get collected logs
+     */
+    getLogs(): BotLogEntry[];
+    /**
+     * Clear logs
+     */
+    clearLogs(): void;
+    /**
+     * Add a log entry
+     */
+    private log;
+    /**
+     * Initialize the CLOB client with API credentials
+     */
+    private initClobClient;
+    /**
+     * Fetch market data from Gamma API by slug
+     */
+    getMarketBySlug(slug: string): Promise<PolymarketMarket | null>;
+    /**
+     * Extract Up and Down token IDs from market data
+     */
+    extractTokenIds(market: PolymarketMarket): TokenIds;
+    /**
+     * Place a limit buy order on Polymarket CLOB
+     */
+    placeOrder(order: OrderArgs): Promise<OrderResponse>;
+    /**
+     * Place straddle orders (buy both Up and Down) at a given price
+     */
+    placeStraddleOrders(tokenIds: TokenIds, price: number, sizeUsd: number): Promise<{
+        up: OrderResponse;
+        down: OrderResponse;
+    }>;
+    /**
+     * Calculate ladder rungs with exponential taper allocation
+     * Heavy allocation at top (maxPrice), tapering down to minPrice
+     * Ensures minimum allocation per rung to guarantee 5+ shares at any price level
+     */
+    calculateLadderRungs(totalBankroll: number, maxPrice?: number, minPrice?: number, taperFactor?: number): Array<{
+        pricePercent: number;
+        priceDecimal: number;
+        sizeUsd: number;
+        allocationPercent: number;
+    }>;
+    /**
+     * Place ladder orders - straddle orders at multiple price levels with tapered allocation
+     */
+    placeLadderOrders(tokenIds: TokenIds, totalBankroll: number, maxPrice?: number, minPrice?: number, taperFactor?: number): Promise<{
+        rungs: Array<{
+            pricePercent: number;
+            priceDecimal: number;
+            sizeUsd: number;
+            allocationPercent: number;
+        }>;
+        results: Array<{
+            pricePercent: number;
+            sizeUsd: number;
+            up: OrderResponse;
+            down: OrderResponse;
+        }>;
+        totalOrders: number;
+        successfulOrders: number;
+    }>;
+    /**
+     * Get user positions from public Data API
+     * No authentication required - uses proxy wallet address
+     */
+    getPositions(options?: {
+        market?: string;
+    }): Promise<Array<{
+        asset: string;
+        size: number;
+        avgPrice: number;
+        outcome: string;
+        conditionId: string;
+    }>>;
+    /**
+     * Get user activity (trades) from public Data API
+     * No authentication required - uses proxy wallet address
+     */
+    getActivity(options?: {
+        market?: string;
+        asset?: string;
+    }): Promise<Array<{
+        asset: string;
+        size: number;
+        price: number;
+        side: string;
+        outcome: string;
+        conditionId: string;
+        timestamp: number;
+        type: string;
+    }>>;
+    /**
+     * Get a specific order by ID
+     */
+    getOrder(orderId: string): Promise<OpenOrder | null>;
+    /**
+     * Determine pair status based on positions
+     */
+    private determinePairStatus;
+    /**
+     * Get position for a specific market using public Data API
+     * Uses the positions endpoint which returns size and avgPrice directly
+     */
+    getMarketPosition(marketSlug: string, tokenIds: TokenIds, marketTitle?: string): Promise<MarketPosition>;
+}
+/**
+ * Create a Polymarket client from environment variables
+ */
+export declare function createClientFromEnv(): PolymarketClient;
+//# sourceMappingURL=polymarket.d.ts.map

package/dist/predictos/clients/polymarket.d.ts.map

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

package/dist/predictos/clients/x402.d.ts

@@ -0,0 +1,213 @@
+/**
+ * x402 client (ported from the PredictOS `x402` shared client).
+ *
+ * Provides functionality to:
+ * 1. List sellers from the x402 bazaar
+ * 2. Call x402-protected endpoints with automatic payment
+ *
+ * Supports both EVM (Base) and Solana mainnet networks. Automatically detects
+ * the seller's network and uses the correct private key.
+ *
+ * NOTE: Solana payments require the optional peer dependencies
+ * `@solana/web3.js`, `@solana/spl-token`, and `bs58` to be installed by the
+ * consumer. They are imported dynamically (via variable specifiers, so they
+ * stay out of the static dependency graph) only when a Solana payment is made.
+ */
+/** Payment requirements from a PayAI seller. */
+export interface X402PaymentRequirements {
+    /** Asset contract address (e.g., USDC) */
+    asset: string;
+    /** Description of what's being paid for */
+    description?: string;
+    /** Extra metadata like token name, version, and feePayer (for Solana) */
+    extra?: {
+        name?: string;
+        version?: string;
+        /** Fee payer address (required for Solana payments) */
+        feePayer?: string;
+    };
+    /** Amount required in atomic units (x402 v2 spec field name) */
+    amount?: string;
+    /** Maximum amount required in atomic units (legacy/alternative field name) */
+    maxAmountRequired?: string;
+    /** Maximum timeout in seconds */
+    maxTimeoutSeconds: number;
+    /** MIME type of the output */
+    mimeType?: string;
+    /** Network identifier (CAIP-2 format, e.g., "eip155:8453" or "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp") */
+    network: string;
+    /** Input/output schema information */
+    outputSchema?: {
+        input?: {
+            method: string;
+            type: string;
+            queryParams?: Record<string, {
+                type: string;
+                description?: string;
+                required?: boolean;
+            }>;
+            bodyParams?: Record<string, {
+                type: string;
+                description?: string;
+                required?: boolean;
+            }>;
+        };
+        output?: Record<string, unknown> | null;
+    };
+    /** Address to pay to */
+    payTo: string;
+    /** Resource URL */
+    resource: string;
+    /** Payment scheme (e.g., "exact") */
+    scheme: string;
+}
+/** x402 Bazaar resource (seller). */
+export interface X402BazaarSeller {
+    /** List of payment options accepted by this seller */
+    accepts: X402PaymentRequirements[];
+    /** Last updated timestamp */
+    lastUpdated: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+    /** Resource URL */
+    resource: string;
+    /** Protocol type (e.g., "http") */
+    type: string;
+    /** x402 version */
+    x402Version: number;
+}
+/** Response from listing bazaar resources. */
+export interface X402BazaarListResponse {
+    /** List of discovered sellers */
+    items: X402BazaarSeller[];
+    /** Total count of sellers */
+    total?: number;
+    /** Pagination limit */
+    limit?: number;
+    /** Pagination offset */
+    offset?: number;
+}
+/** Request to call a PayAI seller. */
+export interface X402CallSellerRequest {
+    /** The seller's resource URL */
+    resourceUrl: string;
+    /** Query/input to send to the seller */
+    query: string;
+    /** Network to use for payment (CAIP-2 format) */
+    network: string;
+    /** Optional specific method (GET/POST) */
+    method?: string;
+}
+/** Response from calling a PayAI seller. */
+export interface X402CallSellerResponse {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+    metadata?: {
+        requestId: string;
+        timestamp: string;
+        processingTimeMs: number;
+        paymentTxId?: string;
+        costUsdc?: string;
+        network: string;
+    };
+}
+/** Simplified seller info for frontend display. */
+export interface X402SellerInfo {
+    /** Unique identifier (resource URL) */
+    id: string;
+    /** Display name extracted from metadata or URL */
+    name: string;
+    /** Description of the service */
+    description?: string;
+    /** Resource URL */
+    resourceUrl: string;
+    /** Price per call in USDC (human readable) */
+    priceUsdc: string;
+    /** Supported networks */
+    networks: string[];
+    /** Last updated */
+    lastUpdated: string;
+    /** Input schema description */
+    inputDescription?: string;
+}
+/** API request for listing sellers. */
+export interface ListSellersRequest {
+    /** Filter by network */
+    network?: string;
+    /** Protocol type filter */
+    type?: string;
+    /** Pagination limit */
+    limit?: number;
+    /** Pagination offset */
+    offset?: number;
+}
+/** API response for listing sellers. */
+export interface ListSellersResponse {
+    success: boolean;
+    sellers?: X402SellerInfo[];
+    error?: string;
+    metadata?: {
+        requestId: string;
+        timestamp: string;
+        processingTimeMs: number;
+        total: number;
+    };
+}
+export declare const NETWORKS: {
+    readonly BASE_MAINNET: "eip155:8453";
+    readonly BASE: "base";
+    readonly SOLANA_MAINNET: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+    readonly SOLANA: "solana";
+};
+/**
+ * Check if a network is a Solana network.
+ * Handles both CAIP-2 format (solana:...) and legacy format (solana).
+ */
+export declare function isSolanaNetwork(network: string): boolean;
+/**
+ * Check if a network is an EVM network (Base).
+ * Handles both CAIP-2 format (eip155:...) and legacy format (base).
+ */
+export declare function isEvmNetwork(network: string): boolean;
+/**
+ * Parse price from atomic units to human-readable USDC.
+ */
+export declare function parseUsdcPrice(atomicUnits: string | undefined, network: string): string;
+/**
+ * Transform a bazaar seller to simplified seller info.
+ */
+export declare function transformSellerToInfo(seller: X402BazaarSeller): X402SellerInfo;
+/**
+ * List sellers from the x402 bazaar.
+ */
+export declare function listBazaarSellers(options?: {
+    network?: string;
+    type?: string;
+    limit?: number;
+    offset?: number;
+}): Promise<X402SellerInfo[]>;
+/**
+ * Call an x402-protected endpoint with payment.
+ *
+ * This implementation:
+ * 1. Gets the payment requirements from the resource
+ * 2. Detects the seller's network (Solana or EVM)
+ * 3. Uses the appropriate private key and signing method
+ * 4. Makes the request with X-Payment header
+ */
+export declare function callX402Seller(resourceUrl: string, query: string, preferredNetwork?: string): Promise<{
+    success: boolean;
+    data?: unknown;
+    error?: string;
+    paymentInfo?: {
+        txId?: string;
+        cost?: string;
+        network: string;
+    };
+}>;
+/**
+ * Health check for x402 bazaar discovery.
+ */
+export declare function checkX402Health(): Promise<boolean>;
+//# sourceMappingURL=x402.d.ts.map

package/dist/predictos/clients/x402.d.ts.map

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