jcc_hyper_tool 0.1.3 → 0.1.5

package/dist/advisor/actionSchema.d.ts

@@ -0,0 +1,417 @@
+import { z } from "zod";
+export declare const PriceTargetSchema: z.ZodObject<{
+    level: z.ZodNumber;
+    label: z.ZodString;
+    time_est: z.ZodString;
+    probability: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    level: number;
+    label: string;
+    time_est: string;
+    probability?: number | undefined;
+}, {
+    level: number;
+    label: string;
+    time_est: string;
+    probability?: number | undefined;
+}>;
+export declare const AnalysisSchema: z.ZodObject<{
+    indicators: z.ZodOptional<z.ZodString>;
+    elliott_wave: z.ZodOptional<z.ZodString>;
+    chan_theory: z.ZodOptional<z.ZodString>;
+    price_targets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        level: z.ZodNumber;
+        label: z.ZodString;
+        time_est: z.ZodString;
+        probability: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        level: number;
+        label: string;
+        time_est: string;
+        probability?: number | undefined;
+    }, {
+        level: number;
+        label: string;
+        time_est: string;
+        probability?: number | undefined;
+    }>, "many">>;
+    time_horizon: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    indicators?: string | undefined;
+    elliott_wave?: string | undefined;
+    chan_theory?: string | undefined;
+    price_targets?: {
+        level: number;
+        label: string;
+        time_est: string;
+        probability?: number | undefined;
+    }[] | undefined;
+    time_horizon?: string | undefined;
+}, {
+    indicators?: string | undefined;
+    elliott_wave?: string | undefined;
+    chan_theory?: string | undefined;
+    price_targets?: {
+        level: number;
+        label: string;
+        time_est: string;
+        probability?: number | undefined;
+    }[] | undefined;
+    time_horizon?: string | undefined;
+}>;
+export type AdvisorAnalysis = z.infer<typeof AnalysisSchema>;
+export type PriceTarget = z.infer<typeof PriceTargetSchema>;
+export declare const AdvisorActionSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject<{
+    analysis: z.ZodOptional<z.ZodObject<{
+        indicators: z.ZodOptional<z.ZodString>;
+        elliott_wave: z.ZodOptional<z.ZodString>;
+        chan_theory: z.ZodOptional<z.ZodString>;
+        price_targets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            level: z.ZodNumber;
+            label: z.ZodString;
+            time_est: z.ZodString;
+            probability: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            level: number;
+            label: string;
+            time_est: string;
+            probability?: number | undefined;
+        }, {
+            level: number;
+            label: string;
+            time_est: string;
+            probability?: number | undefined;
+        }>, "many">>;
+        time_horizon: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        indicators?: string | undefined;
+        elliott_wave?: string | undefined;
+        chan_theory?: string | undefined;
+        price_targets?: {
+            level: number;
+            label: string;
+            time_est: string;
+            probability?: number | undefined;
+        }[] | undefined;
+        time_horizon?: string | undefined;
+    }, {
+        indicators?: string | undefined;
+        elliott_wave?: string | undefined;
+        chan_theory?: string | undefined;
+        price_targets?: {
+            level: number;
+            label: string;
+            time_est: string;
+            probability?: number | undefined;
+        }[] | undefined;
+        time_horizon?: string | undefined;
+    }>>;
+    action: z.ZodLiteral<"wait">;
+    reason: z.ZodString;
+    confidence: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    action: "wait";
+    reason: string;
+    confidence: number;
+    analysis?: {
+        indicators?: string | undefined;
+        elliott_wave?: string | undefined;
+        chan_theory?: string | undefined;
+        price_targets?: {
+            level: number;
+            label: string;
+            time_est: string;
+            probability?: number | undefined;
+        }[] | undefined;
+        time_horizon?: string | undefined;
+    } | undefined;
+}, {
+    action: "wait";
+    reason: string;
+    confidence: number;
+    analysis?: {
+        indicators?: string | undefined;
+        elliott_wave?: string | undefined;
+        chan_theory?: string | undefined;
+        price_targets?: {
+            level: number;
+            label: string;
+            time_est: string;
+            probability?: number | undefined;
+        }[] | undefined;
+        time_horizon?: string | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    analysis: z.ZodOptional<z.ZodObject<{
+        indicators: z.ZodOptional<z.ZodString>;
+        elliott_wave: z.ZodOptional<z.ZodString>;
+        chan_theory: z.ZodOptional<z.ZodString>;
+        price_targets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            level: z.ZodNumber;
+            label: z.ZodString;
+            time_est: z.ZodString;
+            probability: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            level: number;
+            label: string;
+            time_est: string;
+            probability?: number | undefined;
+        }, {
+            level: number;
+            label: string;
+            time_est: string;
+            probability?: number | undefined;
+        }>, "many">>;
+        time_horizon: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        indicators?: string | undefined;
+        elliott_wave?: string | undefined;
+        chan_theory?: string | undefined;
+        price_targets?: {
+            level: number;
+            label: string;
+            time_est: string;
+            probability?: number | undefined;
+        }[] | undefined;
+        time_horizon?: string | undefined;
+    }, {
+        indicators?: string | undefined;
+        elliott_wave?: string | undefined;
+        chan_theory?: string | undefined;
+        price_targets?: {
+            level: number;
+            label: string;
+            time_est: string;
+            probability?: number | undefined;
+        }[] | undefined;
+        time_horizon?: string | undefined;
+    }>>;
+    action: z.ZodLiteral<"open_with_bracket">;
+    side: z.ZodEnum<["buy", "sell"]>;
+    limit_px: z.ZodNumber;
+    sz: z.ZodNumber;
+    tp_px: z.ZodNumber;
+    sl_px: z.ZodNumber;
+    is_market: z.ZodDefault<z.ZodBoolean>;
+    protection_limit_px: z.ZodOptional<z.ZodNumber>;
+    reason: z.ZodString;
+    confidence: z.ZodNumber;
+    risk_flags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    action: "open_with_bracket";
+    reason: string;
+    confidence: number;
+    side: "buy" | "sell";
+    limit_px: number;
+    sz: number;
+    tp_px: number;
+    sl_px: number;
+    is_market: boolean;
+    risk_flags: string[];
+    analysis?: {
+        indicators?: string | undefined;
+        elliott_wave?: string | undefined;
+        chan_theory?: string | undefined;
+        price_targets?: {
+            level: number;
+            label: string;
+            time_est: string;
+            probability?: number | undefined;
+        }[] | undefined;
+        time_horizon?: string | undefined;
+    } | undefined;
+    protection_limit_px?: number | undefined;
+}, {
+    action: "open_with_bracket";
+    reason: string;
+    confidence: number;
+    side: "buy" | "sell";
+    limit_px: number;
+    sz: number;
+    tp_px: number;
+    sl_px: number;
+    analysis?: {
+        indicators?: string | undefined;
+        elliott_wave?: string | undefined;
+        chan_theory?: string | undefined;
+        price_targets?: {
+            level: number;
+            label: string;
+            time_est: string;
+            probability?: number | undefined;
+        }[] | undefined;
+        time_horizon?: string | undefined;
+    } | undefined;
+    is_market?: boolean | undefined;
+    protection_limit_px?: number | undefined;
+    risk_flags?: string[] | undefined;
+}>, z.ZodObject<{
+    analysis: z.ZodOptional<z.ZodObject<{
+        indicators: z.ZodOptional<z.ZodString>;
+        elliott_wave: z.ZodOptional<z.ZodString>;
+        chan_theory: z.ZodOptional<z.ZodString>;
+        price_targets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            level: z.ZodNumber;
+            label: z.ZodString;
+            time_est: z.ZodString;
+            probability: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            level: number;
+            label: string;
+            time_est: string;
+            probability?: number | undefined;
+        }, {
+            level: number;
+            label: string;
+            time_est: string;
+            probability?: number | undefined;
+        }>, "many">>;
+        time_horizon: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        indicators?: string | undefined;
+        elliott_wave?: string | undefined;
+        chan_theory?: string | undefined;
+        price_targets?: {
+            level: number;
+            label: string;
+            time_est: string;
+            probability?: number | undefined;
+        }[] | undefined;
+        time_horizon?: string | undefined;
+    }, {
+        indicators?: string | undefined;
+        elliott_wave?: string | undefined;
+        chan_theory?: string | undefined;
+        price_targets?: {
+            level: number;
+            label: string;
+            time_est: string;
+            probability?: number | undefined;
+        }[] | undefined;
+        time_horizon?: string | undefined;
+    }>>;
+    action: z.ZodLiteral<"close_position">;
+    method: z.ZodEnum<["market", "limit"]>;
+    limit_px: z.ZodOptional<z.ZodNumber>;
+    reason: z.ZodString;
+    confidence: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    action: "close_position";
+    reason: string;
+    confidence: number;
+    method: "market" | "limit";
+    analysis?: {
+        indicators?: string | undefined;
+        elliott_wave?: string | undefined;
+        chan_theory?: string | undefined;
+        price_targets?: {
+            level: number;
+            label: string;
+            time_est: string;
+            probability?: number | undefined;
+        }[] | undefined;
+        time_horizon?: string | undefined;
+    } | undefined;
+    limit_px?: number | undefined;
+}, {
+    action: "close_position";
+    reason: string;
+    confidence: number;
+    method: "market" | "limit";
+    analysis?: {
+        indicators?: string | undefined;
+        elliott_wave?: string | undefined;
+        chan_theory?: string | undefined;
+        price_targets?: {
+            level: number;
+            label: string;
+            time_est: string;
+            probability?: number | undefined;
+        }[] | undefined;
+        time_horizon?: string | undefined;
+    } | undefined;
+    limit_px?: number | undefined;
+}>, z.ZodObject<{
+    analysis: z.ZodOptional<z.ZodObject<{
+        indicators: z.ZodOptional<z.ZodString>;
+        elliott_wave: z.ZodOptional<z.ZodString>;
+        chan_theory: z.ZodOptional<z.ZodString>;
+        price_targets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            level: z.ZodNumber;
+            label: z.ZodString;
+            time_est: z.ZodString;
+            probability: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            level: number;
+            label: string;
+            time_est: string;
+            probability?: number | undefined;
+        }, {
+            level: number;
+            label: string;
+            time_est: string;
+            probability?: number | undefined;
+        }>, "many">>;
+        time_horizon: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        indicators?: string | undefined;
+        elliott_wave?: string | undefined;
+        chan_theory?: string | undefined;
+        price_targets?: {
+            level: number;
+            label: string;
+            time_est: string;
+            probability?: number | undefined;
+        }[] | undefined;
+        time_horizon?: string | undefined;
+    }, {
+        indicators?: string | undefined;
+        elliott_wave?: string | undefined;
+        chan_theory?: string | undefined;
+        price_targets?: {
+            level: number;
+            label: string;
+            time_est: string;
+            probability?: number | undefined;
+        }[] | undefined;
+        time_horizon?: string | undefined;
+    }>>;
+    action: z.ZodLiteral<"cancel_all">;
+    reason: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    action: "cancel_all";
+    reason: string;
+    analysis?: {
+        indicators?: string | undefined;
+        elliott_wave?: string | undefined;
+        chan_theory?: string | undefined;
+        price_targets?: {
+            level: number;
+            label: string;
+            time_est: string;
+            probability?: number | undefined;
+        }[] | undefined;
+        time_horizon?: string | undefined;
+    } | undefined;
+}, {
+    action: "cancel_all";
+    reason: string;
+    analysis?: {
+        indicators?: string | undefined;
+        elliott_wave?: string | undefined;
+        chan_theory?: string | undefined;
+        price_targets?: {
+            level: number;
+            label: string;
+            time_est: string;
+            probability?: number | undefined;
+        }[] | undefined;
+        time_horizon?: string | undefined;
+    } | undefined;
+}>]>;
+export type AdvisorAction = z.infer<typeof AdvisorActionSchema>;
+/** Bracket and non–is_market paths need an explicit protection limit. */
+export declare function refineBracketProtection(action: AdvisorAction): AdvisorAction;
+export declare function extractJsonObjectFromModelText(raw: string): string;
+export declare function parseAdvisorActionFromModelText(raw: string): AdvisorAction;
+//# sourceMappingURL=actionSchema.d.ts.map

