@jack200714/mafw 4.5.1

package/dist/hooks/voice-guide.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildVoiceGuide = buildVoiceGuide;
+exports.messageHasAudio = messageHasAudio;
+exports.voiceGuideMessagesHook = voiceGuideMessagesHook;
+exports.voiceGuideSystemHook = voiceGuideSystemHook;
+const media_ingest_1 = require("./media-ingest");
+/**
+ * voice-guide — 语音输入 → 引导主 Agent 以语音回复（调用 mafw_media_speak）。
+ *
+ * 场景：用户用语音消息（桌面录音 / 标准 opencode 粘贴音频）提问时，agent 看到的是
+ * 音频媒体指针或 audio file part，但没有任何提示告诉它"用户在用语音，请用语音回复"。
+ * 本 hook 在语音输入轮给 system 上下文注入 <voice-guide> 引导，稳定 agent 决策。
+ *
+ * 实现：
+ *  - voiceGuideMessagesHook（experimental.chat.messages.transform）：
+ *    检测当前轮 user 消息是否含音频 → 会话级状态置位；纯文本消息清除。
+ *  - voiceGuideSystemHook（experimental.chat.system.transform）：
+ *    状态命中 → output.system.push 引导块（memory-guide 同款注入路径）。
+ *  - 时序容错：messages/system transform 顺序无保证，状态延迟一轮也持续注入
+ *    （引导对该会话后续轮次仍有效，直到出现纯文本消息）。
+ */
+const AUDIO_EXT_RE = /\.(wav|mp3|m4a|ogg|flac|opus|aac|wma)(\s*[)\]），]|$)/i;
+/** 会话级语音输入状态：sessionID → 最近语音输入时间戳（ms）。 */
+const voiceSessionMap = new Map();
+/** 语音引导状态有效期（ms）：状态存活期间 system 注入持续生效。 */
+const VOICE_STATE_TTL_MS = 10 * 60 * 1000;
+const GUIDE_HEADER = '<voice-guide>';
+const GUIDE_FOOTER = '</voice-guide>';
+const GUIDE_BODY = `## 语音对话
+用户正在通过语音消息与你对话（语音输入）。媒体附件中的音频就是用户发给你的消息内容：
+调用 mafw_media_ask 工具获取其内容后，把它当作用户的直接输入来回应（就像用户打字给你一样），
+不要在回复中复述/重复语音内容（除非用户明确要求）。
+同时请以语音形式回复：调用 mafw_media_speak 工具（text=你的回复内容，voice 可按需选择），
+并把返回的 [语音回复 art:...] 标记原样包含在回复文本中。`;
+function buildVoiceGuide() {
+    return `${GUIDE_HEADER}\n${GUIDE_BODY}\n${GUIDE_FOOTER}`;
+}
+/** 判断 user 消息是否含音频媒体（media part mime audio/* 或音频指针/文件名）。 */
+function messageHasAudio(msg) {
+    const parts = Array.isArray(msg?.parts) ? msg.parts : [];
+    for (const part of parts) {
+        const mime = part?.mediaType || part?.mime || '';
+        if (typeof mime === 'string' && mime.startsWith('audio/'))
+            return true;
+        if ((0, media_ingest_1.isMediaPointerPart)(part)) {
+            const text = part?.text || '';
+            const nameMatch = text.match(/媒体:\s*([^）\]]+)/);
+            const name = nameMatch ? nameMatch[1] : '';
+            if (AUDIO_EXT_RE.test(name))
+                return true;
+        }
+    }
+    return false;
+}
+/** messages.transform：更新会话语音输入状态。 */
+function voiceGuideMessagesHook(input, output) {
+    const messages = Array.isArray(output?.messages) ? output.messages : [];
+    let sessionID = input?.sessionID;
+    let hasVoice = false;
+    let hasText = false;
+    for (const msg of messages) {
+        if (msg?.role !== 'user' && msg?.info?.role !== 'user')
+            continue;
+        if (!sessionID)
+            sessionID = msg?.sessionID || msg?.info?.sessionID;
+        if (messageHasAudio(msg))
+            hasVoice = true;
+        const parts = Array.isArray(msg?.parts) ? msg.parts : [];
+        if (parts.some((p) => typeof p?.text === 'string' && !(0, media_ingest_1.isMediaPointerPart)(p)))
+            hasText = true;
+    }
+    if (!sessionID)
+        return output;
+    if (hasVoice) {
+        voiceSessionMap.set(sessionID, Date.now());
+    }
+    else if (hasText) {
+        voiceSessionMap.delete(sessionID);
+    }
+    return output;
+}
+/** system.transform：语音输入会话注入引导块。 */
+function voiceGuideSystemHook(input, output) {
+    const sessionID = input?.sessionID;
+    if (!sessionID)
+        return output;
+    const at = voiceSessionMap.get(sessionID);
+    if (at === undefined || Date.now() - at > VOICE_STATE_TTL_MS) {
+        if (at !== undefined)
+            voiceSessionMap.delete(sessionID);
+        return output;
+    }
+    if (!Array.isArray(output?.system))
+        output.system = [];
+    if (!output.system.some((s) => typeof s === 'string' && s.includes(GUIDE_HEADER))) {
+        output.system.push(buildVoiceGuide());
+    }
+    return output;
+}
+//# sourceMappingURL=voice-guide.js.map

