@wingman-ai/gateway 0.1.0

package/.wingman/agents/stock-trader/goal-translator.md

@@ -0,0 +1,42 @@
+Task: Translate the user goal into an Aggressiveness Profile.
+
+Inputs (from orchestrator context):
+- starting_capital
+- target_capital or profit_target
+- deadline_days
+- options_allowed = true
+- user_risk_attitude: conservative|neutral|risk_on (optional)
+- hard_stop_out_rules (if provided)
+
+Rules:
+- Compute required return pace (daily/weekly/monthly) using compound growth.
+- If required returns imply extreme risk, say so plainly.
+- Never recommend breaking guardrails to chase the goal.
+
+Output JSON only:
+{
+  "goal_state": {
+    "starting_capital": 0,
+    "target_capital": 0,
+    "deadline_days": 0,
+    "user_risk_attitude": "conservative|neutral|risk_on",
+    "notes": "..."
+  },
+  "required_return": {
+    "daily": 0,
+    "weekly": 0,
+    "monthly": 0
+  },
+  "aggressiveness_profile": {
+    "level": 1,
+    "allowed_strategy_set": ["..."],
+    "risk_per_trade_cap_pct": 0,
+    "max_total_risk_pct": 0,
+    "max_concurrent_positions": 0,
+    "trade_frequency_budget": "..."
+  },
+  "feasibility_notes": [
+    "What must be true for this goal to be reachable",
+    "Primary failure mode"
+  ]
+}

package/.wingman/agents/stock-trader/guardrails-veto.md

@@ -0,0 +1,11 @@
+Task: Final review of the Decision Packet draft.
+
+Rules:
+- If any guardrail is violated, return VETO and cite the violated rule.
+- If edits are required, return APPROVE_WITH_EDITS and specify edits.
+- If data_health is below threshold, veto to NO TRADE.
+
+Output (exactly one of the following):
+- APPROVE
+- APPROVE_WITH_EDITS: <edits>
+- VETO: <violated guardrail>

package/.wingman/agents/stock-trader/path-planner.md

@@ -0,0 +1,23 @@
+Task: Propose a staged path-to-goal plan using checkpoints and risk budgets.
+
+Rules:
+- Output 3 plans: base / aggressive / extreme.
+- Each plan must specify checkpoints, expected trade frequency, typical max loss per trade, typical structure types, and stop-out rules.
+- Use only provided context; do not call tools.
+
+Output JSON only:
+{
+  "plans": [
+    {
+      "name": "base|aggressive|extreme",
+      "expected_trade_frequency": "...",
+      "typical_max_loss_per_trade_pct": 0,
+      "typical_structure_types": ["..."],
+      "checkpoints": [
+        {"day": 0, "equity": 0},
+        {"day": 0, "equity": 0}
+      ],
+      "stop_out": {"equity": 0, "rule": "..."}
+    }
+  ]
+}

package/.wingman/agents/stock-trader/regime-analyst.md

@@ -0,0 +1,15 @@
+Task: Classify market regime and options-friendliness.
+
+Rules:
+- Use only the provided context; no tool calls.
+- Separate facts from inferences.
+
+Output JSON only:
+{
+  "market_regime": {
+    "label": "trend|range|high_vol|low_vol|risk_off",
+    "volatility_note": "...",
+    "options_friendly": true,
+    "notes": "..."
+  }
+}

package/.wingman/agents/stock-trader/risk.md

@@ -0,0 +1,20 @@
+Task: Approve or reject options candidates under the Risk Policy.
+
+Rules:
+- Use only the provided context. Do not request more data or call tools.
+- Reject anything that violates max loss caps, liquidity thresholds, or concentration limits.
+- Never approve “size up to catch up” logic.
+
+Output JSON only:
+{
+  "approved": true,
+  "approved_trades": ["..."],
+  "rejected_trades": [
+    {"symbol": "XYZ", "reason": "..."}
+  ],
+  "portfolio_risk_summary": {
+    "total_max_loss_if_all_hit": 0,
+    "greeks_concentration_flags": ["..."],
+    "liquidity_flags": ["..."]
+  }
+}