package/dist/advisor/actionSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionSchema.d.ts","sourceRoot":"","sources":["../../src/advisor/actionSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;EAK5B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMzB,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC7D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAI5D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkC9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,yEAAyE;AACzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAW5E;AAED,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAUlE;AAED,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAc1E"}

package/dist/advisor/actionSchema.js

@@ -0,0 +1,90 @@
+import { z } from "zod";
+export const PriceTargetSchema = z.object({
+    level: z.number(),
+    label: z.string(),
+    time_est: z.string(),
+    probability: z.number().min(0).max(1).optional(),
+});
+export const AnalysisSchema = z.object({
+    indicators: z.string().optional(),
+    elliott_wave: z.string().optional(),
+    chan_theory: z.string().optional(),
+    price_targets: z.array(PriceTargetSchema).optional(),
+    time_horizon: z.string().optional(),
+});
+const analysisField = { analysis: AnalysisSchema.optional() };
+export const AdvisorActionSchema = z.discriminatedUnion("action", [
+    z.object({
+        action: z.literal("wait"),
+        reason: z.string(),
+        confidence: z.number().min(0).max(1),
+        ...analysisField,
+    }),
+    z.object({
+        action: z.literal("open_with_bracket"),
+        side: z.enum(["buy", "sell"]),
+        limit_px: z.number().positive(),
+        sz: z.number().positive(),
+        tp_px: z.number().positive(),
+        sl_px: z.number().positive(),
+        is_market: z.boolean().default(true),
+        protection_limit_px: z.number().positive().optional(),
+        reason: z.string(),
+        confidence: z.number().min(0).max(1),
+        risk_flags: z.array(z.string()).default([]),
+        ...analysisField,
+    }),
+    z.object({
+        action: z.literal("close_position"),
+        method: z.enum(["market", "limit"]),
+        limit_px: z.number().positive().optional(),
+        reason: z.string(),
+        confidence: z.number().min(0).max(1),
+        ...analysisField,
+    }),
+    z.object({
+        action: z.literal("cancel_all"),
+        reason: z.string(),
+        ...analysisField,
+    }),
+]);
+/** Bracket and non–is_market paths need an explicit protection limit. */
+export function refineBracketProtection(action) {
+    if (action.action !== "open_with_bracket") {
+        return action;
+    }
+    if (action.is_market) {
+        return action;
+    }
+    if (action.protection_limit_px === undefined || !Number.isFinite(action.protection_limit_px)) {
+        throw new Error("open_with_bracket with is_market=false requires protection_limit_px");
+    }
+    return action;
+}
+export function extractJsonObjectFromModelText(raw) {
+    const t = raw.trim();
+    const fence = /^```(?:json)?\s*([\s\S]*?)```$/im.exec(t);
+    const body = fence ? fence[1].trim() : t;
+    const start = body.indexOf("{");
+    const end = body.lastIndexOf("}");
+    if (start < 0 || end <= start) {
+        throw new Error("Model output did not contain a JSON object");
+    }
+    return body.slice(start, end + 1);
+}
+export function parseAdvisorActionFromModelText(raw) {
+    const json = extractJsonObjectFromModelText(raw);
+    const obj = JSON.parse(json);
+    const parsed = AdvisorActionSchema.safeParse(obj);
+    if (!parsed.success) {
+        throw new Error(parsed.error.message);
+    }
+    const data = parsed.data;
+    if (data.action === "close_position" && data.method === "limit") {
+        if (data.limit_px === undefined || !Number.isFinite(data.limit_px)) {
+            throw new Error("close_position with method=limit requires limit_px");
+        }
+    }
+    return refineBracketProtection(data);
+}
+//# sourceMappingURL=actionSchema.js.map

