@chaoslabs/ai-sdk 0.0.1 → 0.0.2

package/dist/types.d.ts

@@ -90,152 +90,223 @@ export interface ChaosBlock {
 }
 /**
  * Union of all block types.
+ * Note: SDK adds 'type' field for consistency, server uses 'blockType'.
  */
-export type Block = TableBlock | MarkdownBlock | TransactionActionBlock | InteractiveCardBlock | TimeseriesBlock | PieChartBlock;
+export type Block = MarkdownBlock | TableBlock | ChartBlock | TransactionActionBlock | InteractiveBlock;
 /**
- * A cell value in a table row.
- * Can be a string (text, addresses, asset names) or number (amounts, percentages).
+ * Markdown content block.
+ * Server sends: { content: string } (no blockType)
+ */
+export interface MarkdownBlock {
+    type: 'markdown';
+    content: string;
+}
+/**
+ * Table column type.
+ */
+export type TableColumnType = 'text' | 'number' | 'currency' | 'percentage' | 'token' | 'date' | 'link' | 'boolean';
+/**
+ * Table sort direction.
+ */
+export type TableSortDirection = 'asc' | 'desc';
+/**
+ * Table column configuration.
  */
-export type TableCellValue = string | number;
+export interface TableColumnConfig {
+    type?: TableColumnType;
+    sortable?: boolean;
+    align?: 'left' | 'center' | 'right';
+    width?: string;
+}
 /**
  * Table visualization block.
+ * Server sends: { blockType: "table", ... }
  */
 export interface TableBlock {
     type: 'table';
+    blockType?: 'table';
     title: string;
     tableHeaders: string[];
-    rows: TableCellValue[][];
+    tableRows: Array<Array<string | number | boolean | null>>;
+    tableHeadersTypes?: Record<string, TableColumnType | 'currency' | 'percentage'> | null;
+    tableColumnConfigs?: Record<string, TableColumnConfig> | null;
+    tableHeadersMetadata?: Record<string, {
+        type?: string;
+    }> | null;
+    sourceName?: string | null;
+    defaultSortColumn?: string | null;
+    defaultSortDirection?: TableSortDirection | null;
+    maxRows?: number | null;
+    searchable?: boolean | null;
+    exportable?: boolean | null;
+    tool_params?: unknown;
+    tool_name?: string | null;
 }
 /**
- * Markdown content block.
+ * Chart series data point.
  */
