feat(trading-strategies): add declarative strategy graphs (GraphStrategy)

packages/trading-strategies/src/index.ts

@@ -1,5 +1,6 @@
 export * from './backtest/index.js';
 export * from './strategy/index.js';
+export * from './strategy-graph/index.js';
 export * from './trader/index.js';
 export {BuyOnceStrategy, BuyOnceSchema, type BuyOnceConfig} from './strategy-buy-once/BuyOnceStrategy.js';
 /** @deprecated Use {@link BuyOnceStrategy} without `buyAt` instead. */

packages/trading-strategies/src/strategy-graph/GraphSchema.ts

@@ -0,0 +1,31 @@
+import {z} from 'zod';
+
+/**
+ * A strategy expressed as data instead of code: the same JSON drives the visual editor,
+ * validation, sharing, and the {@link GraphStrategy} interpreter, so what users see on
+ * the canvas is exactly what runs in a backtest or live session.
+ */
+export const StrategyGraphSchema = z.object({
+  connections: z.array(
+    z.object({
+      from: z.object({node: z.string().min(1), port: z.string().min(1).default('out')}),
+      to: z.object({node: z.string().min(1), port: z.string().min(1).default('in')}),
+    })
+  ),
+  name: z.string().optional(),
+  nodes: z.record(
+    z.string().min(1),
+    z.object({
+      config: z.record(z.string(), z.unknown()).optional(),
+      /** Canvas coordinates for the visual editor. Ignored by the interpreter. */
+      position: z.object({x: z.number(), y: z.number()}).optional(),
+      type: z.string().min(1),
+    })
+  ),
+  version: z.literal(1),
+});
+
+export type StrategyGraph = z.infer<typeof StrategyGraphSchema>;
+export type StrategyGraphInput = z.input<typeof StrategyGraphSchema>;
+export type GraphNode = StrategyGraph['nodes'][string];
+export type GraphConnection = StrategyGraph['connections'][number];