@cryptorobot.ai/client 0.0.39 → 1.26.0-dev.1000

package/lib/src/services/agents/sessions/sessions.shared.d.ts

@@ -0,0 +1,13 @@
+import type { Params } from '@feathersjs/feathers';
+import type { ClientApplication } from '../../../client';
+import type { AgentsSessions, AgentsSessionsData, AgentsSessionsPatch, AgentsSessionsQuery, AgentsSessionsService } from './sessions.class';
+export type { AgentsSessions, AgentsSessionsData, AgentsSessionsPatch, AgentsSessionsQuery };
+export type AgentsSessionsClientService = Pick<AgentsSessionsService<Params<AgentsSessionsQuery>>, (typeof agentsSessionsMethods)[number]>;
+export declare const agentsSessionsPath = "agents/sessions";
+export declare const agentsSessionsMethods: readonly ['find', 'get', 'create', 'patch', 'remove'];
+export declare const agentsSessionsClient: (client: ClientApplication) => void;
+declare module '../../../client' {
+    interface ServiceTypes {
+        [agentsSessionsPath]: AgentsSessionsClientService;
+    }
+}

package/lib/src/services/agents/sessions/sessions.shared.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentsSessionsClient = exports.agentsSessionsMethods = exports.agentsSessionsPath = void 0;
+exports.agentsSessionsPath = 'agents/sessions';
+exports.agentsSessionsMethods = ['find', 'get', 'create', 'patch', 'remove'];
+const agentsSessionsClient = (client) => {
+    const connection = client.get('connection');
+    client.use(exports.agentsSessionsPath, connection.service(exports.agentsSessionsPath), {
+        methods: exports.agentsSessionsMethods
+    });
+};
+exports.agentsSessionsClient = agentsSessionsClient;
+//# sourceMappingURL=sessions.shared.js.map

package/lib/src/services/agents/sessions/sync-bedrock-sessions.hooks.d.ts

@@ -0,0 +1,2 @@
+import type { HookContext } from '../../../declarations';
+export declare const syncBedrockSessions: (context: HookContext) => Promise<HookContext>;

package/lib/src/services/agents/sessions/update-bedrock-session.hooks.d.ts

@@ -0,0 +1,2 @@
+import type { HookContext } from '../../../declarations';
+export declare const updateBedrockSession: (context: HookContext) => Promise<HookContext>;

package/lib/src/services/agents/update-bedrock-agent.hooks.d.ts

@@ -0,0 +1,2 @@
+import type { HookContext } from '../../declarations';
+export declare const updateBedrockAgent: (context: HookContext) => Promise<HookContext>;

package/lib/src/services/agents/update-trigger-rules-with-agent-info.hooks.d.ts

@@ -0,0 +1,5 @@
+import type { HookContext } from '../../declarations';
+/**
+ * Update EventBridge rules with agent information when an agent is created or updated with triggers
+ */
+export declare const updateTriggerRulesWithAgentInfo: (context: HookContext<any>) => Promise<HookContext<any>>;

package/lib/src/services/agents/validate-agent-actions.hooks.d.ts

@@ -0,0 +1,3 @@
+import type { HookContext } from '../../declarations';
+export declare const validateAgentActions: (context: HookContext) => Promise<HookContext>;
+export declare const normalizeAgentActionsInResponse: (context: HookContext) => Promise<HookContext>;

