@chaoslabs/ai-sdk 0.0.1

package/dist/types.d.ts

@@ -0,0 +1,310 @@
+/**
+ * Configuration for the Chaos client.
+ */
+export interface ChaosConfig {
+    /** API key for authentication */
+    apiKey: string;
+    /** Base URL for the API (defaults to https://ai-staging.chaoslabs.co) */
+    baseUrl?: string;
+    /** Request timeout in milliseconds (defaults to 120000) */
+    timeout?: number;
+}
+/**
+ * Parameters for creating a response.
+ */
+export interface CreateResponseParams {
+    /**
+     * Model to use for the response.
+     * - 'WALLET_MODEL': Wallet mode for DeFi operations
+     * - 'ASK_MODEL': Ask mode for research
+     */
+    model: string;
+    /** Input messages for the conversation */
+    input: InputItem[];
+    /** Whether to stream the response */
+    stream?: boolean;
+    /** Metadata for the request */
+    metadata: RequestMetadata;
+}
+/**
+ * An input message in the conversation.
+ */
+export interface InputItem {
+    type: 'message';
+    role: 'user' | 'system';
+    content: string;
+}
+/**
+ * Request metadata including user and session identifiers.
+ */
+export interface RequestMetadata {
+    /** User identifier */
+    user_id: string;
+    /** Session identifier for conversation continuity */
+    session_id: string;
+    /** Wallet identifier (required for WALLET_MODEL) */
+    wallet_id: string;
+}
+/**
+ * A response from the Chaos API.
+ */
+export interface Response {
+    /** Unique response identifier */
+    id: string;
+    /** Object type */
+    object: 'response';
+    /** Model used */
+    model: string;
+    /** Response status */
+    status: 'completed' | 'failed';
+    /** Output items */
+    output: OutputItem[];
+    /** Error information if status is 'failed' */
+    error?: ResponseError;
+}
+/**
+ * An output item in the response.
+ */
+export interface OutputItem {
+    type: 'message';
+    role: 'assistant';
+    content: ContentPart[];
+}
+/**
+ * Content part within an output message.
+ */
+export type ContentPart = OutputText | ChaosBlock;
+/**
+ * Text content part.
+ */
+export interface OutputText {
+    type: 'output_text';
+    text: string;
+}
+/**
+ * Chaos block content part.
+ */
+export interface ChaosBlock {
+    type: 'chaos.block';
+    block: Block;
+}
+/**
+ * Union of all block types.
+ */
+export type Block = TableBlock | MarkdownBlock | TransactionActionBlock | InteractiveCardBlock | TimeseriesBlock | PieChartBlock;
+/**
+ * A cell value in a table row.
+ * Can be a string (text, addresses, asset names) or number (amounts, percentages).
+ */
+export type TableCellValue = string | number;
+/**
+ * Table visualization block.
+ */
+export interface TableBlock {
+    type: 'table';
+    title: string;
+    tableHeaders: string[];
+    rows: TableCellValue[][];
+}
+/**
+ * Markdown content block.
+ */
+export interface MarkdownBlock {
+    type: 'markdown';
+    content: string;
+}
+/**
+ * Transaction action block for DeFi operations.
+ */
+export interface TransactionActionBlock {
+    type: 'transaction_action';
+    title: string;
+    primitives: Primitive[];
+    risks?: Risks;
+}
+/**
+ * JSON-compatible primitive parameter value.
+ * Covers all types that can appear in primitive params.
+ */
+export type PrimitiveParamValue = string | number | boolean | null | PrimitiveParamValue[] | {
+    [key: string]: PrimitiveParamValue;
+};
+/**
+ * Parameters for a primitive operation.
+ * Common fields include: asset, amount, from_asset, to_asset, chain, destination_address, etc.
+ */
+export type PrimitiveParams = Record<string, PrimitiveParamValue>;
+/**
+ * Display fields for a primitive (pre-computed UI-friendly values).
+ */
+export interface PrimitiveDisplay {
+    /** Main action line (e.g., "ETH -> USDC", "Deposit to Aave") */
+    headline: string;
+    /** Formatted amount with symbol (e.g., "1.5 ETH (~$4,500)") */
+    amount?: string;
+    /** Action type: "Deposit", "Withdraw", "Stake", "Borrow", etc. */
+    action_verb?: string;
+    /** Source asset for swaps/bridges */
+    from_asset?: string;
+    /** Destination asset for swaps/bridges */
+    to_asset?: string;
+    /** Source chain for bridges */
+    from_chain?: string;
+    /** Destination chain for bridges */
+    to_chain?: string;
+    /** Protocol name (e.g., "Aave V3", "Lido", "GMX") */
+    protocol?: string;
+    /** Leverage multiplier (e.g., "10x") */
+    leverage?: string;
+    /** Direction: "Long", "Short", "Send", "Receive" */
+    direction?: string;
+    /** Full recipient address (never truncated) */
+    recipient?: string;
+}
+/**
+ * A DeFi primitive operation.
+ */
+export interface Primitive {
+    /** Primitive type (e.g., 'swap', 'transfer', 'aave_deposit') */
+    primitive: string;
+    /** Primitive-specific parameters */
+    params: PrimitiveParams;
+    /** Pre-computed UI display fields */
+    display?: PrimitiveDisplay;
+}
+/**
+ * Interactive card block for user input.
+ */
+export interface InteractiveCardBlock {
+    type: 'interactive_card';
+    title: string;
+    body?: string;
+    style: 'options' | 'confirm_cancel';
+    options?: InteractiveOption[];
+}
+/**
+ * An option in an interactive card.
+ */
+export interface InteractiveOption {
+    id: string;
+    label: string;
+    description?: string;
+}
+/**
+ * A single data point in a timeseries: [timestamp_ms, value].
+ * Timestamp is in milliseconds (13-digit).
+ */
+export type TimeseriesDataPoint = [number, number];
+/**
+ * A series in a timeseries chart.
+ */
+export interface TimeseriesSeries {
+    /** Series label (e.g., "ETH", "BTC") */
+    label: string;
+    /** Array of [timestamp_ms, value] data points */
+    data: TimeseriesDataPoint[];
+}
+/**
+ * Timeseries data organized by timeframe.
+ * Keys are timeframe strings: "24H", "7D", "30D", "90D".
+ */
+export type TimeseriesData = Record<string, TimeseriesSeries[]>;
+/**
+ * Time series chart block.
+ */
+export interface TimeseriesBlock {
+    type: 'timeseries';
+    title: string;
+    /** Series data organized by timeframe */
+    data: TimeseriesData;
+}
+/**
+ * Pie chart block.
+ */
+export interface PieChartBlock {
+    type: 'pie_chart';
+    title: string;
+    data: [string, number][];
+}
+/**
+ * Risk assessment for a transaction.
+ */
+export interface Risks {
+    /** Overall risk level */
+    level: 'low' | 'medium' | 'high' | 'critical';
+    /** Warning messages */
+    warnings: string[];
+    /** Blocker messages that prevent execution */
+    blockers?: string[];
+}
+/**
+ * Error information in a response.
+ */
+export interface ResponseError {
+    message: string;
+    type: string;
+    code: string;
+}
+/**
+ * HTTP error from the API.
+ */
+export declare class ChaosError extends Error {
+    readonly status?: number | undefined;
+    readonly code?: string | undefined;
+    readonly type?: string | undefined;
+    constructor(message: string, status?: number | undefined, code?: string | undefined, type?: string | undefined);
+}
+/**
+ * Timeout error.
+ */
+export declare class ChaosTimeoutError extends ChaosError {
+    constructor(timeoutMs: number);
+}
+/**
+ * Check if a block is a table block.
+ */
+export declare function isTableBlock(block: Block): block is TableBlock;
+/**
+ * Check if a block is a markdown block.
+ */
+export declare function isMarkdownBlock(block: Block): block is MarkdownBlock;
+/**
+ * Check if a block is a transaction action block.
+ */
+export declare function isTransactionActionBlock(block: Block): block is TransactionActionBlock;
+/**
+ * Check if a block is an interactive card block.
+ */
+export declare function isInteractiveCardBlock(block: Block): block is InteractiveCardBlock;
+/**
+ * Check if a block is a timeseries block.
+ */
+export declare function isTimeseriesBlock(block: Block): block is TimeseriesBlock;
+/**
+ * Check if a block is a pie chart block.
+ */
+export declare function isPieChartBlock(block: Block): block is PieChartBlock;
+/**
+ * Check if a content part is output text.
+ */
+export declare function isOutputText(part: ContentPart): part is OutputText;
+/**
+ * Check if a content part is a chaos block.
+ */
+export declare function isChaosBlock(part: ContentPart): part is ChaosBlock;
+/**
+ * Extract all text content from a response.
+ */
+export declare function extractText(response: Response): string;
+/**
+ * Extract all blocks from a response.
+ */
+export declare function extractBlocks(response: Response): Block[];
+/**
+ * Check if a response has any risks.
+ */
+export declare function hasRisks(response: Response): boolean;
+/**
+ * Check if a response has any blockers.
+ */
+export declare function hasBlockers(response: Response): boolean;