-export interface MarkdownBlock {
-    type: 'markdown';
-    content: string;
+export type ChartDataPoint = [number, number] | {
+    x: number | string;
+    y: number;
+} | unknown[];
+/**
+ * Chart series.
+ */
+export interface ChartSeries {
+    name: string;
+    data: ChartDataPoint[];
+    color?: string;
 }
 /**
- * Transaction action block for DeFi operations.
+ * Chart segment for pie/donut charts.
  */
-export interface TransactionActionBlock {
-    type: 'transaction_action';
+export interface ChartSegment {
+    label: string;
+    value: number;
+    color?: string;
+}
+/**
+ * Chart axis configuration.
+ */
+export interface ChartAxis {
+    title?: string;
+    min?: number;
+    max?: number;
+    type?: string;
+}
+/**
+ * Chart visualization block.
+ * Server sends: { blockType: "chart", data: [[label, value], ...], ... }
+ */
+export interface ChartBlock {
+    type: 'chart';
+    blockType?: 'chart';
     title: string;
-    primitives: Primitive[];
-    risks?: Risks;
+    chartType?: 'pie' | 'donut' | 'line' | 'area' | 'bar' | 'timeseries' | null;
+    series?: ChartSeries[] | null;
+    segments?: ChartSegment[] | null;
+    /** Legacy data format from server: [[label, value], ...] */
+    data?: Array<[string, number]> | null;
+    categories?: string[] | null;
+    xAxis?: ChartAxis | null;
+    yAxis?: ChartAxis | null;
+    isCurrency?: boolean | null;
+    sourceName?: string | null;
+    timeframe?: string | null;
+    tool_params?: unknown;
+    tool_name?: string | null;
 }
 /**
- * JSON-compatible primitive parameter value.
- * Covers all types that can appear in primitive params.
+ * Icon for primitive display.
  */
-export type PrimitiveParamValue = string | number | boolean | null | PrimitiveParamValue[] | {
-    [key: string]: PrimitiveParamValue;
-};
+export interface PrimitiveIcon {
+    type: string;
+    value: string;
+}
 /**
- * Parameters for a primitive operation.
- * Common fields include: asset, amount, from_asset, to_asset, chain, destination_address, etc.
+ * Line item for primitive display.
  */
-export type PrimitiveParams = Record<string, PrimitiveParamValue>;
+export interface PrimitiveLineItem {
+    label: string;
+    value: string;
+    icon?: PrimitiveIcon;
+}
 /**
- * Display fields for a primitive (pre-computed UI-friendly values).
+ * Display information for a primitive.
  */
 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. */
+    headline?: string;
     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;
+    primary_icon?: PrimitiveIcon;
+    secondary_icon?: PrimitiveIcon;
+    line_items?: PrimitiveLineItem[];
 }
 /**
- * A DeFi primitive operation.
+ * A primitive action (swap, supply, borrow, etc.)
  */
 export interface Primitive {
-    /** Primitive type (e.g., 'swap', 'transfer', 'aave_deposit') */
     primitive: string;
-    /** Primitive-specific parameters */
-    params: PrimitiveParams;
-    /** Pre-computed UI display fields */
+    params?: Record<string, unknown>;
     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.
+ * Raw transaction data from server.
  */
-export interface InteractiveOption {
-    id: string;
-    label: string;
+export interface RawTransaction {
+    to?: string;
+    data?: string;
+    value?: string;
+    chainId?: number;
     description?: string;
+    contractName?: string;
+    contractVerified?: boolean;
+    protocolName?: string;
+    contractIcon?: string;
 }
 /**
- * A single data point in a timeseries: [timestamp_ms, value].
- * Timestamp is in milliseconds (13-digit).
+ * Group of transactions.
  */
-export type TimeseriesDataPoint = [number, number];
+export interface TransactionGroup {
+    transactions?: RawTransaction[];
+    requiresApproval?: boolean;
+    verificationUnavailable?: boolean;
+}
 /**
- * A series in a timeseries chart.
+ * Risk information item.
  */
-export interface TimeseriesSeries {
-    /** Series label (e.g., "ETH", "BTC") */
-    label: string;
-    /** Array of [timestamp_ms, value] data points */
-    data: TimeseriesDataPoint[];
+export interface RiskInfoItem {
+    id?: string;
+    severity?: 'info' | 'warning' | 'error' | 'critical';
+    title?: string;
+    message?: string;
 }
 /**
- * Timeseries data organized by timeframe.
- * Keys are timeframe strings: "24H", "7D", "30D", "90D".
+ * Risk assessment for a transaction.
  */
-export type TimeseriesData = Record<string, TimeseriesSeries[]>;
+export interface Risks {
+    level?: string;
+    blockers?: string[];
+    warnings?: string[];
+    info?: RiskInfoItem[];
+}
 /**
- * Time series chart block.
+ * Transaction action block for DeFi operations.
+ * Server sends: { blockType: "transaction_action", primitives: [...], ... }
  */
-export interface TimeseriesBlock {
-    type: 'timeseries';
-    title: string;
-    /** Series data organized by timeframe */
-    data: TimeseriesData;
+export interface TransactionActionBlock {
+    type: 'transaction_action';
+    blockType?: 'transaction_action';
+    value?: Record<string, unknown>;
+    sequence?: boolean;
+    primitives?: Primitive[];
+    transactions?: TransactionGroup[];
+    needs_confirmation?: boolean;
+    notes?: string;
+    risks?: Risks;
+    metadata?: Record<string, unknown>;
+    tool_params?: unknown;
+    tool_name?: string | null;
 }
 /**
- * Pie chart block.
+ * Interactive option.
  */
-export interface PieChartBlock {
-    type: 'pie_chart';
-    title: string;
-    data: [string, number][];
+export interface InteractiveOption {
+    id: string;
+    label: string;
+    description?: string;
+    value?: unknown;
 }
 /**
- * Risk assessment for a transaction.
+ * Interactive block for user input.
+ * Server sends: { blockType: "interactive", ... }
  */
-export interface Risks {
-    /** Overall risk level */
-    level: 'low' | 'medium' | 'high' | 'critical';
-    /** Warning messages */
-    warnings: string[];
-    /** Blocker messages that prevent execution */
-    blockers?: string[];
+export interface InteractiveBlock {
+    type: 'interactive';
+    blockType?: 'interactive';
+    prompt?: string;
+    options?: InteractiveOption[];
+    allowCustom?: boolean;
+    multiSelect?: boolean;
 }
 /**
  * Error information in a response.
@@ -273,17 +344,13 @@ export declare function isMarkdownBlock(block: Block): block is MarkdownBlock;
  */
 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.
+ * Check if a block is an interactive block.
  */
-export declare function isTimeseriesBlock(block: Block): block is TimeseriesBlock;
+export declare function isInteractiveBlock(block: Block): block is InteractiveBlock;
 /**
- * Check if a block is a pie chart block.
+ * Check if a block is a chart block.
  */
-export declare function isPieChartBlock(block: Block): block is PieChartBlock;
+export declare function isChartBlock(block: Block): block is ChartBlock;
 /**
  * Check if a content part is output text.
  */
@@ -301,10 +368,10 @@ export declare function extractText(response: Response): string;
  */
 export declare function extractBlocks(response: Response): Block[];
 /**
- * Check if a response has any risks.
+ * Check if a response has any transaction action blocks with risk levels.
  */
 export declare function hasRisks(response: Response): boolean;
 /**
- * Check if a response has any blockers.
+ * Check if a response has any high-risk transaction action blocks.
  */
 export declare function hasBlockers(response: Response): boolean;

package/dist/types.js

@@ -1,4 +1,5 @@
 // Chaos AI SDK V1 - Public Types
+// Updated to match actual server response structure
 /**
  * HTTP error from the API.
  */
@@ -45,22 +46,16 @@ export function isTransactionActionBlock(block) {
     return block.type === 'transaction_action';
 }
 /**
- * Check if a block is an interactive card block.
+ * Check if a block is an interactive block.
  */
-export function isInteractiveCardBlock(block) {
-    return block.type === 'interactive_card';
+export function isInteractiveBlock(block) {
+    return block.type === 'interactive';
 }
 /**
- * Check if a block is a timeseries block.
+ * Check if a block is a chart 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';
+export function isChartBlock(block) {
+    return block.type === 'chart';
 }
 /**
  * Check if a content part is output text.
@@ -106,21 +101,19 @@ export function extractBlocks(response) {
     return blocks;
 }
 /**
- * Check if a response has any risks.
+ * Check if a response has any transaction action blocks with risk levels.
  */
 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)));
+    return blocks.some((block) => isTransactionActionBlock(block) && block.risks?.level && block.risks.level !== 'low');
 }
 /**
- * Check if a response has any blockers.
+ * Check if a response has any high-risk transaction action blocks.
  */
 export function hasBlockers(response) {
     const blocks = extractBlocks(response);
     return blocks.some((block) => isTransactionActionBlock(block) &&
         block.risks &&
-        block.risks.blockers &&
-        block.risks.blockers.length > 0);
+        ((block.risks.level === 'high' || block.risks.level === 'critical') ||
+            (block.risks.blockers && block.risks.blockers.length > 0)));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chaoslabs/ai-sdk",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Chaos AI SDK - TypeScript SDK for the Chaos AI API",
   "type": "module",
   "main": "./dist/index.js",
@@ -21,7 +21,11 @@
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "bun run build",
     "examples": "bun run examples/run-all.ts",
-    "examples:help": "bun run examples/run-all.ts --help"
+    "examples:help": "bun run examples/run-all.ts --help",
+    "docs:import": "bun run tools/sanity-cms/index.ts import:all",
+    "docs:import:dry": "bun run tools/sanity-cms/index.ts import:all --dry-run",
+    "docs:import:docs": "bun run tools/sanity-cms/index.ts import:docs",
+    "docs:import:changelog": "bun run tools/sanity-cms/index.ts import:changelog"
   },
   "keywords": [
     "chaos",
@@ -46,7 +50,9 @@
     "zod": "^4.0.0"
   },
   "devDependencies": {
+    "@sanity/client": "^6.28.1",
     "@types/bun": "latest",
+    "nanoid": "^5.0.9",
     "typescript": "^5.9.3"
   }
 }