package/lib/src/services/autotune/apply-params.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Map Optuna trial.params onto a preset template before models/presets.create.
+ *
+ * Supported param keys:
+ *   train_period_days        → trainingWindow
+ *   backtest_period_days     → backtestPeriodDays   (FreqAI walk-forward retrain cadence)
+ *   label_period_candles     → labelPeriodCandles
+ *   include_shifted_candles  → includeShiftedCandles
+ *   entry_threshold          → entryThreshold
+ *   exit_threshold           → exitThreshold
+ *   model                    → model              (categorical: lightgbm|xgboost|catboost)
+ *                                                  Strongly recommended to PIN model per study
+ *                                                  rather than search across families — see
+ *                                                  buildModelHyperparamSpace() in the create-study
+ *                                                  dialog. Cross-family search pollutes the score:
+ *                                                  num_leaves applied to catboost is silently
+ *                                                  ignored.
+ *   timeframe                → timeframes: [val]  (legacy single tf, categorical: 5m|15m|1h)
+ *   timeframes               → timeframes: val    (multi-tf combinations, e.g. ['5m','15m'])
+ *   stoploss                 → stoploss           (negative float, strategy class var)
+ *   trailing_stop            → trailingStop       (boolean)
+ *   trailing_stop_positive   → trailingStopPositive
+ *   trailing_stop_positive_offset → trailingStopPositiveOffset
+ *   roi_0 / roi_decay_minutes → roi0 / roiDecayMinutes (minimal_roi table)
+ *   max_open_trades          → maxOpenTrades      (top-level FT config)
+ *   DI_threshold / di_threshold → freqaiDIThreshold (drift-detection cutoff)
+ *   weight_factor            → freqaiWeightFactor (recency weighting)
+ *   noise_standard_deviation → freqaiNoiseStd     (regularization)
+ *   principal_component_analysis → freqaiPCA      (boolean)
+ *   test_size                → freqaiTestSize     (validation split fraction)
+ *   fit_live_predictions_candles → fitLivePredictionsCandles
+ *   use_<indicator>          → indicators[]       (booleans collected, e.g. use_rsi=true)
+ *   <anything else>          → modelTrainingParameters[<key>]  (lightgbm/xgb hyperparams)
+ *
+ * Throws `InsufficientIndicatorsError` when the trial picked fewer than 2
+ * indicators *and* the search space contained at least one `use_*` flag.
+ * Caller (autotune/trials) catches this and marks the trial PRUNED so Optuna
+ * doesn't learn a fake score against a substituted indicator set.
+ */
+export declare class InsufficientIndicatorsError extends Error {
+    readonly picked: string[];
+    constructor(picked: string[]);
+}
+export declare function applyParamsToPreset(template: Record<string, any>, params: Record<string, any>): Record<string, any>;

package/lib/src/services/autotune/callback.d.ts

@@ -0,0 +1,2 @@
+import type { Application } from '../../declarations';
+export declare const autotuneCallback: (app: Application) => void;

package/lib/src/services/autotune/compute/compute.d.ts

@@ -0,0 +1,40 @@
+import type { Application } from '../../../declarations';
+declare class AutotuneComputeService {
+    app: Application;
+    constructor(app: Application);
+    find(): Promise<{
+        nodes: never[];
+        jobs: never[];
+        allocations: never[];
+        cluster: null;
+    } | {
+        nodes: any[] | never[];
+        jobs: any[] | never[];
+        allocations: any[] | never[];
+        cluster: {
+            leader: string;
+            servers: any;
+            version: any;
+            region: any;
+            datacenter: any;
+            raft: {
+                appliedIndex: any;
+                lastLogIndex: any;
+                state: any;
+            };
+            broker: {
+                totalReady: number;
+                totalBlocked: number;
+                totalWaiting: number;
+            };
+            heartbeatsActive: number;
+        };
+    }>;
+}
+export declare const autotuneCompute: (app: Application) => void;
+declare module '../../../declarations' {
+    interface ServiceTypes {
+        'autotune/compute': AutotuneComputeService;
+    }
+}
+export {};

package/lib/src/services/autotune/optuna-bridge.d.ts

@@ -0,0 +1,10 @@
+export interface OptunaTrialSuggestion {
+    trialNumber: number;
+    params: Record<string, any>;
+}
+/** Idempotent: creates the study if it doesn't exist (load_if_exists=True). */
+export declare function optunaInit(storage: string, studyName: string, searchSpace: any[]): Promise<void>;
+/** Asks Optuna for N new trial suggestions. */
+export declare function optunaAsk(storage: string, studyName: string, n: number): Promise<OptunaTrialSuggestion[]>;
+/** Reports a trial score back to Optuna. Use score=null/undefined to mark a trial as failed/pruned. */
+export declare function optunaTell(storage: string, studyName: string, trialNumber: number, score: number | null): Promise<void>;