package/dist/types.js

@@ -0,0 +1,126 @@
+// Chaos AI SDK V1 - Public Types
+/**
+ * HTTP error from the API.
+ */
+export class ChaosError extends Error {
+    status;
+    code;
+    type;
+    constructor(message, status, code, type) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.type = type;
+        this.name = 'ChaosError';
+    }
+}
+/**
+ * Timeout error.
+ */
+export class ChaosTimeoutError extends ChaosError {
+    constructor(timeoutMs) {
+        super(`Request timed out after ${timeoutMs}ms`);
+        this.name = 'ChaosTimeoutError';
+    }
+}
+// ============================================================================
+// Type Guards
+// ============================================================================
+/**
+ * Check if a block is a table block.
+ */
+export function isTableBlock(block) {
+    return block.type === 'table';
+}
+/**
+ * Check if a block is a markdown block.
+ */
+export function isMarkdownBlock(block) {
+    return block.type === 'markdown';
+}
+/**
+ * Check if a block is a transaction action block.
+ */
+export function isTransactionActionBlock(block) {
+    return block.type === 'transaction_action';
+}
+/**
+ * Check if a block is an interactive card block.
+ */
+export function isInteractiveCardBlock(block) {
+    return block.type === 'interactive_card';
+}
+/**
+ * Check if a block is a timeseries block.
+ */
+export function isTimeseriesBlock(block) {
+    return block.type === 'timeseries';
+}
+/**
+ * Check if a block is a pie chart block.
+ */
+export function isPieChartBlock(block) {
+    return block.type === 'pie_chart';
+}
+/**
+ * Check if a content part is output text.
+ */
+export function isOutputText(part) {
+    return part.type === 'output_text';
+}
+/**
+ * Check if a content part is a chaos block.
+ */
+export function isChaosBlock(part) {
+    return part.type === 'chaos.block';
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Extract all text content from a response.
+ */
+export function extractText(response) {
+    const texts = [];
+    for (const item of response.output) {
+        for (const part of item.content) {
+            if (isOutputText(part)) {
+                texts.push(part.text);
+            }
+        }
+    }
+    return texts.join('\n');
+}
+/**
+ * Extract all blocks from a response.
+ */
+export function extractBlocks(response) {
+    const blocks = [];
+    for (const item of response.output) {
+        for (const part of item.content) {
+            if (isChaosBlock(part)) {
+                blocks.push(part.block);
+            }
+        }
+    }
+    return blocks;
+}
+/**
+ * Check if a response has any risks.
+ */
+export function hasRisks(response) {
+    const blocks = extractBlocks(response);
+    return blocks.some((block) => isTransactionActionBlock(block) &&
+        block.risks &&
+        (block.risks.warnings.length > 0 || (block.risks.blockers && block.risks.blockers.length > 0)));
+}
+/**
+ * Check if a response has any blockers.
+ */
+export function hasBlockers(response) {
+    const blocks = extractBlocks(response);
+    return blocks.some((block) => isTransactionActionBlock(block) &&
+        block.risks &&
+        block.risks.blockers &&
+        block.risks.blockers.length > 0);
+}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@chaoslabs/ai-sdk",
+  "version": "0.0.1",
+  "description": "Chaos AI SDK - TypeScript SDK for the Chaos AI API",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run build",
+    "examples": "bun run examples/run-all.ts",
+    "examples:help": "bun run examples/run-all.ts --help"
+  },
+  "keywords": [
+    "chaos",
+    "ai",
+    "sdk",
+    "defi",
+    "blockchain",
+    "wallet",
+    "typescript"
+  ],
+  "author": "Chaos Labs <support@chaoslabs.xyz>",
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ChaosLabsInc/ai-sdk.git"
+  },
+  "homepage": "https://github.com/ChaosLabsInc/ai-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/ChaosLabsInc/ai-sdk/issues"
+  },
+  "peerDependencies": {
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.9.3"
+  }
+}