package/dist/hooks/voice-guide.js.map

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

package/dist/plugin.d.ts

@@ -0,0 +1,55 @@
+export default function MafwPlugin({ directory }: {
+    directory: string;
+}): Promise<{
+    tool: {
+        mafw_media_ask: import("./tools/media-ask").MediaAskTool;
+        mafw_media_upload: import("./tools/media-upload").MediaUploadTool;
+        mafw_media_speak: import("./tools/media-speak").MediaSpeakTool;
+        mafw_python: import("./tools/python-exec").PythonExecTool;
+        mafw_python_restart: import("./tools/python-restart").PythonRestartTool;
+        mafw_add_memory: import("./tools/add-memory").AddMemoryTool;
+    };
+    'session.end': (ctx: any) => Promise<void>;
+    'tool.execute.before': (ctx: any) => Promise<void>;
+    'chat.message': (input: any, output: any) => Promise<any>;
+    'tool.execute.after': (input: any, output: any) => any;
+    'experimental.text.complete': (input: any, output: any) => any;
+    event: ({ event }: any) => void;
+    'experimental.chat.messages.transform': (input: any, output: any) => Promise<void>;
+    'experimental.chat.system.transform': (input: any, output: any) => Promise<any>;
+    command: {
+        goal: {
+            description: string;
+            execute(args: string, context: any): Promise<{
+                type: string;
+                goalId: any;
+                message: string;
+            } | undefined>;
+        };
+        status: {
+            description: string;
+            execute(args: string, context: any): Promise<{
+                text: string;
+            }>;
+        };
+        'merge-memory': {
+            description: string;
+            execute(args: string, context: any): Promise<{
+                text: string;
+            }>;
+        };
+        'new-topic': {
+            description: string;
+            execute(_args: string, _context: any): Promise<{
+                text: any;
+            }>;
+        };
+        btw: {
+            description: string;
+            execute(args: string, _context: any): Promise<{
+                text: any;
+            }>;
+        };
+    };
+}>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAoEA,wBAA8B,UAAU,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE;;;;;;;;;yBAiHpD,GAAG;iCACK,GAAG;4BAMF,GAAG,UAAU,GAAG;kCAQhB,GAAG,UAAU,GAAG;0CAOR,GAAG,UAAU,GAAG;uBAKnC,GAAG;oDASgC,GAAG,UAAU,GAAG;kDAMlB,GAAG,UAAU,GAAG;;;;0BAS5C,MAAM,WAAW,GAAG;;;;;;;;0BAYpB,MAAM,WAAW,GAAG;;;;;;0BAUpB,MAAM,WAAW,GAAG;;;;;;2BAiBnB,MAAM,YAAY,GAAG;;;;;;0BActB,MAAM,YAAY,GAAG;;;;;GAehD"}