package/.wingman/agents/stock-trader/selection.md

@@ -0,0 +1,22 @@
+Task: Produce underlying trade theses with clear invalidation.
+
+Rules:
+- Use only the provided context. Do not request more data or call tools.
+- Do not propose options structures; focus on underlying thesis only.
+- Be explicit about uncertainty and data gaps.
+
+Output JSON only:
+{
+  "trade_theses": [
+    {
+      "symbol": "XYZ",
+      "bias": "bullish|bearish|volatility",
+      "thesis": "why now",
+      "entry_trigger": "condition",
+      "invalidation": "condition",
+      "time_horizon": "intraday|swing|multiweek",
+      "key_risks": ["..."],
+      "do_not_trade_if": ["..."]
+    }
+  ]
+}

package/.wingman/agents/stock-trader/strategy-composer.md

@@ -0,0 +1,38 @@
+Task: For each thesis with a viable option chain, propose 1-3 options structures aligned to the aggressiveness level.
+
+Inputs:
+- aggressiveness_profile
+- trade_theses
+- chain_summaries
+- payoff_and_greeks (from options.analyze tool)
+
+Rules:
+- Use only provided context; do not call tools.
+- Must be defined-risk unless policy explicitly allows otherwise.
+- Must match aggressiveness level (short DTE only at high levels).
+
+Output JSON only:
+{
+  "options_candidates": [
+    {
+      "symbol": "XYZ",
+      "structure_type": "long_call|long_put|debit_spread|credit_spread|calendar|straddle|strangle|butterfly",
+      "legs": [
+        {"type":"call|put", "side":"buy|sell", "expiry":"YYYY-MM-DD", "strike":0, "qty":1}
+      ],
+      "entry_plan": {"order_type":"limit", "logic":"..."},
+      "max_loss": {"usd":0, "pct_equity":0},
+      "max_profit": {"usd":0, "notes":"capped|uncapped"},
+      "breakevens": [0],
+      "greeks_snapshot": {"delta":0, "gamma":0, "vega":0, "theta":0},
+      "management_plan": {
+        "take_profit": "...",
+        "stop_out": "...",
+        "time_stop": "...",
+        "roll_rules": "..."
+      },
+      "failure_modes": ["..."],
+      "do_not_trade_if": ["..."]
+    }
+  ]
+}

package/.wingman/agents/wingman/agent.json

@@ -0,0 +1,12 @@
+{
+  "name": "wingman",
+  "description": "General-purpose coding assistant for this workspace.",
+  "systemPrompt": "You are Wingman, a coding assistant for this repository.\nBe direct and concise. Ask clarifying questions when requirements are unclear.\nPrefer minimal diffs and safe changes. Avoid destructive actions unless asked.\nUse tools to inspect the codebase before editing.",
+  "tools": [
+    "code_search",
+    "git_status",
+    "command_execute",
+    "internet_search",
+    "think"
+  ]
+}

package/bin/wingman

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+
+// Import the CLI entry point
+import('../dist/cli/index.js').catch((error) => {
+  console.error('Failed to start Wingman CLI:', error.message);
+  process.exit(1);
+});

package/dist/agent/config/agentConfig.cjs