package/lib/src/services/autotune/score.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Composite score for a backtest result — signed so Optuna can rank both winners and losers.
+ *
+ * Formula: totalReturn × (0.5 + 0.5·PSR) × ddPenalty × modelQualityWeight
+ *   - totalReturn (signed): captures direction (win/loss) and magnitude
+ *   - PSR (Probabilistic Sharpe Ratio) ∈ [0,1]: trade-quality weight; floors at 0 for negative sharpe
+ *     The (0.5 + 0.5·PSR) blend keeps losing strategies on a comparable scale (50% weight floor)
+ *     so Optuna can still differentiate between "less bad" and "worse" losers.
+ *   - ddPenalty = 1 / (1 + |maxDrawdown|): extra discount for drawdown
+ *   - modelQualityWeight ∈ [0.5, 1.5]: optional, only applied when caller passes a
+ *     FreqAI training metric (validation R² or similar). Catches "lucky backtest,
+ *     terrible model" trials that would otherwise score high. Default 1.0 (no-op)
+ *     keeps the function backwards-compatible with callers that don't have access
+ *     to the model metadata.
+ *
+ * Higher is better. Returns null when results are insufficient to score.
+ */
+export interface BacktestResults {
+    sharpe?: number;
+    totalReturn?: number;
+    maxDrawdown?: number;
+    tradesCount?: number;
+    /** Alternate spelling produced by ModelPresetHelper.parseResults — accept both. */
+    tradeCount?: number;
+    profitFactor?: number;
+    winRate?: number;
+    /**
+     * Optional FreqAI training-time validation metric averaged across pairs.
+     * Typically a proxy for R² on the held-out validation split (the
+     * `data_split_parameters.test_size` slice). Values in [0,1] are interpreted
+     * as fractions; values outside are clamped before being mapped to a weight.
+     * When absent or non-finite, the score is unchanged (weight = 1.0).
+     */
+    modelValidationScore?: number;
+    [key: string]: any;
+}
+export declare function computeAutotuneScore(results: BacktestResults | undefined | null): number | null;

package/lib/src/services/autotune/storage.d.ts

@@ -0,0 +1,6 @@
+import type { Application } from '../../declarations';
+export declare const AUTOTUNE_DB_FILENAME = "optuna.db";
+/** Returns the absolute filesystem path to the shared sqlite db, ensuring the parent dir exists. */
+export declare function getAutotuneDbPath(app: Application): string;
+/** Returns the Optuna RDB storage URL (sqlite:///<absolute path>). */
+export declare function getAutotuneOptunaUrl(app: Application): string;

package/lib/src/services/autotune/studies/studies.class.d.ts

@@ -0,0 +1,12 @@
+import type { Params } from '@feathersjs/feathers';
+import type { MongoDBAdapterOptions, MongoDBAdapterParams } from '@feathersjs/mongodb';
+import { FlexibleMongoDBService } from '../../../helpers/flexible-objectid';
+import type { Application } from '../../../declarations';
+import type { AutotuneStudy, AutotuneStudyData, AutotuneStudyPatch, AutotuneStudyQuery } from './studies.schema';
+export type { AutotuneStudy, AutotuneStudyData, AutotuneStudyPatch, AutotuneStudyQuery };
+export interface AutotuneStudiesParams extends MongoDBAdapterParams<AutotuneStudyQuery> {
+    user?: any;
+}
+export declare class AutotuneStudiesService<ServiceParams extends Params = AutotuneStudiesParams> extends FlexibleMongoDBService<AutotuneStudy, AutotuneStudyData, AutotuneStudiesParams, AutotuneStudyPatch> {
+}
+export declare const getOptions: (app: Application) => MongoDBAdapterOptions;

package/lib/src/services/autotune/studies/studies.d.ts

@@ -0,0 +1,12 @@
+import type { Application } from '../../../declarations';
+import { AutotuneStudiesService } from './studies.class';
+import { autotuneStudiesPath } from './studies.shared';
+export * from './studies.class';
+export * from './studies.schema';
+export declare const hooks: any;
+export declare const autotuneStudies: (app: Application) => void;
+declare module '../../../declarations' {
+    interface ServiceTypes {
+        [autotuneStudiesPath]: AutotuneStudiesService;
+    }
+}