package/dist/plugin.js

@@ -0,0 +1,342 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = MafwPlugin;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const session_ending_1 = require("./hooks/session-ending");
+const config_loader_1 = require("./utils/config-loader");
+const hook_manager_1 = require("./hooks/hook-manager");
+const session_start_1 = require("./hooks/session-start");
+const tool_before_1 = require("./hooks/tool-before");
+const user_prompt_1 = require("./hooks/user-prompt");
+const llm_after_1 = require("./hooks/llm-after");
+const session_compacting_1 = require("./hooks/session-compacting");
+const handoff_1 = require("./hooks/handoff");
+const session_recall_1 = require("./hooks/session-recall");
+const media_ingest_1 = require("./hooks/media-ingest");
+const bash_python_guide_1 = require("./hooks/bash-python-guide");
+const media_ask_1 = require("./tools/media-ask");
+const media_upload_1 = require("./tools/media-upload");
+const media_speak_1 = require("./tools/media-speak");
+const python_exec_1 = require("./tools/python-exec");
+const python_restart_1 = require("./tools/python-restart");
+const memory_guide_1 = require("./hooks/memory-guide");
+const user_profile_1 = require("./hooks/user-profile");
+const voice_guide_1 = require("./hooks/voice-guide");
+const obs_capture_1 = require("./utils/obs-capture");
+const add_memory_1 = require("./tools/add-memory");
+const self_wiring_1 = require("./utils/self-wiring");
+function getGatewayUrl(mafwDir) {
+    const configPath = path.join(mafwDir, '..', '.config', 'mafw', 'desktop-automation.json');
+    try {
+        if (fs.existsSync(configPath)) {
+            const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+            return `http://127.0.0.1:${config.port}`;
+        }
+    }
+    catch { }
+    const portFile = path.join(mafwDir, '.gateway-port');
+    try {
+        if (fs.existsSync(portFile)) {
+            return `http://127.0.0.1:${fs.readFileSync(portFile, 'utf-8').trim()}`;
+        }
+    }
+    catch { }
+    return 'http://127.0.0.1:2716';
+}
+async function ensureMafwDirectories(mafwDir) {
+    const dirs = [mafwDir, path.join(mafwDir, 'lessons'), path.join(mafwDir, 'parametric'),
+        path.join(mafwDir, 'cost'), path.join(mafwDir, 'reviews'), path.join(mafwDir, 'receipts'),
+        path.join(mafwDir, 'triage'), path.join(mafwDir, 'automations'), path.join(mafwDir, 'requests'),
+        path.join(mafwDir, 'reports'), path.join(mafwDir, 'goals'), path.join(mafwDir, 'handoffs'),
+        path.join(mafwDir, 'decisions'), path.join(mafwDir, 'memory'), path.join(mafwDir, 'events'),
+        path.join(mafwDir, 'state'), path.join(mafwDir, 'checkpoints'), path.join(mafwDir, 'tasks')];
+    for (const dir of dirs) {
+        if (!fs.existsSync(dir))
+            fs.mkdirSync(dir, { recursive: true });
+    }
+}
+async function registerWithGateway(directory, mafwDir) {
+    const gatewayUrl = getGatewayUrl(mafwDir);
+    for (let port = 3000; port <= 3010; port++) {
+        try {
+            const res = await fetch(`http://127.0.0.1:${port}/register`, {
+                method: 'POST', headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ projectDir: directory, mafwDir }),
+                signal: AbortSignal.timeout(2000),
+            });
+            if (res.ok)
+                return;
+        }
+        catch { }
+    }
+}
+async function MafwPlugin({ directory }) {
+    const mafwDir = path.join(directory, '.mafw');
+    await ensureMafwDirectories(mafwDir);
+    const { installFileLogging } = require('./utils/logger');
+    installFileLogging(path.join(mafwDir, 'logs'));
+    console.log(`[MAFW] File logging enabled: ${mafwDir}/logs/mafw.log`);
+    config_loader_1.ConfigLoader.getInstance(directory).getAll();
+    await registerWithGateway(directory, mafwDir);
+    // Self-wire gateway MCP into the global opencode config so mafw_* tools are
+    // mounted in every session (plugin config hook cannot inject mcp). Fail-open.
+    try {
+        const wiring = (0, self_wiring_1.ensureMcpWiring)((0, self_wiring_1.resolveGatewayApiUrl)());
+        if (wiring === 'wired') {
+            console.log('[MAFW] Self-wired mcp.mafw into global opencode config (restart sessions to load tools)');
+        }
+    }
+    catch { }
+    console.log('[MAFW] Plugin activated. All hooks registered.');
+    const hookManager = new hook_manager_1.HookManager({ failBehavior: 'continue', timeout: 30000 });
+    const gatewayUrl = getGatewayUrl(mafwDir);
+    hookManager.register({
+        name: 'session-start-handler', event: 'session.start',
+        handler: async (ctx) => { const data = ctx.data || ctx; (0, session_start_1.sessionStartHook)(data); },
+        priority: 100
+    });
+    hookManager.register({
+        name: 'session-end-handler', event: 'session.end',
+        handler: async (ctx) => { const data = ctx.data || ctx; (0, session_ending_1.sessionEndingHook)(data); },
+        priority: 100
+    });
+    hookManager.register({
+        name: 'tool-before-handler', event: 'tool.before',
+        handler: async (ctx) => { const data = ctx.data || ctx; await (0, tool_before_1.toolBeforeHook)(data); },
+        priority: 100
+    });
+    hookManager.register({
+        name: 'tool-executed-handler', event: 'tool.executed',
+        handler: async (ctx) => {
+            const data = ctx.data || ctx;
+            if (data?.sessionID) {
+            }
+        },
+        priority: 100
+    });
+    hookManager.register({
+        name: 'user-prompt-handler', event: 'user.prompt',
+        handler: async (ctx) => { const data = ctx.data || ctx; await (0, user_prompt_1.userPromptHook)(data); },
+        priority: 100
+    });
+    hookManager.register({
+        name: 'llm-after-handler', event: 'llm.after',
+        handler: async (ctx) => { const data = ctx.data || ctx; await (0, llm_after_1.llmAfterHook)(data); },
+        priority: 100
+    });
+    hookManager.register({
+        name: 'session-compacting-handler', event: 'session.compacting',
+        handler: async (ctx) => { const data = ctx.data || ctx; (0, session_compacting_1.sessionCompactingHook)(data); },
+        priority: 100
+    });
+    hookManager.register({
+        name: 'session-handoff-handler', event: 'session.handoff',
+        handler: async (ctx) => { const data = ctx.data || ctx; (0, handoff_1.handoffHook)(data); },
+        priority: 100
+    });
+    hookManager.register({
+        name: 'memory-recall-handler', event: 'memory.recall',
+        handler: async (ctx) => {
+            const { query, resultIds } = ctx.data || ctx;
+        },
+        priority: 100
+    });
+    hookManager.register({
+        name: 'memory-contradiction-handler', event: 'memory.contradiction',
+        handler: async (ctx) => {
+            const { existingId, newId, field } = ctx.data || ctx;
+        },
+        priority: 100
+    });
+    hookManager.register({
+        name: 'goal-state-change-handler', event: 'state_change',
+        handler: async (ctx) => {
+            const data = ctx.data || ctx;
+        },
+        priority: 100
+    });
+    hookManager.register({
+        name: 'goal-created-handler', event: 'goal_created',
+        handler: async (ctx) => {
+            const data = ctx.data || ctx;
+        },
+        priority: 100
+    });
+    hookManager.register({
+        name: 'user-feedback-handler', event: 'user_feedback',
+        handler: async (ctx) => {
+            const data = ctx.data || ctx;
+        },
+        priority: 100
+    });
+    return {
+        tool: {
+            mafw_media_ask: media_ask_1.mediaAskTool,
+            mafw_media_upload: media_upload_1.mediaUploadTool,
+            mafw_media_speak: media_speak_1.mediaSpeakTool,
+            mafw_python: python_exec_1.pythonExecTool,
+            mafw_python_restart: python_restart_1.pythonRestartTool,
+            mafw_add_memory: add_memory_1.addMemoryTool,
+        },
+        'session.end': (ctx) => hookManager.execute('session.end', ctx),
+        'tool.execute.before': (ctx) => hookManager.execute('tool.before', ctx),
+        // Observation capture (T1 store lives in the gateway):
+        //  - chat.message(input, output): user text lives in output.parts
+        //    (resolvedParts; the hook fires BEFORE the message is persisted, so
+        //    video/audio parts are converted to A2A text pointers here to avoid
+        //    writing large base64 into the session store)
+        'chat.message': async (input, output) => {
+            hookManager.execute('user.prompt', input);
+            const text = (0, obs_capture_1.extractTextFromParts)(output?.parts);
+            void (0, obs_capture_1.pushObservation)(input?.sessionID || '', 'user_input', text);
+            await (0, media_ingest_1.ingestLargeMediaBeforeStore)(output);
+            return output;
+        },
+        //  - tool.execute.after(input, output): tool/sessionID from input, result from output
+        'tool.execute.after': (input, output) => {
+            hookManager.execute('tool.executed', { ...input, data: output });
+            const result = [output?.title, output?.output].filter(Boolean).join('\n');
+            void (0, obs_capture_1.pushObservation)(input?.sessionID || '', 'tool_result', result);
+            return output;
+        },
+        //  - assistant reply text (text parts only; reasoning comes via event hook)
+        'experimental.text.complete': (input, output) => {
+            void (0, obs_capture_1.pushObservation)(input?.sessionID || '', 'assistant_reply', output?.text || '');
+            return output;
+        },
+        //  - thinking (reasoning.ended, full text) and tool failures (tool.failed)
+        event: ({ event }) => {
+            const type = event?.type;
+            const props = event?.properties || {};
+            if (type === 'session.next.reasoning.ended') {
+                void (0, obs_capture_1.pushObservation)(props?.sessionID || '', 'reasoning', props?.text || '');
+            }
+            else if (type === 'session.next.tool.failed') {
+                void (0, obs_capture_1.pushObservation)(props?.sessionID || '', 'tool_result', (0, obs_capture_1.toolFailureText)(props), true);
+            }
+        },
+        'experimental.chat.messages.transform': async (input, output) => {
+            await (0, media_ingest_1.mediaIngestHook)(input, output);
+            await (0, bash_python_guide_1.pythonGuideHook)(input, output);
+            await (0, session_recall_1.sessionRecallHook)(input, output);
+            (0, voice_guide_1.voiceGuideMessagesHook)(input, output);
+        },
+        'experimental.chat.system.transform': async (input, output) => {
+            (0, memory_guide_1.memoryGuideHook)(input, output);
+            await (0, user_profile_1.userProfileSystemHook)(input, output);
+            (0, voice_guide_1.voiceGuideSystemHook)(input, output);
+            return output;
+        },
+        command: {
+            goal: {
+                description: 'Submit a new Goal to MAFW',
+                async execute(args, context) {
+                    const result = await context.runSkill('mafw-goal', { text: args });
+                    if (result?.confirmed) {
+                        const requestsDir = path.join(mafwDir, 'requests');
+                        if (!fs.existsSync(requestsDir))
+                            fs.mkdirSync(requestsDir, { recursive: true });
+                        fs.writeFileSync(path.join(requestsDir, `${result.goalId}.json`), JSON.stringify(result, null, 2));
+                        return { type: 'goal_submitted', goalId: result.goalId, message: `✅ Goal "${result.title}" submitted` };
+                    }
+                }
+            },
+            status: {
+                description: 'Show MAFW dashboard status',
+                async execute(args, context) {
+                    try {
+                        const statusPath = path.join(mafwDir, 'STATUS.md');
+                        if (!fs.existsSync(statusPath))
+                            return { text: 'No active Goals. Use /goal to create one.' };
+                        return { text: fs.readFileSync(statusPath, 'utf-8') };
+                    }
+                    catch (err) {
+                        return { text: `Error: ${err.message}` };
+                    }
+                }
+            },
+            'merge-memory': {
+                description: 'Merge memories from another worktree via gateway',
+                async execute(args, context) {
+                    const parts = args.trim().split(/\s+/);
+                    const sourceWorktree = parts[0];
+                    if (!sourceWorktree)
+                        return { text: 'Usage: /merge-memory <sourceWorktreePath> [strategy]' };
+                    try {
+                        const res = await fetch(`${gatewayUrl}/api/merge-memory`, {
+                            method: 'POST', headers: { 'Content-Type': 'application/json' },
+                            body: JSON.stringify({ sourceWorktree, strategy: parts[1] || 'manual', mafwDir }),
+                            signal: AbortSignal.timeout(30000),
+                        });
+                        const result = await res.json();
+                        return { text: `Merge result: ${JSON.stringify(result)}` };
+                    }
+                    catch (err) {
+                        return { text: `Error: ${err.message}` };
+                    }
+                }
+            },
+            'new-topic': {
+                description: 'Start a new MAFW manager topic (archives the current session to history)',
+                async execute(_args, _context) {
+                    try {
+                        const res = await fetch(`${gatewayUrl}/api/mafw-commands/run`, {
+                            method: 'POST', headers: { 'Content-Type': 'application/json' },
+                            body: JSON.stringify({ command: 'new-topic' }),
+                            signal: AbortSignal.timeout(60000),
+                        });
+                        const result = await res.json();
+                        return { text: result.message || JSON.stringify(result) };
+                    }
+                    catch (err) {
+                        return { text: `Error: ${err.message}` };
+                    }
+                }
+            },
+            'btw': {
+                description: 'One-off side-question session: answer in a throwaway session, keep the main thread clean',
+                async execute(args, _context) {
+                    if (!args.trim())
+                        return { text: 'Usage: /btw <question>' };
+                    try {
+                        const res = await fetch(`${gatewayUrl}/api/mafw-commands/run`, {
+                            method: 'POST', headers: { 'Content-Type': 'application/json' },
+                            body: JSON.stringify({ command: 'btw', args }),
+                            signal: AbortSignal.timeout(180000),
+                        });
+                        const result = await res.json();
+                        return { text: result.text || result.message || JSON.stringify(result) };
+                    }
+                    catch (err) {
+                        return { text: `Error: ${err.message}` };
+                    }
+                }
+            },
+        },
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/tools/add-memory.d.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+export interface AddMemoryTool {
+    description: string;
+    args: Record<string, z.ZodTypeAny>;
+    execute: (args: {
+        content: string;
+        memoryType?: 'semantic' | 'episodic' | 'procedural' | 'global';
+        cueAnchors?: string[];
+        primaryAbstraction?: string;
+        importance?: number;
+    }, ctx: {
+        sessionID: string;
+        abort: AbortSignal;
+    }) => Promise<unknown>;
+}
+export declare const addMemoryTool: AddMemoryTool;
+//# sourceMappingURL=add-memory.d.ts.map

package/dist/tools/add-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-memory.d.ts","sourceRoot":"","sources":["../../src/tools/add-memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;IACnC,OAAO,EAAE,CACP,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,QAAQ,CAAC;QAC/D,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,EACD,GAAG,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,WAAW,CAAA;KAAE,KAC3C,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB;AAED,eAAO,MAAM,aAAa,EAAE,aA8C3B,CAAC"}

package/dist/tools/add-memory.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addMemoryTool = void 0;
+const zod_1 = require("zod");
+/**
+ * mafw_add_memory — save a memory unit to the harmonic memory system.
+ * Serve sessions (including pipeline worker sessions) have no MCP connection,
+ * so writes go over HTTP to the gateway's /api/memory/add (shared harmonic store).
+ */
+const GATEWAY_PORT = process.env.MAFW_SERVER_API_PORT || process.env.MAFW_GATEWAY_PORT || '3000';
+const ADD_URL = `http://127.0.0.1:${GATEWAY_PORT}/api/memory/add`;
+exports.addMemoryTool = {
+    description: '保存一条记忆到谐波记忆系统。用于需要跨会话存续的事实、决定、偏好、教训、模式与洞察。' +
+        '一次调用保存一条，memory_value 简洁，附 cueAnchors 关键词；按内容选择 memoryType（semantic=事实/偏好/约束，episodic=叙事，procedural=教训/模式，global=跨项目）。',
+    args: {
+        content: zod_1.z.string().describe('记忆内容（一句话）'),
+        memoryType: zod_1.z
+            .enum(['semantic', 'episodic', 'procedural', 'global'])
+            .optional()
+            .describe('semantic=事实/偏好/约束，episodic=叙事，procedural=教训/模式，global=跨项目'),
+        cueAnchors: zod_1.z.array(zod_1.z.string()).max(8).optional().describe('检索关键词'),
+        primaryAbstraction: zod_1.z.string().optional().describe('6-8 词摘要（缺省自动生成）'),
+        importance: zod_1.z.number().int().min(1).max(10).optional().describe('重要性打分 1-10：1=琐碎日常，5=普通事实，9-10=架构级决定/严重事故。缺省自动判定'),
+    },
+    async execute(args, ctx) {
+        try {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), 10000);
+            const res = await fetch(ADD_URL, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    content: args.content,
+                    memoryType: args.memoryType || 'semantic',
+                    cueAnchors: args.cueAnchors || [],
+                    primaryAbstraction: args.primaryAbstraction,
+                    importance: args.importance,
+                    sessionID: ctx?.sessionID,
+                }),
+                signal: controller.signal,
+            });
+            clearTimeout(timeout);
+            let body = {};
+            try {
+                body = await res.json();
+            }
+            catch {
+                /* ignore */
+            }
+            if (!res.ok || body?.success === false) {
+                return { title: '记忆写入失败', output: JSON.stringify(body), metadata: {} };
+            }
+            return { title: '记忆已保存', output: JSON.stringify({ success: true, id: body.id }), metadata: { memoryID: body.id } };
+        }
+        catch (err) {
+            return { title: '记忆写入失败', output: `gateway unreachable: ${err.message}`, metadata: {} };
+        }
+    },
+};
+//# sourceMappingURL=add-memory.js.map

package/dist/tools/add-memory.js.map

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

package/dist/tools/media-ask.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export interface MediaAskTool {
+    description: string;
+    args: Record<string, z.ZodTypeAny>;
+    execute: (args: {
+        taskID?: string;
+        mediaPath?: string;
+        question: string;
+    }, ctx: {
+        abort: AbortSignal;
+    }) => Promise<unknown>;
+}
+export declare const mediaAskTool: MediaAskTool;
+//# sourceMappingURL=media-ask.d.ts.map

package/dist/tools/media-ask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-ask.d.ts","sourceRoot":"","sources":["../../src/tools/media-ask.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0FxB,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;IACnC,OAAO,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,EAAE;QAAE,KAAK,EAAE,WAAW,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7H;AAED,eAAO,MAAM,YAAY,EAAE,YAwI1B,CAAC"}