@@ -0,0 +1,95 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    WingmanDirectory: ()=>WingmanDirectory,
+    AgentConfigSchema: ()=>AgentConfigSchema,
+    AvailableToolNames: ()=>AvailableToolNames,
+    validateAgentConfig: ()=>validateAgentConfig
+});
+const external_zod_namespaceObject = require("zod");
+const types_cjs_namespaceObject = require("../middleware/hooks/types.cjs");
+const mcp_cjs_namespaceObject = require("../../types/mcp.cjs");
+const voice_cjs_namespaceObject = require("../../types/voice.cjs");
+const WingmanDirectory = ".wingman";
+const AvailableToolNames = external_zod_namespaceObject.z["enum"]([
+    "internet_search",
+    "web_crawler",
+    "command_execute",
+    "think",
+    "code_search",
+    "git_status"
+]);
+const BaseAgentConfigSchema = external_zod_namespaceObject.z.object({
+    name: external_zod_namespaceObject.z.string().min(1).describe("Unique agent name (e.g., 'data-analyst')"),
+    description: external_zod_namespaceObject.z.string().min(1).describe("Action-oriented description of what the agent does (helps root agent decide when to delegate)"),
+    systemPrompt: external_zod_namespaceObject.z.string().min(1).describe("Detailed instructions for the agent, including tool usage guidance and output formatting"),
+    tools: external_zod_namespaceObject.z.array(AvailableToolNames).optional().describe("List of available tools for this agent. Keep minimal and focused."),
+    model: external_zod_namespaceObject.z.string().optional().describe('Model override in format "provider:model-name" (e.g., "anthropic:claude-opus-4-5", "openrouter:openai/gpt-4o", "copilot:gpt-4o")'),
+    blockedCommands: external_zod_namespaceObject.z.array(external_zod_namespaceObject.z.string()).optional().describe("List of blocked commands for command_execute tool (e.g., ['rm', 'mv'])"),
+    allowScriptExecution: external_zod_namespaceObject.z.boolean().optional().default(true).describe("Whether to allow script execution in command_execute tool"),
+    commandTimeout: external_zod_namespaceObject.z.number().optional().default(300000).describe("Command execution timeout in milliseconds (default: 300000)"),
+    toolHooks: types_cjs_namespaceObject.HooksConfigSchema.optional().describe("Agent-specific tool hooks configuration"),
+    mcp: mcp_cjs_namespaceObject.MCPServersConfigSchema.optional().describe("Agent-specific MCP server configurations"),
+    mcpUseGlobal: external_zod_namespaceObject.z.boolean().optional().default(false).describe("Whether this agent should also load global MCP servers from wingman.config.json"),
+    voice: voice_cjs_namespaceObject.AgentVoiceConfigSchema.optional().describe("Agent-specific voice configuration")
+});
+const AgentConfigSchema = BaseAgentConfigSchema.extend({
+    subAgents: external_zod_namespaceObject.z.array(BaseAgentConfigSchema).optional().describe("List of sub-agents that this agent can delegate to (each may include its own model override)")
+});
+function validateAgentConfig(config) {
+    try {
+        const data = AgentConfigSchema.parse(config);
+        return {
+            success: true,
+            data
+        };
+    } catch (error) {
+        if (error instanceof external_zod_namespaceObject.z.ZodError) {
+            const messages = error.issues.map((err)=>`  - ${err.path.join(".")}: ${err.message}`).join("\n");
+            return {
+                success: false,
+                error: `Invalid agent configuration:\n${messages}`
+            };
+        }
+        return {
+            success: false,
+            error: `Unknown validation error: ${error}`
+        };
+    }
+}
+exports.AgentConfigSchema = __webpack_exports__.AgentConfigSchema;
+exports.AvailableToolNames = __webpack_exports__.AvailableToolNames;
+exports.WingmanDirectory = __webpack_exports__.WingmanDirectory;
+exports.validateAgentConfig = __webpack_exports__.validateAgentConfig;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "AgentConfigSchema",
+    "AvailableToolNames",
+    "WingmanDirectory",
+    "validateAgentConfig"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/agent/config/agentConfig.d.ts

