@wingman-ai/gateway 0.1.4 → 0.2.0

package/.wingman/agents/README.md

@@ -23,6 +23,10 @@ Each agent configuration file follows this schema:
   "systemPrompt": "Detailed instructions for the agent...",
   "tools": ["tool1", "tool2"],
   "model": "provider:model-name",
+  "promptRefinement": {
+    "enabled": true,
+    "instructionsPath": "/memories/agents/agent-name/instructions.md"
+  },
   "subagents": [
     {
       "name": "subagent-1",
@@ -48,6 +52,9 @@ Each agent configuration file follows this schema:
 - **model**: Override the default model (format: `provider:model-name`)
   - Anthropic: `anthropic:claude-opus-4-5`, `anthropic:claude-sonnet-4-5-20250929`
   - OpenAI: `openai:gpt-4o`, `openai:gpt-4-turbo`
+- **promptRefinement**: Allow the agent to maintain a durable prompt overlay under `/memories/`
+  - `enabled`: Set true to allow updates from explicit user feedback
+  - `instructionsPath`: Optional override for the overlay file location (virtual path)
 - **subagents**: Array of subagent configurations (see [Hierarchical Agents](#hierarchical-agents) below)
   - Subagents may also set their own `model` to override the parent/default model
 

package/.wingman/agents/coding/agent.md

@@ -7,6 +7,7 @@ tools:
   - command_execute
   - git_status
 model: openai:gpt-5.2-codex
+promptRefinement: true
 subAgents:
   - name: researcher
     description: Research subagent

package/.wingman/agents/main/agent.md

@@ -7,6 +7,7 @@ tools:
   - web_crawler
   - command_execute
 model: openai:gpt-5-mini
+promptRefinement: true
 ---
 
 You are the primary Wingman agent. Handle a wide range of coding, research, and reasoning tasks directly.

package/.wingman/agents/researcher/agent.md

@@ -4,6 +4,7 @@ description: A general-purpose internet researcher for topics, documentation, an
 tools:
   - internet_search
   - web_crawler
+promptRefinement: true
 ---
 
 You are a general-purpose research agent for Wingman. Your job is to find, verify, and summarize information from the public web for any topic, including software documentation and APIs used by the coding agent.

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

@@ -6,6 +6,7 @@ tools:
   - web_crawler
 model: xai:grok-4-1-fast-reasoning
 mcpUseGlobal: true
+promptRefinement: true
 subAgents:
   - name: goal-translator
     description: "Translates goal + deadline into an aggressiveness profile with feasibility notes."
@@ -69,6 +70,9 @@ Top rules:
 - If data is stale or incomplete, I prefer NO TRADE and explain why.
 - I separate FACTS (tool outputs) from INFERENCES (reasoning) inside the Decision Packet.
 - Do not dump raw tool output, internal file paths, or tool call IDs in the response; summarize only what is relevant.
+- Use exact section headers shown below (no variants like "No-Trade Live Reason"). Omit any section that is not applicable.
+- Keep it readable: limit each section to 1-3 bullets; Facts/Inferences to max 5 bullets each.
+- Use plain-English explanations for any "no trade" or veto; avoid jargon-heavy phrases.
 
 Primary data sources:
 - Finnhub MCP tools for quotes, candles, fundamentals, earnings, news, peers, and option chains.
@@ -199,7 +203,7 @@ Orders to Place:
 - (only if user explicitly requested live-trade instructions)
 
 No-Trade Reason:
-- (only when applicable)
+- (only when applicable; one plain-English sentence)
 
 Assumptions:
 - ...
@@ -222,7 +226,9 @@ Style:
 - First line must be the Goal Acknowledgement.
 - Second line must be Direct Answer in plain language (1-3 sentences).
 - Keep decisions concise; no fluff.
-- If no trade, still return a complete Decision Packet with reason.
+- Avoid long lists, raw arrays, or full tool outputs. Summarize the top signals only.
+- If no trade, include No-Trade Reason and keep the rest concise.
+- Concise, actionable trades for the user to make, if any.
 
 Daily brief mode:
 - If prompt is minimal/blank, produce a Decision Packet with no trades and a short market regime assessment.

package/dist/agent/config/agentConfig.cjs

@@ -45,6 +45,16 @@ const AvailableToolNames = external_zod_namespaceObject.z["enum"]([
     "ui_registry_get",
     "ui_present"
 ]);
+const PromptRefinementSchema = external_zod_namespaceObject.z.preprocess((value)=>{
+    if (void 0 === value) return;
+    if ("boolean" == typeof value) return {
+        enabled: value
+    };
+    return value;
+}, external_zod_namespaceObject.z.object({
+    enabled: external_zod_namespaceObject.z.boolean().optional().default(true).describe("Whether prompt refinement is enabled for this agent"),
+    instructionsPath: external_zod_namespaceObject.z.string().min(1).optional().describe("Path (virtual) to store the agent's prompt refinement overlay (defaults under /memories/)")
+}).strict());
 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)"),
@@ -57,7 +67,8 @@ const BaseAgentConfigSchema = external_zod_namespaceObject.z.object({
     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")
+    voice: voice_cjs_namespaceObject.AgentVoiceConfigSchema.optional().describe("Agent-specific voice configuration"),
+    promptRefinement: PromptRefinementSchema.optional().describe("Optional per-agent prompt refinement settings")
 });
 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)")

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

@@ -15,6 +15,11 @@ export declare const AvailableToolNames: z.ZodEnum<{
     ui_present: "ui_present";
 }>;
 export type AvailableToolName = z.infer<typeof AvailableToolNames>;
+declare const PromptRefinementSchema: z.ZodPipe<z.ZodTransform<{} | null | undefined, unknown>, z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    instructionsPath: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>>;
+export type PromptRefinementConfig = z.infer<typeof PromptRefinementSchema>;
 export declare const AgentConfigSchema: z.ZodObject<{
     name: z.ZodString;
     description: z.ZodString;
@@ -98,6 +103,10 @@ export declare const AgentConfigSchema: z.ZodObject<{
             optimizeStreamingLatency: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
+    promptRefinement: z.ZodOptional<z.ZodPipe<z.ZodTransform<{} | null | undefined, unknown>, z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        instructionsPath: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
     subAgents: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         description: z.ZodString;
@@ -181,6 +190,10 @@ export declare const AgentConfigSchema: z.ZodObject<{
                 optimizeStreamingLatency: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
+        promptRefinement: z.ZodOptional<z.ZodPipe<z.ZodTransform<{} | null | undefined, unknown>, z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            instructionsPath: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type WingmanAgentConfig = z.infer<typeof AgentConfigSchema>;
@@ -194,3 +207,4 @@ export declare function validateAgentConfig(config: unknown): {
     success: false;
     error: string;
 };
+export {};

package/dist/agent/config/agentConfig.js

@@ -14,6 +14,16 @@ const AvailableToolNames = z["enum"]([
     "ui_registry_get",
     "ui_present"
 ]);
+const PromptRefinementSchema = z.preprocess((value)=>{
+    if (void 0 === value) return;
+    if ("boolean" == typeof value) return {
+        enabled: value
+    };
+    return value;
+}, z.object({
+    enabled: z.boolean().optional().default(true).describe("Whether prompt refinement is enabled for this agent"),
+    instructionsPath: z.string().min(1).optional().describe("Path (virtual) to store the agent's prompt refinement overlay (defaults under /memories/)")
+}).strict());
 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)"),
@@ -26,7 +36,8 @@ const BaseAgentConfigSchema = z.object({
     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")
+    voice: AgentVoiceConfigSchema.optional().describe("Agent-specific voice configuration"),
+    promptRefinement: PromptRefinementSchema.optional().describe("Optional per-agent prompt refinement settings")
 });
 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)")

package/dist/agent/config/agentLoader.cjs

@@ -44,6 +44,31 @@ function _define_property(obj, key, value) {
     return obj;
 }
 const logger = (0, external_logger_cjs_namespaceObject.createLogger)();
+const PROMPT_REFINEMENT_MARKER = "[[wingman:prompt-refinement]]";
+const normalizePromptRefinementPath = (agentName, rawPath)=>{
+    const fallback = `/memories/agents/${agentName}/instructions.md`;
+    if (!rawPath) return fallback;
+    const trimmed = rawPath.trim();
+    if (!trimmed) return fallback;
+    if (trimmed.startsWith("/memories/")) return trimmed;
+    if (trimmed.startsWith("/")) return `/memories${trimmed}`;
+    return `/memories/${trimmed.replace(/^\/+/, "")}`;
+};
+const buildPromptRefinementInstructions = (instructionsPath)=>[
+        PROMPT_REFINEMENT_MARKER,
+        "Prompt Refinement:",
+        `- Maintain a durable overlay at ${instructionsPath} for stable preferences and corrections.`,
+        "- Read it at the start of each session and follow it in addition to this system prompt.",
+        '- Only update it when the user gives explicit, lasting feedback (e.g., "always", "never", "prefer").',
+        "- Keep entries short, stable, and avoid task-specific details.",
+        "- If the file doesn't exist, create it with a short header and bullet list."
+    ].join("\n");
+const applyPromptRefinement = (systemPrompt, agentName, config)=>{
+    if (!config?.enabled) return systemPrompt;
+    if (systemPrompt.includes(PROMPT_REFINEMENT_MARKER)) return systemPrompt;
+    const instructionsPath = normalizePromptRefinementPath(agentName, config.instructionsPath);
+    return `${systemPrompt.trim()}\n\n${buildPromptRefinementInstructions(instructionsPath)}`;
+};
 class AgentLoader {
     resolveConfigPath(...segments) {
         const baseDir = (0, external_node_path_namespaceObject.isAbsolute)(this.configDir) ? this.configDir : (0, external_node_path_namespaceObject.join)(this.workspace, this.configDir);
@@ -180,6 +205,10 @@ class AgentLoader {
             description: config.description,
             systemPrompt: config.systemPrompt
         };
+        if (config.promptRefinement) {
+            agent.promptRefinement = config.promptRefinement;
+            agent.systemPrompt = applyPromptRefinement(agent.systemPrompt, config.name, config.promptRefinement);
+        }
         const dynamicUiEnabled = this.wingmanConfig?.gateway?.dynamicUiEnabled !== false;
         const skillsDirectory = this.wingmanConfig?.skills?.skillsDirectory || "skills";
         const buildToolOptions = (source)=>{
@@ -188,6 +217,7 @@ class AgentLoader {
             if (source.mcpUseGlobal && this.wingmanConfig?.mcp) mcpConfigs.push(this.wingmanConfig.mcp);
             return {
                 workspace: this.workspace,
+                executionWorkspace: this.executionWorkspace,
                 blockedCommands: source.blockedCommands,
                 allowScriptExecution: source.allowScriptExecution,
                 timeout: source.commandTimeout,
@@ -224,6 +254,10 @@ class AgentLoader {
                     description: subagent.description,
                     systemPrompt: subagent.systemPrompt
                 };
+                if (subagent.promptRefinement) {
+                    sub.promptRefinement = subagent.promptRefinement;
+                    sub.systemPrompt = applyPromptRefinement(sub.systemPrompt, subagent.name, subagent.promptRefinement);
+                }
                 if (subagent.tools && subagent.tools.length > 0) sub.tools = await (0, external_toolRegistry_cjs_namespaceObject.createTools)(subagent.tools, buildToolOptions(subagent));
                 const subUiTools = await (0, external_toolRegistry_cjs_namespaceObject.createTools)(external_toolRegistry_cjs_namespaceObject.UI_TOOL_NAMES, buildToolOptions(subagent));
                 if (subUiTools.length > 0) if (sub.tools && sub.tools.length > 0) {
@@ -246,13 +280,15 @@ class AgentLoader {
         }
         return agent;
     }
-    constructor(configDir = external_agentConfig_cjs_namespaceObject.WingmanDirectory, workspace = process.cwd(), wingmanConfig){
+    constructor(configDir = external_agentConfig_cjs_namespaceObject.WingmanDirectory, workspace = process.cwd(), wingmanConfig, executionWorkspace = workspace){
         _define_property(this, "configDir", void 0);
         _define_property(this, "workspace", void 0);
         _define_property(this, "wingmanConfig", void 0);
+        _define_property(this, "executionWorkspace", void 0);
         this.configDir = configDir;
         this.workspace = workspace;
         this.wingmanConfig = wingmanConfig;
+        this.executionWorkspace = executionWorkspace;
     }
 }
 exports.AgentLoader = __webpack_exports__.AgentLoader;

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

@@ -8,7 +8,8 @@ export declare class AgentLoader {
     private configDir;
     private workspace;
     private wingmanConfig?;
-    constructor(configDir?: string, workspace?: string, wingmanConfig?: WingmanConfigType | undefined);
+    private executionWorkspace;
+    constructor(configDir?: string, workspace?: string, wingmanConfig?: WingmanConfigType | undefined, executionWorkspace?: string);
     private resolveConfigPath;
     loadAllAgentConfigs(): WingmanAgentConfig[];
     /**

package/dist/agent/config/agentLoader.js

@@ -16,6 +16,31 @@ function _define_property(obj, key, value) {
     return obj;
 }
 const logger = createLogger();
+const PROMPT_REFINEMENT_MARKER = "[[wingman:prompt-refinement]]";
+const normalizePromptRefinementPath = (agentName, rawPath)=>{
+    const fallback = `/memories/agents/${agentName}/instructions.md`;
+    if (!rawPath) return fallback;
+    const trimmed = rawPath.trim();
+    if (!trimmed) return fallback;
+    if (trimmed.startsWith("/memories/")) return trimmed;
+    if (trimmed.startsWith("/")) return `/memories${trimmed}`;
+    return `/memories/${trimmed.replace(/^\/+/, "")}`;
+};
+const buildPromptRefinementInstructions = (instructionsPath)=>[
+        PROMPT_REFINEMENT_MARKER,
+        "Prompt Refinement:",
+        `- Maintain a durable overlay at ${instructionsPath} for stable preferences and corrections.`,
+        "- Read it at the start of each session and follow it in addition to this system prompt.",
+        '- Only update it when the user gives explicit, lasting feedback (e.g., "always", "never", "prefer").',
+        "- Keep entries short, stable, and avoid task-specific details.",
+        "- If the file doesn't exist, create it with a short header and bullet list."
+    ].join("\n");
+const applyPromptRefinement = (systemPrompt, agentName, config)=>{
+    if (!config?.enabled) return systemPrompt;
+    if (systemPrompt.includes(PROMPT_REFINEMENT_MARKER)) return systemPrompt;
+    const instructionsPath = normalizePromptRefinementPath(agentName, config.instructionsPath);
+    return `${systemPrompt.trim()}\n\n${buildPromptRefinementInstructions(instructionsPath)}`;
+};
 class AgentLoader {
     resolveConfigPath(...segments) {
         const baseDir = isAbsolute(this.configDir) ? this.configDir : join(this.workspace, this.configDir);
@@ -152,6 +177,10 @@ class AgentLoader {
             description: config.description,
             systemPrompt: config.systemPrompt
         };
+        if (config.promptRefinement) {
+            agent.promptRefinement = config.promptRefinement;
+            agent.systemPrompt = applyPromptRefinement(agent.systemPrompt, config.name, config.promptRefinement);
+        }
         const dynamicUiEnabled = this.wingmanConfig?.gateway?.dynamicUiEnabled !== false;
         const skillsDirectory = this.wingmanConfig?.skills?.skillsDirectory || "skills";
         const buildToolOptions = (source)=>{
@@ -160,6 +189,7 @@ class AgentLoader {
             if (source.mcpUseGlobal && this.wingmanConfig?.mcp) mcpConfigs.push(this.wingmanConfig.mcp);
             return {
                 workspace: this.workspace,
+                executionWorkspace: this.executionWorkspace,
                 blockedCommands: source.blockedCommands,
                 allowScriptExecution: source.allowScriptExecution,
                 timeout: source.commandTimeout,
@@ -196,6 +226,10 @@ class AgentLoader {
                     description: subagent.description,
                     systemPrompt: subagent.systemPrompt
                 };
+                if (subagent.promptRefinement) {
+                    sub.promptRefinement = subagent.promptRefinement;
+                    sub.systemPrompt = applyPromptRefinement(sub.systemPrompt, subagent.name, subagent.promptRefinement);
+                }
                 if (subagent.tools && subagent.tools.length > 0) sub.tools = await createTools(subagent.tools, buildToolOptions(subagent));
                 const subUiTools = await createTools(UI_TOOL_NAMES, buildToolOptions(subagent));
                 if (subUiTools.length > 0) if (sub.tools && sub.tools.length > 0) {
@@ -218,13 +252,15 @@ class AgentLoader {
         }
         return agent;
     }
-    constructor(configDir = WingmanDirectory, workspace = process.cwd(), wingmanConfig){
+    constructor(configDir = WingmanDirectory, workspace = process.cwd(), wingmanConfig, executionWorkspace = workspace){
         _define_property(this, "configDir", void 0);
         _define_property(this, "workspace", void 0);
         _define_property(this, "wingmanConfig", void 0);
+        _define_property(this, "executionWorkspace", void 0);
         this.configDir = configDir;
         this.workspace = workspace;
         this.wingmanConfig = wingmanConfig;
+        this.executionWorkspace = executionWorkspace;
     }
 }
 export { AgentLoader };

package/dist/agent/config/modelFactory.cjs

@@ -103,7 +103,8 @@ class ModelFactory {
         const token = (0, credentials_cjs_namespaceObject.resolveProviderToken)("openai").token;
         const params = {
             model,
-            temperature: 1
+            temperature: 1,
+            useResponsesApi: true
         };
         if (token) params.apiKey = token;
         return new openai_namespaceObject.ChatOpenAI(params);

package/dist/agent/config/modelFactory.js

@@ -75,7 +75,8 @@ class ModelFactory {
         const token = resolveProviderToken("openai").token;
         const params = {
             model,
-            temperature: 1
+            temperature: 1,
+            useResponsesApi: true
         };
         if (token) params.apiKey = token;
         return new ChatOpenAI(params);

package/dist/agent/config/toolRegistry.cjs

@@ -45,12 +45,14 @@ const UI_TOOL_NAMES = [
     "ui_present"
 ];
 function createTool(name, options = {}) {
-    const { workspace = process.cwd(), blockedCommands, allowScriptExecution = true, timeout = 300000, searchConfig = {
+    const { workspace = process.cwd(), executionWorkspace, blockedCommands, allowScriptExecution = true, timeout = 300000, searchConfig = {
         provider: "duckduckgo",
         maxResults: 5
     }, skillsDirectory = "skills", dynamicUiEnabled = true } = options;
+    const runtimeWorkspace = executionWorkspace || workspace;
     logger.debug(`Creating tool: ${name}`, {
         workspace,
+        executionWorkspace: runtimeWorkspace,
         blockedCommands,
         allowScriptExecution,
         timeout,
@@ -62,13 +64,13 @@ function createTool(name, options = {}) {
         case "web_crawler":
             return web_crawler_cjs_namespaceObject.webCrawler;
         case "command_execute":
-            return (0, command_execute_cjs_namespaceObject.createCommandExecuteTool)(workspace, process.env, blockedCommands, allowScriptExecution, timeout);
+            return (0, command_execute_cjs_namespaceObject.createCommandExecuteTool)(runtimeWorkspace, process.env, blockedCommands, allowScriptExecution, timeout);
         case "think":
             return (0, think_cjs_namespaceObject.createThinkingTool)();
         case "code_search":
-            return (0, code_search_cjs_namespaceObject.createCodeSearchTool)(workspace);
+            return (0, code_search_cjs_namespaceObject.createCodeSearchTool)(runtimeWorkspace);
         case "git_status":
-            return (0, git_status_cjs_namespaceObject.createGitStatusTool)(workspace);
+            return (0, git_status_cjs_namespaceObject.createGitStatusTool)(runtimeWorkspace);
         case "ui_registry_list":
             return (0, ui_registry_cjs_namespaceObject.createUiRegistryListTool)(workspace, skillsDirectory);
         case "ui_registry_get":

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

@@ -4,6 +4,7 @@ import type { SearchConfig } from "../../cli/config/schema.js";
 import type { MCPServersConfig } from "@/types/mcp.js";
 export interface ToolOptions {
     workspace?: string;
+    executionWorkspace?: string;
     blockedCommands?: string[];
     allowScriptExecution?: boolean;
     timeout?: number;

package/dist/agent/config/toolRegistry.js

@@ -14,12 +14,14 @@ const UI_TOOL_NAMES = [
     "ui_present"
 ];
 function createTool(name, options = {}) {
-    const { workspace = process.cwd(), blockedCommands, allowScriptExecution = true, timeout = 300000, searchConfig = {
+    const { workspace = process.cwd(), executionWorkspace, blockedCommands, allowScriptExecution = true, timeout = 300000, searchConfig = {
         provider: "duckduckgo",
         maxResults: 5
     }, skillsDirectory = "skills", dynamicUiEnabled = true } = options;
+    const runtimeWorkspace = executionWorkspace || workspace;
     logger.debug(`Creating tool: ${name}`, {
         workspace,
+        executionWorkspace: runtimeWorkspace,
         blockedCommands,
         allowScriptExecution,
         timeout,
@@ -31,13 +33,13 @@ function createTool(name, options = {}) {
         case "web_crawler":
             return webCrawler;
         case "command_execute":
-            return createCommandExecuteTool(workspace, process.env, blockedCommands, allowScriptExecution, timeout);
+            return createCommandExecuteTool(runtimeWorkspace, process.env, blockedCommands, allowScriptExecution, timeout);
         case "think":
             return createThinkingTool();
         case "code_search":
-            return createCodeSearchTool(workspace);
+            return createCodeSearchTool(runtimeWorkspace);
         case "git_status":
-            return createGitStatusTool(workspace);
+            return createGitStatusTool(runtimeWorkspace);
         case "ui_registry_list":
             return createUiRegistryListTool(workspace, skillsDirectory);
         case "ui_registry_get":

package/dist/agent/middleware/additional-messages.cjs

@@ -44,13 +44,18 @@ const buildOutputLocationMessage = (context)=>{
     if (!targetPath) return null;
     const locationLabel = context.workdir ? "session output directory" : "default output directory";
     const safePath = toSafeRelativePath(context.workspaceRoot, targetPath);
-    const locationLine = safePath ? `- Use the ${locationLabel}: ${safePath}` : `- Use the ${locationLabel} (path hidden).`;
+    const virtualPath = context.outputVirtualPath?.trim();
+    const locationLine = safePath ? `- Use the ${locationLabel}: ${safePath}` : virtualPath ? `- Use the ${locationLabel}: ${virtualPath}` : `- Use the ${locationLabel} (path hidden).`;
     return [
         "** Output Location **",
         locationLine,
         "- If the user asks for a location, provide a relative path and avoid absolute paths or usernames."
     ].join("\n");
 };
+const buildWorkingDirectoryMessage = (context)=>{
+    if (!context.workspaceRoot) return null;
+    return "** Working Directory **\n- Treat `./` as the current working directory for file and tool operations in this session.\n- Use relative paths such as `./test.md`; do not prepend the working directory absolute path.";
+};
 const additionalMessageMiddleware = (context = {})=>({
         name: "additional-message-middleware",
         [external_langchain_namespaceObject.MIDDLEWARE_BRAND]: true,
@@ -63,6 +68,8 @@ const additionalMessageMiddleware = (context = {})=>({
             ];
             const outputLocation = buildOutputLocationMessage(context);
             if (outputLocation) lines.push(outputLocation);
+            const workingDirectory = buildWorkingDirectoryMessage(context);
+            if (workingDirectory) lines.push(workingDirectory);
             lines.push("** Long-term memory **\n- Use /memories/ for durable notes across threads.\n- Store stable preferences, project context, decisions, and research notes.\n- Avoid transient logs; keep entries concise and organized.\n- Suggested paths: /memories/preferences.md, /memories/projects/<name>/context.md, /memories/projects/<name>/decisions.md");
             if (false === context.dynamicUiEnabled) lines.push("** Dynamic UI **\n- Dynamic UI rendering is disabled for this gateway.\n- Respond with plain text and avoid calling UI presentation tools.");
             else {

package/dist/agent/middleware/additional-messages.d.ts

@@ -3,6 +3,7 @@ type AdditionalMessageContext = {
     workspaceRoot?: string | null;
     workdir?: string | null;
     defaultOutputDir?: string | null;
+    outputVirtualPath?: string | null;
     dynamicUiEnabled?: boolean;
     skillsDirectory?: string;
 };

package/dist/agent/middleware/additional-messages.js

@@ -16,13 +16,18 @@ const buildOutputLocationMessage = (context)=>{
     if (!targetPath) return null;
     const locationLabel = context.workdir ? "session output directory" : "default output directory";
     const safePath = toSafeRelativePath(context.workspaceRoot, targetPath);
-    const locationLine = safePath ? `- Use the ${locationLabel}: ${safePath}` : `- Use the ${locationLabel} (path hidden).`;
+    const virtualPath = context.outputVirtualPath?.trim();
+    const locationLine = safePath ? `- Use the ${locationLabel}: ${safePath}` : virtualPath ? `- Use the ${locationLabel}: ${virtualPath}` : `- Use the ${locationLabel} (path hidden).`;
     return [
         "** Output Location **",
         locationLine,
         "- If the user asks for a location, provide a relative path and avoid absolute paths or usernames."
     ].join("\n");
 };
+const buildWorkingDirectoryMessage = (context)=>{
+    if (!context.workspaceRoot) return null;
+    return "** Working Directory **\n- Treat `./` as the current working directory for file and tool operations in this session.\n- Use relative paths such as `./test.md`; do not prepend the working directory absolute path.";
+};
 const additionalMessageMiddleware = (context = {})=>({
         name: "additional-message-middleware",
         [MIDDLEWARE_BRAND]: true,
@@ -35,6 +40,8 @@ const additionalMessageMiddleware = (context = {})=>({
             ];
             const outputLocation = buildOutputLocationMessage(context);
             if (outputLocation) lines.push(outputLocation);
+            const workingDirectory = buildWorkingDirectoryMessage(context);
+            if (workingDirectory) lines.push(workingDirectory);
             lines.push("** Long-term memory **\n- Use /memories/ for durable notes across threads.\n- Store stable preferences, project context, decisions, and research notes.\n- Avoid transient logs; keep entries concise and organized.\n- Suggested paths: /memories/preferences.md, /memories/projects/<name>/context.md, /memories/projects/<name>/decisions.md");
             if (false === context.dynamicUiEnabled) lines.push("** Dynamic UI **\n- Dynamic UI rendering is disabled for this gateway.\n- Respond with plain text and avoid calling UI presentation tools.");
             else {

package/dist/agent/tests/agentConfig.test.cjs

@@ -102,6 +102,31 @@ const agentConfig_cjs_namespaceObject = require("../config/agentConfig.cjs");
             (0, external_vitest_namespaceObject.expect)(parsed.allowScriptExecution).toBe(true);
             (0, external_vitest_namespaceObject.expect)(parsed.commandTimeout).toBe(300000);
         });
+        (0, external_vitest_namespaceObject.it)("should accept prompt refinement configuration", ()=>{
+            const config = {
+                name: "refiner",
+                description: "Refines its prompt",
+                systemPrompt: "You are a refiner",
+                promptRefinement: true
+            };
+            const result = (0, agentConfig_cjs_namespaceObject.validateAgentConfig)(config);
+            (0, external_vitest_namespaceObject.expect)(result.success).toBe(true);
+            if (result.success) (0, external_vitest_namespaceObject.expect)(result.data.promptRefinement?.enabled).toBe(true);
+            const configWithPath = {
+                name: "refiner-2",
+                description: "Refines its prompt with path",
+                systemPrompt: "You are a refiner",
+                promptRefinement: {
+                    instructionsPath: "/memories/agents/refiner-2/instructions.md"
+                }
+            };
+            const resultWithPath = (0, agentConfig_cjs_namespaceObject.validateAgentConfig)(configWithPath);
+            (0, external_vitest_namespaceObject.expect)(resultWithPath.success).toBe(true);
+            if (resultWithPath.success) {
+                (0, external_vitest_namespaceObject.expect)(resultWithPath.data.promptRefinement?.instructionsPath).toBe("/memories/agents/refiner-2/instructions.md");
+                (0, external_vitest_namespaceObject.expect)(resultWithPath.data.promptRefinement?.enabled).toBe(true);
+            }
+        });
     });
     (0, external_vitest_namespaceObject.describe)("Tool names enum", ()=>{
         (0, external_vitest_namespaceObject.it)("should accept all valid tool names", ()=>{

package/dist/agent/tests/agentConfig.test.js

@@ -100,6 +100,31 @@ describe("Agent Configuration Schema", ()=>{
             expect(parsed.allowScriptExecution).toBe(true);
             expect(parsed.commandTimeout).toBe(300000);
         });
+        it("should accept prompt refinement configuration", ()=>{
+            const config = {
+                name: "refiner",
+                description: "Refines its prompt",
+                systemPrompt: "You are a refiner",
+                promptRefinement: true
+            };
+            const result = validateAgentConfig(config);
+            expect(result.success).toBe(true);
+            if (result.success) expect(result.data.promptRefinement?.enabled).toBe(true);
+            const configWithPath = {
+                name: "refiner-2",
+                description: "Refines its prompt with path",
+                systemPrompt: "You are a refiner",
+                promptRefinement: {
+                    instructionsPath: "/memories/agents/refiner-2/instructions.md"
+                }
+            };
+            const resultWithPath = validateAgentConfig(configWithPath);
+            expect(resultWithPath.success).toBe(true);
+            if (resultWithPath.success) {
+                expect(resultWithPath.data.promptRefinement?.instructionsPath).toBe("/memories/agents/refiner-2/instructions.md");
+                expect(resultWithPath.data.promptRefinement?.enabled).toBe(true);
+            }
+        });
     });
     describe("Tool names enum", ()=>{
         it("should accept all valid tool names", ()=>{

package/dist/agent/tests/agentLoader.test.cjs

@@ -227,6 +227,24 @@ Markdown agent`;
             (0, external_vitest_namespaceObject.expect)(Array.isArray(sub.tools)).toBe(true);
             (0, external_vitest_namespaceObject.expect)(sub.tools?.[0]).toHaveProperty("name", "think");
         });
+        (0, external_vitest_namespaceObject.it)("should append prompt refinement instructions when enabled", async ()=>{
+            const agentDir = (0, external_node_path_namespaceObject.join)(TEST_CONFIG_DIR, "agents", "refiner-agent");
+            (0, external_node_fs_namespaceObject.mkdirSync)(agentDir, {
+                recursive: true
+            });
+            const config = {
+                name: "refiner-agent",
+                description: "Agent that refines its prompt",
+                systemPrompt: "You are a refiner agent",
+                promptRefinement: true
+            };
+            (0, external_node_fs_namespaceObject.writeFileSync)((0, external_node_path_namespaceObject.join)(agentDir, "agent.json"), JSON.stringify(config));
+            const loader = new agentLoader_cjs_namespaceObject.AgentLoader(TEST_CONFIG_DIR);
+            const agent = await loader.loadAgent("refiner-agent");
+            (0, external_vitest_namespaceObject.expect)(agent).toBeDefined();
+            (0, external_vitest_namespaceObject.expect)(agent?.systemPrompt).toContain("[[wingman:prompt-refinement]]");
+            (0, external_vitest_namespaceObject.expect)(agent?.systemPrompt).toContain("/memories/agents/refiner-agent/instructions.md");
+        });
     });
 });
 for(var __rspack_i in __webpack_exports__)exports[__rspack_i] = __webpack_exports__[__rspack_i];

package/dist/agent/tests/agentLoader.test.js

@@ -225,5 +225,23 @@ Markdown agent`;
             expect(Array.isArray(sub.tools)).toBe(true);
             expect(sub.tools?.[0]).toHaveProperty("name", "think");
         });
+        it("should append prompt refinement instructions when enabled", async ()=>{
+            const agentDir = join(TEST_CONFIG_DIR, "agents", "refiner-agent");
+            mkdirSync(agentDir, {
+                recursive: true
+            });
+            const config = {
+                name: "refiner-agent",
+                description: "Agent that refines its prompt",
+                systemPrompt: "You are a refiner agent",
+                promptRefinement: true
+            };
+            writeFileSync(join(agentDir, "agent.json"), JSON.stringify(config));
+            const loader = new AgentLoader(TEST_CONFIG_DIR);
+            const agent = await loader.loadAgent("refiner-agent");
+            expect(agent).toBeDefined();
+            expect(agent?.systemPrompt).toContain("[[wingman:prompt-refinement]]");
+            expect(agent?.systemPrompt).toContain("/memories/agents/refiner-agent/instructions.md");
+        });
     });
 });