package/dist/advisor/actionSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionSchema.js","sourceRoot":"","sources":["../../src/advisor/actionSchema.ts"],"names":[],"mappings":"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"}

package/dist/advisor/adviseEngine.d.ts

@@ -0,0 +1,43 @@
+import type { ChatTurn, DeepseekChatResult } from "./deepseekClient.js";
+import type { AdvisorAction } from "./actionSchema.js";
+import type { UserProfile } from "../core/state/schema.js";
+import { type GlobalCliPrefixedArgs } from "./actionRunner.js";
+import type { AdvisorMarketSnapshot } from "./contextBuilder.js";
+export type AdvisorModelTurnResult = {
+    /** Messages for the next API call (assistant entries include `reasoning_content` when present). */
+    messages: ChatTurn[];
+    action: AdvisorAction;
+    lastAssistant: DeepseekChatResult;
+};
+/**
+ * Calls DeepSeek; validates JSON/Zod; on failure appends repair instructions (bounded retries).
+ */
+export declare function runAdvisorModelTurnWithRepair(params: {
+    messages: ChatTurn[];
+    apiKey: string;
+    fetchImpl?: typeof fetch;
+    /** Extra attempts after the first failure (2 retries → 3 tries total). */
+    maxRepair?: number;
+}): Promise<AdvisorModelTurnResult>;
+export type ExecuteAdvisorResult = {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    command: string;
+    response: unknown;
+};
+export declare function executeAdvisorAction(params: {
+    action: AdvisorAction;
+    coin: string;
+    snapshot: AdvisorMarketSnapshot;
+    profile: UserProfile | undefined;
+    maxSz: number;
+    requireTpsl?: boolean;
+    globals: GlobalCliPrefixedArgs;
+    live: boolean;
+    assumeYes: boolean;
+    statePath: string | undefined;
+    noState: boolean;
+    confirmLive?: (prompt: string) => Promise<void>;
+}): Promise<ExecuteAdvisorResult>;
+//# sourceMappingURL=adviseEngine.d.ts.map

