valta-sdk 2.0.0 → 2.1.0

package/dist/index.d.mts

@@ -1,167 +1,197 @@
-interface ValtaConfig {
-    /** Your Valta API key — get it from /dashboard/api-keys */
-    apiKey: string;
-    /** Base URL. Defaults to https://valta.co */
-    baseUrl?: string;
-    /** Optional timeout in milliseconds. Default: 30000 */
-    timeout?: number;
+interface RequestOptions {
+    method?: 'GET' | 'POST' | 'PATCH' | 'DELETE';
+    body?: unknown;
+}
+declare class Requester {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey: string, baseUrl?: string);
+    request<T>(path: string, options?: RequestOptions): Promise<T>;
 }
 
-type AgentCategory = "finance" | "trading" | "analytics" | "development" | "marketing" | "compliance" | "research" | "general";
-type PlanType = "FREE" | "PRO" | "ENTERPRISE";
-interface AgentConfig {
-    agentId: string;
+interface Agent {
+    id: string;
     name: string;
-    category: AgentCategory;
+    type: string;
+    status: 'active' | 'frozen' | 'paused';
+    walletAddress?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreateAgentParams {
+    name: string;
+    type: string;
     description?: string;
-    planRequired?: PlanType;
-    isLive?: boolean;
 }
-interface ChatMessage {
-    role: "user" | "assistant" | "system";
-    content: string;
+interface ListAgentsParams {
+    limit?: number;
+    offset?: number;
+    status?: 'active' | 'frozen' | 'paused';
+}
+interface ListAgentsResponse {
+    agents: Agent[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+declare class AgentsResource {
+    private requester;
+    constructor(requester: Requester);
+    list(params?: ListAgentsParams): Promise<ListAgentsResponse>;
+    get(agentId: string): Promise<Agent>;
+    create(params: CreateAgentParams): Promise<Agent>;
+    update(agentId: string, params: Partial<CreateAgentParams>): Promise<Agent>;
+    freeze(agentId: string): Promise<Agent>;
+    unfreeze(agentId: string): Promise<Agent>;
+    delete(agentId: string): Promise<{
+        deleted: boolean;
+        id: string;
+    }>;
 }
-interface ChatResponse {
-    message: string;
-    agentId: string;
-    tokens?: number;
-    provider?: string;
+
+interface WalletBalance {
+    usdc: string;
+    usdcPending: string;
+    lastUpdated: string;
+}
+interface WalletTransferParams {
+    toAgentId?: string;
+    toAddress?: string;
+    amount: string;
+    currency: 'USDC';
+    note?: string;
+}
+interface WalletTransfer {
+    id: string;
+    fromAgentId: string;
+    toAgentId?: string;
+    toAddress?: string;
+    amount: string;
+    currency: string;
+    status: 'pending' | 'completed' | 'failed';
+    createdAt: string;
 }
-interface AutomationConfig {
-    name: string;
-    agentId: string;
-    task: string;
-    schedule: "daily" | "every:30m" | "every:1h" | "every:6h" | "every:12h" | "every:168h";
-    enabled?: boolean;
+declare class WalletsResource {
+    private requester;
+    constructor(requester: Requester);
+    get(agentId: string): Promise<WalletBalance>;
+    transfer(agentId: string, params: WalletTransferParams): Promise<WalletTransfer>;
 }
-interface Automation {
-    automationId: string;
-    name: string;
+
+interface Policy {
+    id: string;
     agentId: string;
-    schedule: string;
-    enabled: boolean;
-    runCount: number;
-    lastRunAt: string | null;
-    nextRunAt: string | null;
+    name: string;
+    maxSpendPerDay?: number;
+    maxSpendPerTransaction?: number;
+    allowedRecipients?: string[];
+    currency: string;
+    active: boolean;
+    createdAt: string;
 }
-interface PipelineStep {
+interface CreatePolicyParams {
     agentId: string;
-    task: string;
-}
-interface PipelineConfig {
     name: string;
-    description?: string;
-    steps: PipelineStep[];
+    maxSpendPerDay?: number;
+    maxSpendPerTransaction?: number;
+    allowedRecipients?: string[];
+    currency?: string;
+}
+declare class PoliciesResource {
+    private requester;
+    constructor(requester: Requester);
+    list(agentId?: string): Promise<Policy[]>;
+    create(params: CreatePolicyParams): Promise<Policy>;
+    update(policyId: string, params: Partial<CreatePolicyParams>): Promise<Policy>;
+    delete(policyId: string): Promise<{
+        deleted: boolean;
+    }>;
 }
-interface PipelineResult {
+
+interface AuditLog {
+    id: string;
     agentId: string;
-    agentName: string;
-    response: string;
-    durationMs: number;
+    action: string;
+    amount?: string;
+    currency?: string;
+    metadata?: Record<string, unknown>;
+    hash: string;
+    previousHash: string;
+    createdAt: string;
 }
-interface WalletBalance {
-    balance: number;
-    currency: string;
+interface ListAuditParams {
+    agentId?: string;
+    limit?: number;
+    offset?: number;
+    from?: string;
+    to?: string;
 }
-interface Transaction {
-    txnId: string;
-    type: string;
-    amount: number;
-    status: string;
-    createdAt: string;
+interface ListAuditResponse {
+    logs: AuditLog[];
+    total: number;
 }
-
-declare class WalletTool {
-    private apiKey;
-    private baseUrl;
-    constructor(apiKey: string, baseUrl: string);
-    getBalance(): Promise<WalletBalance>;
-    getTransactions(limit?: number): Promise<Transaction[]>;
-    getAddress(): Promise<string>;
+declare class AuditResource {
+    private requester;
+    constructor(requester: Requester);
+    list(params?: ListAuditParams): Promise<ListAuditResponse>;
 }
 
-interface AnalyticsSummary {
-    totalSpend: number;
-    topAgents: Array<{
-        agentId: string;
-        name: string;
-        spend: number;
-    }>;
-    spendByDay: Array<{
-        date: string;
-        amount: number;
-    }>;
+interface ApiKey {
+    id: string;
+    name: string;
+    prefix: string;
+    tier: 'free' | 'builder' | 'startup' | 'enterprise';
+    lastUsed?: string;
+    createdAt: string;
 }
-declare class AnalyticsTool {
-    private apiKey;
-    private baseUrl;
-    constructor(apiKey: string, baseUrl: string);
-    getSummary(): Promise<AnalyticsSummary>;
-    getAuditTrail(limit?: number): Promise<unknown[]>;
+interface CreateKeyResponse {
+    id: string;
+    name: string;
+    key: string;
+    tier: string;
+    createdAt: string;
 }
-
-declare class TradingAgent {
-    private apiKey;
-    private baseUrl;
-    constructor(apiKey: string, baseUrl: string);
-    analyze(question: string): Promise<ChatResponse>;
-    getMarketBrief(): Promise<string>;
-    getSignals(assets: string[]): Promise<string>;
+declare class KeysResource {
+    private requester;
+    constructor(requester: Requester);
+    list(): Promise<ApiKey[]>;
+    create(name: string): Promise<CreateKeyResponse>;
+    revoke(keyId: string): Promise<{
+        deleted: boolean;
+    }>;
 }
 
-declare class PortfolioAgent {
-    private apiKey;
-    private baseUrl;
-    constructor(apiKey: string, baseUrl: string);
-    analyze(question: string): Promise<ChatResponse>;
-    getReport(): Promise<string>;
-    getRebalancingSuggestions(targetAllocation: Record<string, number>): Promise<string>;
+interface ValtaConfig {
+    apiKey: string;
+    baseUrl?: string;
 }
-
-type Plugin = (client: ValtaClient) => void;
 declare class ValtaClient {
-    readonly apiKey: string;
-    readonly baseUrl: string;
-    readonly wallet: WalletTool;
-    readonly analytics: AnalyticsTool;
-    readonly trading: TradingAgent;
-    readonly portfolio: PortfolioAgent;
-    private plugins;
-    constructor(config: ValtaConfig);
-    use(plugin: Plugin): this;
-    listAgents(): Promise<AgentConfig[]>;
-    createAgent(agentId: string): AgentHandle;
-    createAutomation(config: AutomationConfig): Promise<Automation>;
-    listAutomations(): Promise<Automation[]>;
-    runAutomation(automationId: string): Promise<{
-        response: string | null;
-    }>;
-    createPipeline(config: PipelineConfig): Promise<string>;
-    runPipeline(pipelineId: string): Promise<PipelineResult[]>;
-}
-declare class AgentHandle {
-    private apiKey;
-    private baseUrl;
-    readonly agentId: string;
-    constructor(apiKey: string, baseUrl: string, agentId: string);
-    chat(message: string, conversationId?: string): Promise<ChatResponse>;
-    run(): this;
+    agents: AgentsResource;
+    wallets: WalletsResource;
+    policies: PoliciesResource;
+    audit: AuditResource;
+    keys: KeysResource;
+    constructor(config: ValtaConfig | string);
 }
 
 declare class ValtaError extends Error {
+    code: string;
     status: number;
-    code?: string;
-    constructor(message: string, status?: number, code?: string);
+    constructor(message: string, code: string, status: number);
 }
-declare class ValtaAuthError extends ValtaError {
+declare class AuthError extends ValtaError {
     constructor(message?: string);
 }
-declare class ValtaRateLimitError extends ValtaError {
-    retryAfter?: number;
-    constructor(message?: string, retryAfter?: number);
+declare class TierError extends ValtaError {
+    requiredTier: string;
+    upgradeUrl: string;
+    constructor(message: string, requiredTier: string);
 }
-declare class ValtaUpgradeError extends ValtaError {
+declare class RateLimitError extends ValtaError {
     constructor(message?: string);
 }
+declare class NotFoundError extends ValtaError {
+    constructor(resource: string);
+}
 
-export { type AgentCategory, type AgentConfig, AgentHandle, AnalyticsTool, type Automation, type AutomationConfig, type ChatMessage, type ChatResponse, type PipelineConfig, type PipelineResult, type PipelineStep, type PlanType, PortfolioAgent, TradingAgent, type Transaction, ValtaAuthError, ValtaClient, type ValtaConfig, ValtaError, ValtaRateLimitError, ValtaUpgradeError, type WalletBalance, WalletTool, ValtaClient as default };
+export { type Agent, type ApiKey, type AuditLog, AuthError, type CreateAgentParams, type CreateKeyResponse, type CreatePolicyParams, type ListAgentsParams, type ListAuditParams, NotFoundError, type Policy, RateLimitError, TierError, ValtaClient, ValtaError, type WalletBalance, type WalletTransfer, type WalletTransferParams, ValtaClient as default };

package/dist/index.d.ts

@@ -1,167 +1,197 @@
-interface ValtaConfig {
-    /** Your Valta API key — get it from /dashboard/api-keys */
-    apiKey: string;
-    /** Base URL. Defaults to https://valta.co */
-    baseUrl?: string;
-    /** Optional timeout in milliseconds. Default: 30000 */
-    timeout?: number;
+interface RequestOptions {
+    method?: 'GET' | 'POST' | 'PATCH' | 'DELETE';
+    body?: unknown;
+}
+declare class Requester {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey: string, baseUrl?: string);
+    request<T>(path: string, options?: RequestOptions): Promise<T>;
 }
 
-type AgentCategory = "finance" | "trading" | "analytics" | "development" | "marketing" | "compliance" | "research" | "general";
-type PlanType = "FREE" | "PRO" | "ENTERPRISE";
-interface AgentConfig {
-    agentId: string;
+interface Agent {
+    id: string;
     name: string;
-    category: AgentCategory;
+    type: string;
+    status: 'active' | 'frozen' | 'paused';
+    walletAddress?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreateAgentParams {
+    name: string;
+    type: string;
     description?: string;
-    planRequired?: PlanType;
-    isLive?: boolean;
 }
-interface ChatMessage {
-    role: "user" | "assistant" | "system";
-    content: string;
+interface ListAgentsParams {
+    limit?: number;
+    offset?: number;
+    status?: 'active' | 'frozen' | 'paused';
+}
+interface ListAgentsResponse {
+    agents: Agent[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+declare class AgentsResource {
+    private requester;
+    constructor(requester: Requester);
+    list(params?: ListAgentsParams): Promise<ListAgentsResponse>;
+    get(agentId: string): Promise<Agent>;
+    create(params: CreateAgentParams): Promise<Agent>;
+    update(agentId: string, params: Partial<CreateAgentParams>): Promise<Agent>;
+    freeze(agentId: string): Promise<Agent>;
+    unfreeze(agentId: string): Promise<Agent>;
+    delete(agentId: string): Promise<{
+        deleted: boolean;
+        id: string;
+    }>;
 }
-interface ChatResponse {
-    message: string;
-    agentId: string;
-    tokens?: number;
-    provider?: string;
+
+interface WalletBalance {
+    usdc: string;
+    usdcPending: string;
+    lastUpdated: string;
+}
+interface WalletTransferParams {
+    toAgentId?: string;
+    toAddress?: string;
+    amount: string;
+    currency: 'USDC';
+    note?: string;
+}
+interface WalletTransfer {
+    id: string;
+    fromAgentId: string;
+    toAgentId?: string;
+    toAddress?: string;
+    amount: string;
+    currency: string;
+    status: 'pending' | 'completed' | 'failed';
+    createdAt: string;
 }
-interface AutomationConfig {
-    name: string;
-    agentId: string;
-    task: string;
-    schedule: "daily" | "every:30m" | "every:1h" | "every:6h" | "every:12h" | "every:168h";
-    enabled?: boolean;
+declare class WalletsResource {
+    private requester;
+    constructor(requester: Requester);
+    get(agentId: string): Promise<WalletBalance>;
+    transfer(agentId: string, params: WalletTransferParams): Promise<WalletTransfer>;
 }
-interface Automation {
-    automationId: string;
-    name: string;
+
+interface Policy {
+    id: string;
     agentId: string;
-    schedule: string;
-    enabled: boolean;
-    runCount: number;
-    lastRunAt: string | null;
-    nextRunAt: string | null;
+    name: string;
+    maxSpendPerDay?: number;
+    maxSpendPerTransaction?: number;
+    allowedRecipients?: string[];
+    currency: string;
+    active: boolean;
+    createdAt: string;
 }
-interface PipelineStep {
+interface CreatePolicyParams {
     agentId: string;
-    task: string;
-}
-interface PipelineConfig {
     name: string;
-    description?: string;
-    steps: PipelineStep[];
+    maxSpendPerDay?: number;
+    maxSpendPerTransaction?: number;
+    allowedRecipients?: string[];
+    currency?: string;
+}
+declare class PoliciesResource {
+    private requester;
+    constructor(requester: Requester);
+    list(agentId?: string): Promise<Policy[]>;
+    create(params: CreatePolicyParams): Promise<Policy>;
+    update(policyId: string, params: Partial<CreatePolicyParams>): Promise<Policy>;
+    delete(policyId: string): Promise<{
+        deleted: boolean;
+    }>;
 }
-interface PipelineResult {
+
+interface AuditLog {
+    id: string;
     agentId: string;
-    agentName: string;
-    response: string;
-    durationMs: number;
+    action: string;
+    amount?: string;
+    currency?: string;
+    metadata?: Record<string, unknown>;
+    hash: string;
+    previousHash: string;
+    createdAt: string;
 }
-interface WalletBalance {
-    balance: number;
-    currency: string;
+interface ListAuditParams {
+    agentId?: string;
+    limit?: number;
+    offset?: number;
+    from?: string;
+    to?: string;
 }
-interface Transaction {
-    txnId: string;
-    type: string;
-    amount: number;
-    status: string;
-    createdAt: string;
+interface ListAuditResponse {
+    logs: AuditLog[];
+    total: number;
 }
-
-declare class WalletTool {
-    private apiKey;
-    private baseUrl;
-    constructor(apiKey: string, baseUrl: string);
-    getBalance(): Promise<WalletBalance>;
-    getTransactions(limit?: number): Promise<Transaction[]>;
-    getAddress(): Promise<string>;
+declare class AuditResource {
+    private requester;
+    constructor(requester: Requester);
+    list(params?: ListAuditParams): Promise<ListAuditResponse>;
 }
 
-interface AnalyticsSummary {
-    totalSpend: number;
-    topAgents: Array<{
-        agentId: string;
-        name: string;
-        spend: number;
-    }>;
-    spendByDay: Array<{
-        date: string;
-        amount: number;
-    }>;
+interface ApiKey {
+    id: string;
+    name: string;
+    prefix: string;
+    tier: 'free' | 'builder' | 'startup' | 'enterprise';
+    lastUsed?: string;
+    createdAt: string;
 }
-declare class AnalyticsTool {
-    private apiKey;
-    private baseUrl;
-    constructor(apiKey: string, baseUrl: string);
-    getSummary(): Promise<AnalyticsSummary>;
-    getAuditTrail(limit?: number): Promise<unknown[]>;
+interface CreateKeyResponse {
+    id: string;
+    name: string;
+    key: string;
+    tier: string;
+    createdAt: string;
 }
-
-declare class TradingAgent {
-    private apiKey;
-    private baseUrl;
-    constructor(apiKey: string, baseUrl: string);
-    analyze(question: string): Promise<ChatResponse>;
-    getMarketBrief(): Promise<string>;
-    getSignals(assets: string[]): Promise<string>;
+declare class KeysResource {
+    private requester;
+    constructor(requester: Requester);
+    list(): Promise<ApiKey[]>;
+    create(name: string): Promise<CreateKeyResponse>;
+    revoke(keyId: string): Promise<{
+        deleted: boolean;
+    }>;
 }
 
-declare class PortfolioAgent {
-    private apiKey;
-    private baseUrl;
-    constructor(apiKey: string, baseUrl: string);
-    analyze(question: string): Promise<ChatResponse>;
-    getReport(): Promise<string>;
-    getRebalancingSuggestions(targetAllocation: Record<string, number>): Promise<string>;
+interface ValtaConfig {
+    apiKey: string;
+    baseUrl?: string;
 }
-
-type Plugin = (client: ValtaClient) => void;
 declare class ValtaClient {
-    readonly apiKey: string;
-    readonly baseUrl: string;
-    readonly wallet: WalletTool;
-    readonly analytics: AnalyticsTool;
-    readonly trading: TradingAgent;
-    readonly portfolio: PortfolioAgent;
-    private plugins;
-    constructor(config: ValtaConfig);
-    use(plugin: Plugin): this;
-    listAgents(): Promise<AgentConfig[]>;
-    createAgent(agentId: string): AgentHandle;
-    createAutomation(config: AutomationConfig): Promise<Automation>;
-    listAutomations(): Promise<Automation[]>;
-    runAutomation(automationId: string): Promise<{
-        response: string | null;
-    }>;
-    createPipeline(config: PipelineConfig): Promise<string>;
-    runPipeline(pipelineId: string): Promise<PipelineResult[]>;
-}
-declare class AgentHandle {
-    private apiKey;
-    private baseUrl;
-    readonly agentId: string;
-    constructor(apiKey: string, baseUrl: string, agentId: string);
-    chat(message: string, conversationId?: string): Promise<ChatResponse>;
-    run(): this;
+    agents: AgentsResource;
+    wallets: WalletsResource;
+    policies: PoliciesResource;
+    audit: AuditResource;
+    keys: KeysResource;
+    constructor(config: ValtaConfig | string);
 }
 
 declare class ValtaError extends Error {
+    code: string;
     status: number;
-    code?: string;
-    constructor(message: string, status?: number, code?: string);
+    constructor(message: string, code: string, status: number);
 }
-declare class ValtaAuthError extends ValtaError {
+declare class AuthError extends ValtaError {
     constructor(message?: string);
 }
-declare class ValtaRateLimitError extends ValtaError {
-    retryAfter?: number;
-    constructor(message?: string, retryAfter?: number);
+declare class TierError extends ValtaError {
+    requiredTier: string;
+    upgradeUrl: string;
+    constructor(message: string, requiredTier: string);
 }
-declare class ValtaUpgradeError extends ValtaError {
+declare class RateLimitError extends ValtaError {
     constructor(message?: string);
 }
+declare class NotFoundError extends ValtaError {
+    constructor(resource: string);
+}
 
-export { type AgentCategory, type AgentConfig, AgentHandle, AnalyticsTool, type Automation, type AutomationConfig, type ChatMessage, type ChatResponse, type PipelineConfig, type PipelineResult, type PipelineStep, type PlanType, PortfolioAgent, TradingAgent, type Transaction, ValtaAuthError, ValtaClient, type ValtaConfig, ValtaError, ValtaRateLimitError, ValtaUpgradeError, type WalletBalance, WalletTool, ValtaClient as default };
+export { type Agent, type ApiKey, type AuditLog, AuthError, type CreateAgentParams, type CreateKeyResponse, type CreatePolicyParams, type ListAgentsParams, type ListAuditParams, NotFoundError, type Policy, RateLimitError, TierError, ValtaClient, ValtaError, type WalletBalance, type WalletTransfer, type WalletTransferParams, ValtaClient as default };