@backtest-kit/ollama 0.1.1 → 0.1.2

package/build/index.cjs

@@ -5051,7 +5051,7 @@ const SignalSchema = zod.z.object({
         .describe(functoolsKit.str.newline("Position direction (ALWAYS required):", "long: market shows consistent bullish signals, uptrend or growth potential", "short: market shows consistent bearish signals, downtrend or decline potential", "wait: conflicting signals between timeframes OR unfavorable trading conditions")),
     price_open: zod.z
         .number()
-        .describe(functoolsKit.str.newline("Position opening price in USD", "Use the current market price at the time of analysis")),
+        .describe(functoolsKit.str.newline("Position entry price in USD", "Can be either:", "- Current market price for immediate entry (market order)", "- Price above/below market to open a limit order and wait for its resolve before entering")),
     price_stop_loss: zod.z
         .number()
         .describe(functoolsKit.str.newline("Stop-loss price in USD", "For LONG: price below price_open (protection against decline)", "For SHORT: price above price_open (protection against rise)", "NEVER set SL in 'empty space' without technical justification")),
@@ -5479,6 +5479,64 @@ const setLogger = (logger) => {
     lib.loggerService.setLogger(logger);
 };
 
+/**
+ * Overrides the default signal format schema for LLM-generated trading signals.
+ *
+ * This function allows customization of the structured output format used by the
+ * SignalOutline. It replaces the default signal schema with a custom Zod schema,
+ * enabling flexible signal structure definitions while maintaining type safety.
+ *
+ * The override affects all subsequent signal generation calls using SignalOutline
+ * until the application restarts or the schema is overridden again.
+ *
+ * @template ZodInput - The Zod schema type used for validation and type inference
+ *
+ * @param {ZodInput} format - Custom Zod schema defining the signal structure.
+ *                            Must be a valid Zod type (z.object, z.string, etc.)
+ *
+ * @example
+ * ```typescript
+ * import { z } from 'zod';
+ * import { overrideSignalFormat } from '@backtest-kit/ollama';
+ *
+ * // Override with custom signal schema
+ * const CustomSignalSchema = z.object({
+ *   position: z.enum(['long', 'short', 'wait']),
+ *   price_open: z.number(),
+ *   confidence: z.number().min(0).max(100),
+ *   custom_field: z.string()
+ * });
+ *
+ * overrideSignalFormat(CustomSignalSchema);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Override with simplified schema
+ * const SimpleSignalSchema = z.object({
+ *   action: z.enum(['buy', 'sell', 'hold']),
+ *   price: z.number()
+ * });
+ *
+ * overrideSignalFormat(SimpleSignalSchema);
+ * ```
+ *
+ * @remarks
+ * - The custom schema replaces the default SignalSchema completely
+ * - Schema name in OpenAI format is always "position_open_decision"
+ * - Changes persist until application restart or next override
+ * - Ensure the custom schema matches your signal processing logic
+ *
+ * @see {@link SignalSchema} - Default signal schema structure
+ * @see {@link OutlineName.SignalOutline} - Outline being overridden
+ */
+function overrideSignalFormat(format) {
+    agentSwarmKit.overrideOutline({
+        outlineName: OutlineName$1.SignalOutline,
+        format: zod$1.zodResponseFormat(format, "position_open_decision"),
+    });
+}
+
 exports.alibaba = alibaba;
 exports.claude = claude;
 exports.cohere = cohere;
@@ -5490,5 +5548,6 @@ exports.hf = hf;
 exports.lib = engine;
 exports.mistral = mistral;
 exports.ollama = ollama;
+exports.overrideSignalFormat = overrideSignalFormat;
 exports.perplexity = perplexity;
 exports.setLogger = setLogger;

package/build/index.mjs

@@ -1,4 +1,4 @@
-import { json, event, validateToolArguments, RoundRobin, addCompletion, addOutline, validate } from 'agent-swarm-kit';
+import { json, event, validateToolArguments, RoundRobin, addCompletion, addOutline, validate, overrideOutline } from 'agent-swarm-kit';
 import { scoped } from 'di-scoped';
 import { createActivator } from 'di-kit';
 import MarkdownIt from 'markdown-it';
@@ -5049,7 +5049,7 @@ const SignalSchema = z.object({
         .describe(str.newline("Position direction (ALWAYS required):", "long: market shows consistent bullish signals, uptrend or growth potential", "short: market shows consistent bearish signals, downtrend or decline potential", "wait: conflicting signals between timeframes OR unfavorable trading conditions")),
     price_open: z
         .number()
-        .describe(str.newline("Position opening price in USD", "Use the current market price at the time of analysis")),
+        .describe(str.newline("Position entry price in USD", "Can be either:", "- Current market price for immediate entry (market order)", "- Price above/below market to open a limit order and wait for its resolve before entering")),
     price_stop_loss: z
         .number()
         .describe(str.newline("Stop-loss price in USD", "For LONG: price below price_open (protection against decline)", "For SHORT: price above price_open (protection against rise)", "NEVER set SL in 'empty space' without technical justification")),
@@ -5477,4 +5477,62 @@ const setLogger = (logger) => {
     lib.loggerService.setLogger(logger);
 };
 
-export { alibaba, claude, cohere, deepseek, glm4, gpt5, grok, hf, engine as lib, mistral, ollama, perplexity, setLogger };
+/**
+ * Overrides the default signal format schema for LLM-generated trading signals.
+ *
+ * This function allows customization of the structured output format used by the
+ * SignalOutline. It replaces the default signal schema with a custom Zod schema,
+ * enabling flexible signal structure definitions while maintaining type safety.
+ *
+ * The override affects all subsequent signal generation calls using SignalOutline
+ * until the application restarts or the schema is overridden again.
+ *
+ * @template ZodInput - The Zod schema type used for validation and type inference
+ *
+ * @param {ZodInput} format - Custom Zod schema defining the signal structure.
+ *                            Must be a valid Zod type (z.object, z.string, etc.)
+ *
+ * @example
+ * ```typescript
+ * import { z } from 'zod';
+ * import { overrideSignalFormat } from '@backtest-kit/ollama';
+ *
+ * // Override with custom signal schema
+ * const CustomSignalSchema = z.object({
+ *   position: z.enum(['long', 'short', 'wait']),
+ *   price_open: z.number(),
+ *   confidence: z.number().min(0).max(100),
+ *   custom_field: z.string()
+ * });
+ *
+ * overrideSignalFormat(CustomSignalSchema);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Override with simplified schema
+ * const SimpleSignalSchema = z.object({
+ *   action: z.enum(['buy', 'sell', 'hold']),
+ *   price: z.number()
+ * });
+ *
+ * overrideSignalFormat(SimpleSignalSchema);
+ * ```
+ *
+ * @remarks
+ * - The custom schema replaces the default SignalSchema completely
+ * - Schema name in OpenAI format is always "position_open_decision"
+ * - Changes persist until application restart or next override
+ * - Ensure the custom schema matches your signal processing logic
+ *
+ * @see {@link SignalSchema} - Default signal schema structure
+ * @see {@link OutlineName.SignalOutline} - Outline being overridden
+ */
+function overrideSignalFormat(format) {
+    overrideOutline({
+        outlineName: OutlineName$1.SignalOutline,
+        format: zodResponseFormat(format, "position_open_decision"),
+    });
+}
+
+export { alibaba, claude, cohere, deepseek, glm4, gpt5, grok, hf, engine as lib, mistral, ollama, overrideSignalFormat, perplexity, setLogger };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backtest-kit/ollama",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Multi-provider LLM inference library for AI-powered trading strategies. Supports 10+ providers including OpenAI, Claude, DeepSeek, Grok, Mistral with unified API and automatic token rotation.",
   "author": {
     "name": "Petr Tripolsky",
@@ -100,7 +100,8 @@
     "markdownlint": "^0.38.0",
     "sanitize-html": "^2.17.0",
     "get-moment-stamp": "^1.1.1",
-    "agent-swarm-kit": "^1.1.182"
+    "agent-swarm-kit": "^1.1.182",
+    "zod": "^3.25.76"
   },
   "publishConfig": {
     "access": "public"

package/types.d.ts

@@ -1,4 +1,5 @@
 import { IOutlineMessage, ISwarmCompletionArgs, ISwarmMessage, IOutlineCompletionArgs } from 'agent-swarm-kit';
+import { ZodType } from 'zod';
 import * as di_scoped from 'di-scoped';
 
 /**
@@ -370,6 +371,59 @@ interface ILogger {
  */
 declare const setLogger: (logger: ILogger) => void;
 
+/**
+ * Overrides the default signal format schema for LLM-generated trading signals.
+ *
+ * This function allows customization of the structured output format used by the
+ * SignalOutline. It replaces the default signal schema with a custom Zod schema,
+ * enabling flexible signal structure definitions while maintaining type safety.
+ *
+ * The override affects all subsequent signal generation calls using SignalOutline
+ * until the application restarts or the schema is overridden again.
+ *
+ * @template ZodInput - The Zod schema type used for validation and type inference
+ *
+ * @param {ZodInput} format - Custom Zod schema defining the signal structure.
+ *                            Must be a valid Zod type (z.object, z.string, etc.)
+ *
+ * @example
+ * ```typescript
+ * import { z } from 'zod';
+ * import { overrideSignalFormat } from '@backtest-kit/ollama';
+ *
+ * // Override with custom signal schema
+ * const CustomSignalSchema = z.object({
+ *   position: z.enum(['long', 'short', 'wait']),
+ *   price_open: z.number(),
+ *   confidence: z.number().min(0).max(100),
+ *   custom_field: z.string()
+ * });
+ *
+ * overrideSignalFormat(CustomSignalSchema);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Override with simplified schema
+ * const SimpleSignalSchema = z.object({
+ *   action: z.enum(['buy', 'sell', 'hold']),
+ *   price: z.number()
+ * });
+ *
+ * overrideSignalFormat(SimpleSignalSchema);
+ * ```
+ *
+ * @remarks
+ * - The custom schema replaces the default SignalSchema completely
+ * - Schema name in OpenAI format is always "position_open_decision"
+ * - Changes persist until application restart or next override
+ * - Ensure the custom schema matches your signal processing logic
+ *
+ * @see {@link SignalSchema} - Default signal schema structure
+ * @see {@link OutlineName.SignalOutline} - Outline being overridden
+ */
+declare function overrideSignalFormat<ZodInput extends ZodType>(format: ZodInput): void;
+
 /**
  * Enumeration of supported LLM inference providers.
  *
@@ -987,4 +1041,4 @@ declare const engine: {
     loggerService: LoggerService;
 };
 
-export { alibaba, claude, cohere, deepseek, glm4, gpt5, grok, hf, engine as lib, mistral, ollama, perplexity, setLogger };
+export { alibaba, claude, cohere, deepseek, glm4, gpt5, grok, hf, engine as lib, mistral, ollama, overrideSignalFormat, perplexity, setLogger };