package/dist/advisor/adviseEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adviseEngine.d.ts","sourceRoot":"","sources":["../../src/advisor/adviseEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAML,KAAK,qBAAqB,EAC3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,qBAAqB,EAAsB,MAAM,qBAAqB,CAAC;AAErF,MAAM,MAAM,sBAAsB,GAAG;IACnC,mGAAmG;IACnG,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,aAAa,EAAE,kBAAkB,CAAC;CACnC,CAAC;AAEF;;GAEG;AACH,wBAAsB,6BAA6B,CAAC,MAAM,EAAE;IAC1D,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAkClC;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,qBAAqB,CAAC;IAChC,OAAO,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,qBAAqB,CAAC;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAwDhC"}

package/dist/advisor/adviseEngine.js

@@ -0,0 +1,91 @@
+import { assistantChatTurnFromResult, deepseekChat } from "./deepseekClient.js";
+import { parseAdvisorActionFromModelText } from "./actionSchema.js";
+import { assertAdvisorActionPassesGuards } from "./guards.js";
+import { advisorActionToCliArgs, assertAdviseActionNeedsState, buildGlobalPrefix, formatCliInvocation, spawnJccHyperTool, } from "./actionRunner.js";
+/**
+ * Calls DeepSeek; validates JSON/Zod; on failure appends repair instructions (bounded retries).
+ */
+export async function runAdvisorModelTurnWithRepair(params) {
+    const maxRepair = params.maxRepair ?? 2;
+    const maxAttempts = maxRepair + 1;
+    let msgs = [...params.messages];
+    let lastRes = { content: "" };
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        lastRes = await deepseekChat({
+            apiKey: params.apiKey,
+            messages: msgs,
+            fetchImpl: params.fetchImpl,
+        });
+        try {
+            const action = parseAdvisorActionFromModelText(lastRes.content);
+            msgs = [...msgs, assistantChatTurnFromResult(lastRes)];
+            return { messages: msgs, action, lastAssistant: lastRes };
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            if (attempt >= maxAttempts - 1) {
+                throw e;
+            }
+            msgs = [
+                ...msgs,
+                assistantChatTurnFromResult(lastRes),
+                {
+                    role: "user",
+                    content: `Your reply failed validation: ${msg}. Output ONE JSON object only, no markdown, matching the schema.`,
+                },
+            ];
+        }
+    }
+    throw new Error("advisor: model repair loop exhausted");
+}
+export async function executeAdvisorAction(params) {
+    if (params.action.action === "wait") {
+        return {
+            exitCode: 0,
+            stdout: "",
+            stderr: "",
+            command: "(no exchange action)",
+            response: { note: "wait" },
+        };
+    }
+    const posRow = params.snapshot.positions[params.snapshot.coin];
+    const positionSignedSz = posRow?.signed_sz;
+    assertAdvisorActionPassesGuards(params.action, {
+        coin: params.coin,
+        maxSz: params.maxSz,
+        requireTpsl: params.requireTpsl,
+        mid: params.snapshot.mid,
+        positionSignedSz,
+        profile: params.profile,
+    });
+    assertAdviseActionNeedsState(params.action, params.noState, params.statePath);
+    const g = buildGlobalPrefix(params.globals);
+    const argv = advisorActionToCliArgs(params.action, {
+        coin: params.snapshot.coin,
+        mid: params.snapshot.mid,
+        positionSignedSz,
+        globals: g,
+        live: params.live,
+        assumeYes: params.assumeYes,
+    });
+    const command = formatCliInvocation(argv);
+    if (params.live && !params.assumeYes && params.confirmLive) {
+        await params.confirmLive(`Proposed command:\n${command}\n`);
+    }
+    const cap = spawnJccHyperTool(argv, { stdio: "pipe" });
+    let response = { stdout: cap.stdout, stderr: cap.stderr };
+    try {
+        response = JSON.parse(cap.stdout);
+    }
+    catch {
+        /* non-JSON stdout */
+    }
+    return {
+        exitCode: cap.status ?? 1,
+        stdout: cap.stdout,
+        stderr: cap.stderr,
+        command,
+        response,
+    };
+}
+//# sourceMappingURL=adviseEngine.js.map

package/dist/advisor/adviseEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adviseEngine.js","sourceRoot":"","sources":["../../src/advisor/adviseEngine.ts"],"names":[],"mappings":"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"}