@reefclaw/connect 0.1.12 → 0.1.13

package/assets/plugin/tools/get-wave9-status.d.ts

@@ -0,0 +1,127 @@
+import { evaluateWave9Daily, type Wave9StrategyName } from '../portfolio/wave9-policy.js';
+import { type Wave9EvidenceProvider } from '../wave9/usdm-evidence-provider.js';
+import type { TradingOperationLock } from '../lifecycle/trading-operation-lock.js';
+import type { Wave9NativeStopObservation } from '../wave9/live-account-capture.js';
+import type { Wave9ExecutionMode } from '../wave9/paper-admission-guard.js';
+import type { IntelApiDeps } from './intel-api.js';
+export declare const WAVE9_BUNDLE_NAME = "wave9_28d_momentum_reversal";
+export declare const WAVE9_EXECUTION_KERNEL = "wave9_shared_v1";
+export declare const WAVE9_PAPER_ENTRY_WINDOW_MS: number;
+export interface Wave9BundleActivation {
+    available: boolean;
+    name: typeof WAVE9_BUNDLE_NAME;
+    executionModel: typeof WAVE9_EXECUTION_KERNEL;
+    active: boolean;
+    source?: 'tenant_override' | 'global_default';
+    error?: string;
+}
+export interface Wave9ActivationClient {
+    getActivation(): Promise<Wave9BundleActivation>;
+}
+export declare class IntelWave9ActivationClient implements Wave9ActivationClient {
+    private readonly deps;
+    constructor(deps: IntelApiDeps);
+    getActivation(): Promise<Wave9BundleActivation>;
+}
+export interface Wave9ObservedPosition {
+    symbol: string;
+    side: 'long' | 'short';
+    quantity: number;
+    entryPrice: number;
+    markPrice: number;
+    stopPrice?: number;
+    missionId?: string;
+    setupType?: string;
+    /** Present only after an exact Wave 9 admission has recorded it. */
+    candidateId?: string;
+    /** Optional future durable geometry for authoritative open-book projection. */
+    strategy?: Wave9StrategyName;
+    accruedFundingUsd?: number;
+    openedAt?: string;
+    /** Exchange-native stop identity and liveness bound by LIVE capture. */
+    nativeStop?: Wave9NativeStopObservation;
+    /** Stable held-position geometry, excluding mark/MFE/wallet volatility. */
+    positionFingerprint?: string;
+}
+export interface Wave9AccountSnapshot {
+    tradingMode: 'PAPER' | 'SHADOW' | 'MICRO_LIVE' | 'LIVE';
+    positionsAvailable: boolean;
+    openOrdersAvailable: boolean;
+    openOrderCount?: number;
+    /** Wallet cash after booked fees/realized PnL, not MTM account equity. */
+    cashEquityAvailable: boolean;
+    cashEquityUsd?: number;
+    positions?: Wave9ObservedPosition[];
+    /** Persisted closed Wave 9 identities; survives a gateway restart. */
+    executedCandidateIds?: string[];
+    source: string;
+    /** Exact process-local account geometry bound into short-lived guards. */
+    accountFingerprint?: string;
+    authoritative: boolean;
+    runtimeParity: false;
+    provenance: string;
+    adapterReadiness?: string;
+    nativeStopProtectionAvailable?: boolean;
+    reasons?: string[];
+}
+export interface Wave9EntryAuthorizationInput {
+    batchId: string;
+    candidateId: string;
+    missionId: string;
+    symbol: string;
+    side: 'BUY' | 'SELL';
+    quantity: string;
+    stopPrice: string;
+    sequence: number;
+    notBeforeMs: number;
+    deadlineMs: number;
+    accountFingerprint: string;
+    tradingMode: Wave9ExecutionMode;
+}
+export interface Wave9IssuedEntryAuthorization {
+    token: string;
+    batchId: string;
+    candidateId: string;
+    missionId: string;
+    sequence: number;
+    deadlineMs: number;
+    accountFingerprint: string;
+    tradingMode: Wave9ExecutionMode;
+}
+export interface Wave9ExitAuthorizationInput {
+    candidateId: string;
+    missionId: string;
+    symbol: string;
+    positionSide: 'long' | 'short';
+    reason: 'signal_reversal';
+    notBeforeMs: number;
+    deadlineMs: number;
+    positionFingerprint: string;
+    tradingMode: Wave9ExecutionMode;
+}
+export interface Wave9IssuedExitAuthorization {
+    token: string;
+    candidateId: string;
+    missionId: string;
+    deadlineMs: number;
+    positionFingerprint?: string;
+    tradingMode: Wave9ExecutionMode;
+}
+/** Structural seam implemented by the process-local paper admission guard. */
+export interface Wave9AdmissionAuthorizationIssuer {
+    issueBatch(decisions: readonly Wave9EntryAuthorizationInput[]): readonly Wave9IssuedEntryAuthorization[];
+    issueExitBatch(decisions: readonly Wave9ExitAuthorizationInput[]): readonly Wave9IssuedExitAuthorization[];
+}
+export interface GetWave9StatusDeps {
+    activationClient: Wave9ActivationClient;
+    getAccountSnapshot(): Promise<Wave9AccountSnapshot>;
+    operationLock: TradingOperationLock;
+    /** Wave 9 evidence and execution are pinned to Binance USD-M. */
+    executionVenue: string;
+    createEvidenceProvider?: () => Wave9EvidenceProvider;
+    authorizationIssuer?: Wave9AdmissionAuthorizationIssuer;
+    now?: () => Date;
+    evaluateDaily?: typeof evaluateWave9Daily;
+}
+export declare function wave9MissionId(candidateId: string): string;
+export declare function getWave9StatusTool(deps: GetWave9StatusDeps): Promise<Record<string, unknown>>;