@reefclaw/connect 0.1.12 → 0.1.13

package/assets/plugin/tools/create-order.d.ts

@@ -0,0 +1,89 @@
+import type { PublicMarketDataApi } from '../ccxt/public-market-data-api.js';
+import type { IExchangeAdapter } from '../exchange-adapter.js';
+import type { CcxtOrder } from '../types.js';
+import { type AutoCaptureContext } from '../ingest/position-auto-capture.js';
+import type { ProposalManager } from '../live/proposal-manager.js';
+import type { TradingOperationLock } from '../lifecycle/trading-operation-lock.js';
+import { type Wave9LiveExecutionLedger } from '../wave9/live-execution-ledger.js';
+import type { Wave9LiveStopConfirmationInput } from '../wave9/live-account-capture.js';
+import { type Wave9LiveSymbolOwnershipCheck } from '../wave9/live-symbol-ownership.js';
+import { type Wave9LiveResidualProtectionResult } from '../wave9/live-residual-protection.js';
+import { type Wave9PaperAdmissionGuard } from '../wave9/paper-admission-guard.js';
+type Wave9LiveResidualProtector = (adapter: IExchangeAdapter, ledger: Wave9LiveExecutionLedger, candidateId: string, symbol: string) => Promise<Wave9LiveResidualProtectionResult>;
+/** Venue-aware idempotency cid for the live entry stash. HL client-order-ids
+ *  are 128-bit hex (0x + 32 hex chars) — a dashed randomUUID() fails
+ *  hl-private's cloid validation and the ENTRY IS REJECTED before reaching
+ *  the exchange (found live by the go-live rehearsal's first dust trade).
+ *  buildHlOrderCloid() mints the 0x0d… ORDER prefix, which the bracket parser
+ *  deliberately never recognises (cross-scheme cancels are destructive). */
+export declare function mintEntryStashCid(adapter: IExchangeAdapter): string;
+export declare function createOrderTool(args: {
+    symbol: string;
+    side: string;
+    type: string;
+    amount: number;
+    price?: number;
+    stopPrice?: number;
+    mission_id?: string;
+    /** Guarded Wave 9 identity/capability. Both are invalid on generic orders. */
+    candidate_id?: string;
+    wave9_admission_token?: string;
+    setup_type?: string;
+    thesis?: string;
+    target_price?: number;
+    regime?: string;
+    regime_confidence?: number;
+    scorecard_verdict?: string;
+    confluence_score?: number;
+    invalidation_price?: number;
+    realization_rule?: unknown;
+    supersedes_id?: string;
+}, deps: {
+    binanceApi: PublicMarketDataApi;
+    adapter: IExchangeAdapter;
+    autoCapture?: AutoCaptureContext;
+    /** Approval-mode wiring. The same ProposalManager handles both modes;
+     *  `approvalMode` selects the branch:
+     *
+     *    'off'       — fire normally. proposalManager is ignored.
+     *    'shadow'    — Phase A telemetry. Dual-write proposal row AND fire
+     *                  the real order. Used to collect setup distribution
+     *                  before flipping per_trade. See APPROVAL_MODE_DESIGN.md §12.
+     *    'per_trade' — THE feature. Propose only — DO NOT fire. Return
+     *                  pending_approval; the operator approves on the dashboard
+     *                  and ProposalDecisionListener fires via this same tool
+     *                  with proposalManager omitted (which goes through the
+     *                  normal real-fire path).
+     *
+     *  The listener-side fire is the one path that calls createOrderTool
+     *  WITHOUT proposalManager — it bypasses the propose branch and runs
+     *  the real adapter.createOrder. */
+    proposalManager?: ProposalManager;
+    userId?: string;
+    approvalMode?: 'off' | 'shadow' | 'per_trade';
+    wave9AdmissionGuard?: Wave9PaperAdmissionGuard;
+    wave9ActivationCheck?: () => Promise<{
+        available: boolean;
+        active: boolean;
+    }>;
+    refreshPaperState?: () => void;
+    wave9TradingModeCheck?: () => string;
+    wave9VenueCheck?: () => string;
+    captureWave9AccountFingerprint?: () => Promise<{
+        fingerprint: string;
+    }>;
+    confirmWave9LiveStop?: (input: Wave9LiveStopConfirmationInput) => Promise<boolean>;
+    wave9LiveLedger?: Wave9LiveExecutionLedger;
+    checkWave9LiveSymbolOwnership?: Wave9LiveSymbolOwnershipCheck;
+    reprotectWave9LiveResidual?: Wave9LiveResidualProtector;
+    operationLock?: TradingOperationLock;
+}): Promise<CcxtOrder | {
+    error: string;
+} | {
+    status: 'pending_approval';
+    proposal_id: string;
+    hard_expires_at: string;
+    setup_bucket: 'momentum' | 'mean_reversion';
+    message: string;
+}>;
+export {};