@@ -0,0 +1,187 @@
+import { z } from "zod";
+export declare const WingmanDirectory = ".wingman";
+/**
+ * Available tool names for user-defined agents
+ */
+export declare const AvailableToolNames: z.ZodEnum<{
+    internet_search: "internet_search";
+    web_crawler: "web_crawler";
+    command_execute: "command_execute";
+    think: "think";
+    code_search: "code_search";
+    git_status: "git_status";
+}>;
+export type AvailableToolName = z.infer<typeof AvailableToolNames>;
+export declare const AgentConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    systemPrompt: z.ZodString;
+    tools: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        internet_search: "internet_search";
+        web_crawler: "web_crawler";
+        command_execute: "command_execute";
+        think: "think";
+        code_search: "code_search";
+        git_status: "git_status";
+    }>>>;
+    model: z.ZodOptional<z.ZodString>;
+    blockedCommands: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    allowScriptExecution: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    commandTimeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    toolHooks: z.ZodOptional<z.ZodObject<{
+        PreToolUse: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodOptional<z.ZodString>;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+        PostToolUse: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodOptional<z.ZodString>;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+        Stop: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+                timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    mcp: z.ZodOptional<z.ZodObject<{
+        servers: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            name: z.ZodString;
+            transport: z.ZodLiteral<"stdio">;
+            command: z.ZodString;
+            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strip>, z.ZodObject<{
+            name: z.ZodString;
+            transport: z.ZodLiteral<"sse">;
+            url: z.ZodString;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strip>]>>>;
+    }, z.core.$strip>>;
+    mcpUseGlobal: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    voice: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodOptional<z.ZodEnum<{
+            web_speech: "web_speech";
+            elevenlabs: "elevenlabs";
+        }>>;
+        webSpeech: z.ZodOptional<z.ZodObject<{
+            voiceName: z.ZodOptional<z.ZodString>;
+            lang: z.ZodOptional<z.ZodString>;
+            rate: z.ZodOptional<z.ZodNumber>;
+            pitch: z.ZodOptional<z.ZodNumber>;
+            volume: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        elevenlabs: z.ZodOptional<z.ZodObject<{
+            voiceId: z.ZodOptional<z.ZodString>;
+            modelId: z.ZodOptional<z.ZodString>;
+            stability: z.ZodOptional<z.ZodNumber>;
+            similarityBoost: z.ZodOptional<z.ZodNumber>;
+            style: z.ZodOptional<z.ZodNumber>;
+            speakerBoost: z.ZodOptional<z.ZodBoolean>;
+            speed: z.ZodOptional<z.ZodNumber>;
+            outputFormat: z.ZodOptional<z.ZodString>;
+            optimizeStreamingLatency: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    subAgents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        systemPrompt: z.ZodString;
+        tools: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            internet_search: "internet_search";
+            web_crawler: "web_crawler";
+            command_execute: "command_execute";
+            think: "think";
+            code_search: "code_search";
+            git_status: "git_status";
+        }>>>;
+        model: z.ZodOptional<z.ZodString>;
+        blockedCommands: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        allowScriptExecution: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        commandTimeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        toolHooks: z.ZodOptional<z.ZodObject<{
+            PreToolUse: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                matcher: z.ZodOptional<z.ZodString>;
+                hooks: z.ZodArray<z.ZodObject<{
+                    type: z.ZodLiteral<"command">;
+                    command: z.ZodString;
+                    timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
+            PostToolUse: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                matcher: z.ZodOptional<z.ZodString>;
+                hooks: z.ZodArray<z.ZodObject<{
+                    type: z.ZodLiteral<"command">;
+                    command: z.ZodString;
+                    timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
+            Stop: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                hooks: z.ZodArray<z.ZodObject<{
+                    type: z.ZodLiteral<"command">;
+                    command: z.ZodString;
+                    timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+        mcp: z.ZodOptional<z.ZodObject<{
+            servers: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                name: z.ZodString;
+                transport: z.ZodLiteral<"stdio">;
+                command: z.ZodString;
+                args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, z.core.$strip>, z.ZodObject<{
+                name: z.ZodString;
+                transport: z.ZodLiteral<"sse">;
+                url: z.ZodString;
+                headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, z.core.$strip>]>>>;
+        }, z.core.$strip>>;
+        mcpUseGlobal: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        voice: z.ZodOptional<z.ZodObject<{
+            provider: z.ZodOptional<z.ZodEnum<{
+                web_speech: "web_speech";
+                elevenlabs: "elevenlabs";
+            }>>;
+            webSpeech: z.ZodOptional<z.ZodObject<{
+                voiceName: z.ZodOptional<z.ZodString>;
+                lang: z.ZodOptional<z.ZodString>;
+                rate: z.ZodOptional<z.ZodNumber>;
+                pitch: z.ZodOptional<z.ZodNumber>;
+                volume: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            elevenlabs: z.ZodOptional<z.ZodObject<{
+                voiceId: z.ZodOptional<z.ZodString>;
+                modelId: z.ZodOptional<z.ZodString>;
+                stability: z.ZodOptional<z.ZodNumber>;
+                similarityBoost: z.ZodOptional<z.ZodNumber>;
+                style: z.ZodOptional<z.ZodNumber>;
+                speakerBoost: z.ZodOptional<z.ZodBoolean>;
+                speed: z.ZodOptional<z.ZodNumber>;
+                outputFormat: z.ZodOptional<z.ZodString>;
+                optimizeStreamingLatency: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type WingmanAgentConfig = z.infer<typeof AgentConfigSchema>;
+/**
+ * Validate a single agent configuration
+ */
+export declare function validateAgentConfig(config: unknown): {
+    success: true;
+    data: WingmanAgentConfig;
+} | {
+    success: false;
+    error: string;
+};

package/dist/agent/config/agentConfig.js

@@ -0,0 +1,52 @@
+import { z } from "zod";
+import { HooksConfigSchema } from "../middleware/hooks/types.js";
+import { MCPServersConfigSchema } from "../../types/mcp.js";
+import { AgentVoiceConfigSchema } from "../../types/voice.js";
+const WingmanDirectory = ".wingman";
+const AvailableToolNames = z["enum"]([
+    "internet_search",
+    "web_crawler",
+    "command_execute",
+    "think",
+    "code_search",
+    "git_status"
+]);
+const BaseAgentConfigSchema = z.object({
+    name: z.string().min(1).describe("Unique agent name (e.g., 'data-analyst')"),
+    description: z.string().min(1).describe("Action-oriented description of what the agent does (helps root agent decide when to delegate)"),
+    systemPrompt: z.string().min(1).describe("Detailed instructions for the agent, including tool usage guidance and output formatting"),
+    tools: z.array(AvailableToolNames).optional().describe("List of available tools for this agent. Keep minimal and focused."),
+    model: z.string().optional().describe('Model override in format "provider:model-name" (e.g., "anthropic:claude-opus-4-5", "openrouter:openai/gpt-4o", "copilot:gpt-4o")'),
+    blockedCommands: z.array(z.string()).optional().describe("List of blocked commands for command_execute tool (e.g., ['rm', 'mv'])"),
+    allowScriptExecution: z.boolean().optional().default(true).describe("Whether to allow script execution in command_execute tool"),
+    commandTimeout: z.number().optional().default(300000).describe("Command execution timeout in milliseconds (default: 300000)"),
+    toolHooks: HooksConfigSchema.optional().describe("Agent-specific tool hooks configuration"),
+    mcp: MCPServersConfigSchema.optional().describe("Agent-specific MCP server configurations"),
+    mcpUseGlobal: z.boolean().optional().default(false).describe("Whether this agent should also load global MCP servers from wingman.config.json"),
+    voice: AgentVoiceConfigSchema.optional().describe("Agent-specific voice configuration")
+});
+const AgentConfigSchema = BaseAgentConfigSchema.extend({
+    subAgents: z.array(BaseAgentConfigSchema).optional().describe("List of sub-agents that this agent can delegate to (each may include its own model override)")
+});
+function validateAgentConfig(config) {
+    try {
+        const data = AgentConfigSchema.parse(config);
+        return {
+            success: true,
+            data
+        };
+    } catch (error) {
+        if (error instanceof z.ZodError) {
+            const messages = error.issues.map((err)=>`  - ${err.path.join(".")}: ${err.message}`).join("\n");
+            return {
+                success: false,
+                error: `Invalid agent configuration:\n${messages}`
+            };
+        }
+        return {
+            success: false,
+            error: `Unknown validation error: ${error}`
+        };
+    }
+}
+export { AgentConfigSchema, AvailableToolNames, WingmanDirectory, validateAgentConfig };