mister-wolf 2.14.0 → 2.15.0

package/templates/opencode/plugins/wolf-router.ts

@@ -115,61 +115,119 @@ async function resolvePlaybook(agentId: string): Promise<{ id: string; body: str
   return found;
 }
 
-export const WolfPlaybookPlugin = async () => {
-  // 4.C: один WOLF_SESSION на процесс opencode — спавны волка и bash-вызовы
-  // наследуют ключ. Известный потолок: несколько чатов одного процесса
-  // opencode шарят ключ — консервативная недо-дедупликация.
+// B3: метрика вызовов скиллов. Форма входа v1: input.tool — имя тула,
+// output.args — объект аргументов; v2: event.tool + event.input (name | skill —
+// фолбэк). Отдельный JSONL-файл — инвариант: enum событий SignalEventSchema
+// закрытый, в общий router.log эти события класть нельзя. WOLF_SKILL_LOG —
+// тест-шов (читается на каждый вызов: env ставится тестами уже после импорта).
+function recordSkillMetric(tool: unknown, args: unknown): void {
+  try {
+    if (tool !== 'skill') return;
+    const a = (args ?? {}) as { name?: string; skill?: string } | null;
+    const skill = a?.name ?? a?.skill;
+    if (!skill) return;
+    const file =
+      process.env.WOLF_SKILL_LOG ?? path.join(PROJECT_ROOT, '.wolf', 'metrics', 'skill-invocations.jsonl');
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    const entry: { ts: string; skill: string; agent?: string } = { ts: new Date().toISOString(), skill };
+    if (lastAgentId) entry.agent = lastAgentId;
+    fs.appendFileSync(file, `${JSON.stringify(entry)}\n`);
+  } catch {
+    /* fail-safe: падение метрики не роняет сессию */
+  }
+}
+
+// Общая доставка playbook (v1 system.transform / v2 context): joined system-текст
+// → маркер agent-id → гвард идемпотентности INJECT_HEADER → resolvePlaybook →
+// push(текст). Fail-safe: не роняем сессию ни на одном шаге.
+async function deliverPlaybook(joined: string, push: (text: string) => void): Promise<void> {
+  try {
+    const m = joined.match(AGENT_ID_RE);
+    if (!m) return; // рамка без маркера — не наша забота
+    if (joined.includes(INJECT_HEADER)) return; // идемпотентность: не вставляем дважды
+    const agentId = m[1];
+    lastAgentId = agentId; // агент известен хуку skill-метрики (B3)
+    const startedAt = Date.now();
+    const resolved = await resolvePlaybook(agentId);
+    const ms = Date.now() - startedAt;
+    if (resolved) {
+      push(`\n\n${INJECT_HEADER}\n\n${resolved.body}`);
+      logRoute(
+        `agent-id=${agentId} playbook=hit name=${resolved.id} variant=canonical injected=yes` +
+          ` ms=${ms} bytes=${Buffer.byteLength(resolved.body)}`
+      );
+    } else {
+      // T012: miss канона → универсальный fallback; инъекция для любого agent-id
+      push(`\n\n${INJECT_HEADER}\n\n${FALLBACK_PLAYBOOK}`);
+      logRoute(
+        `agent-id=${agentId} playbook=hit name=fallback variant=fallback injected=yes` +
+          ` ms=${ms} bytes=${Buffer.byteLength(FALLBACK_PLAYBOOK)}`
+      );
+    }
+  } catch {
+    /* fail-safe: не роняем сессию */
+  }
+}
+
+// 4.C: один WOLF_SESSION на процесс opencode — спавны волка и bash-вызовы
+// наследуют ключ. Известный потолок: несколько чатов одного процесса opencode
+// шарят ключ — консервативная недо-дедупликация, не ошибка.
+function ensureSession(): void {
   if (!process.env.WOLF_SESSION) process.env.WOLF_SESSION = 'opc-' + randomUUID();
+}
+
+// v1-фабрика: loader v1 вызывает `server()` и получает hook-объект.
+async function server() {
+  ensureSession();
   return {
-    'experimental.chat.system.transform': async (_input, output) => {
-      try {
-        const joined = output.system.join('\n');
-        const m = joined.match(AGENT_ID_RE);
-        if (!m) return; // рамка без маркера — не наша забота
-        if (joined.includes(INJECT_HEADER)) return; // идемпотентность: не вставляем дважды
-        const agentId = m[1];
-        lastAgentId = agentId; // агент известен хуку skill-метрики (B3)
-        const startedAt = Date.now();
-        const resolved = await resolvePlaybook(agentId);
-        const ms = Date.now() - startedAt;
-        if (resolved) {
-          output.system.push(`\n\n${INJECT_HEADER}\n\n${resolved.body}`);
-          logRoute(
-            `agent-id=${agentId} playbook=hit name=${resolved.id} variant=canonical injected=yes` +
-              ` ms=${ms} bytes=${Buffer.byteLength(resolved.body)}`
-          );
-        } else {
-          // T012: miss канона → универсальный fallback; инъекция для любого agent-id
-          output.system.push(`\n\n${INJECT_HEADER}\n\n${FALLBACK_PLAYBOOK}`);
-          logRoute(
-            `agent-id=${agentId} playbook=hit name=fallback variant=fallback injected=yes` +
-              ` ms=${ms} bytes=${Buffer.byteLength(FALLBACK_PLAYBOOK)}`
-          );
-        }
-      } catch {
-        /* fail-safe: не роняем сессию */
-      }
+    'experimental.chat.system.transform': async (_input: unknown, output: { system: string[] }) => {
+      await deliverPlaybook((output?.system ?? []).join('\n'), (text) => output.system.push(text));
     },
-    // B3: метрика вызовов скиллов. Форма входа по докам opencode: input.tool —
-    // имя тула, output.args — объект аргументов (name | skill — фолбэк).
-    // Отдельный JSONL-файл — инвариант: enum событий SignalEventSchema закрытый,
-    // в общий router.log эти события класть нельзя. WOLF_SKILL_LOG — тест-шов
-    // (читается на каждый вызов: env ставится тестами уже после импорта модуля).
     'tool.execute.before': async (input: unknown, output: unknown) => {
-      try {
-        if ((input as { tool?: string } | null)?.tool !== 'skill') return;
-        const args = (output as { args?: { name?: string; skill?: string } } | null)?.args;
-        const skill = args?.name ?? args?.skill;
-        if (!skill) return;
-        const file =
-          process.env.WOLF_SKILL_LOG ?? path.join(PROJECT_ROOT, '.wolf', 'metrics', 'skill-invocations.jsonl');
-        fs.mkdirSync(path.dirname(file), { recursive: true });
-        const entry: { ts: string; skill: string; agent?: string } = { ts: new Date().toISOString(), skill };
-        if (lastAgentId) entry.agent = lastAgentId;
-        fs.appendFileSync(file, `${JSON.stringify(entry)}\n`);
-      } catch {
-        /* fail-safe: падение метрики не роняет сессию */
-      }
+      recordSkillMetric(
+        (input as { tool?: string } | null)?.tool,
+        (output as { args?: { name?: string; skill?: string } } | null)?.args
+      );
     },
   };
-};
+}
+
+// v2-контракт: loader v2 вызывает `setup(ctx)`; инъекция — текст-блок в
+// event.system (мутация доходит до модельного запроса), метрика — tool-hook.
+interface V2ContextEvent {
+  system: Array<{ type: 'text'; text: string }>;
+  messages: Array<{ id: string; role: string; content: Array<{ type: 'text'; text: string }>; metadata: unknown }>;
+  agent: string;
+}
+interface V2ToolEvent {
+  tool: string;
+  input: unknown;
+  id: string;
+}
+interface V2Ctx {
+  session: {
+    hook(name: 'context', fn: (event: V2ContextEvent) => Promise<void>): Promise<{ dispose: () => Promise<void> }>;
+  };
+  tool: {
+    hook(
+      name: 'execute.before',
+      fn: (event: V2ToolEvent) => Promise<void>
+    ): Promise<{ dispose: () => Promise<void> }>;
+  };
+}
+
+async function setup(ctx: V2Ctx) {
+  ensureSession();
+  await ctx.session.hook('context', async (event) => {
+    await deliverPlaybook(
+      (event?.system ?? []).map((s) => s.text).join('\n'),
+      (text) => event.system.push({ type: 'text', text })
+    );
+  });
+  await ctx.tool.hook('execute.before', async (event) => {
+    recordSkillMetric(event.tool, event.input);
+  });
+}
+
+// РОВНО ОДИН export на файл (контракт loader'а opencode): dual v1/v2 entry.
+export default { id: 'wolf-router', setup, server };

package/templates/opencode/plugins/wolf-session-start.js

@@ -56,16 +56,15 @@ const WORKER_BODY = `## using-skills: пассивный режим воркер
 /**
  * Чистая функция инъекции (юнит-тестируемая): по маркеру в транскрипте и
  * agent-id решает, какое тело доставить. null = инъекция не нужна.
- * Fail-safe (m13): битый вход → null, никогда не бросает.
+ * Shape-agnostic (v1 parts / v2 content): части сообщения — `m.parts` ИЛИ
+ * `m.content`. Fail-safe (m13): битый вход → null, никогда не бросает.
  */
 function computeInjection(messages, agentId) {
   try {
     if (!Array.isArray(messages)) return null;
     // H3: идемпотентность — маркер в ЛЮБОМ сообщении транскрипта → не инъекцируем.
-    const seen = messages.some(
-      (m) =>
-        Array.isArray(m?.parts) &&
-        m.parts.some((p) => p?.type === 'text' && String(p.text ?? '').includes(MARKER))
+    const seen = messages.some((m) =>
+      blockList(m).some((p) => p?.type === 'text' && String(p.text ?? '').includes(MARKER))
     );
     if (seen) return null;
     // MAJ-4: worker-* → усечённое тело (без диспетчерского контура using-skills).
@@ -95,9 +94,13 @@ const runWolf = (args) => {
     .catch(() => null);
 };
 
+// Блоки контента сообщения: v1 транскрипт — m.parts, v2 context — m.content.
+const blockList = (message) =>
+  Array.isArray(message?.parts) ? message.parts : Array.isArray(message?.content) ? message.content : [];
+
 // Topic = первые слова первого пользовательского сообщения, для `call --for`.
 const topicOf = (message) =>
-  (message?.parts ?? [])
+  blockList(message)
     .filter((p) => p.type === 'text' && p.text)
     .map((p) => p.text)
     .join(' ')
@@ -106,49 +109,94 @@ const topicOf = (message) =>
     .slice(0, 10)
     .join(' ');
 
+/** MAJ-1: БЕЗ кэша на процесс — каждый запуск без маркера пересчитывает
+ *  recap/call заново (маркер исчез после /clear или compact → снова).
+ *  L2 (worker-*) секции recap/call не трогает вообще. */
+async function buildSections(body, firstUser, agentId) {
+  const sections = [body];
+  if (!(agentId ?? '').startsWith('worker-')) {
+    const topic = topicOf(firstUser);
+    const [recap, call] = await Promise.all([
+      runWolf(['recap']),
+      topic ? runWolf(['call', '--for', topic, '--compact', '600']) : null,
+    ]);
+    if (call?.trim()) sections.unshift(`## Active injections\n${call.trim()}`);
+    if (recap?.trim()) sections.unshift(`## Recap\n${recap.trim()}`);
+  }
+  return sections;
+}
+
+const wrap = (sections) =>
+  `<session_context>\n${MARKER}\n\n${sections.join('\n\n')}\n</session_context>`;
+
 // MAJ-4: уровень сессии читаем из system-промпта (маркер agent-id в теле
 // рамки агента). Порядок хуков на первый запрос — на совести рантайма;
 // пока agent-id не виден, дефолт — полный набор (L0/L1, primary-сессии).
 let currentAgentId = null;
 
-export const WolfSessionStartPlugin = async () => ({
-  'experimental.chat.system.transform': async (_input, output) => {
-    try {
-      const m = (output?.system ?? []).join('\n').match(AGENT_ID_RE);
-      currentAgentId = m ? m[1] : null;
-    } catch {
-      /* fail-safe */
-    }
-  },
-  'experimental.chat.messages.transform': async (_input, output) => {
+// 4.C/P204: один WOLF_SESSION на процесс opencode — и v1-, и v2-фабрика
+// ставят ключ только при отсутствии (спавны наследуют process.env).
+function ensureSession() {
+  if (!process.env.WOLF_SESSION) process.env.WOLF_SESSION = 'opc-' + randomUUID();
+}
+
+// v1-фабрика: loader v1 вызывает `server()` и получает hook-объект.
+async function server() {
+  ensureSession();
+  return {
+    'experimental.chat.system.transform': async (_input, output) => {
+      try {
+        const m = (output?.system ?? []).join('\n').match(AGENT_ID_RE);
+        currentAgentId = m ? m[1] : null;
+      } catch {
+        /* fail-safe */
+      }
+    },
+    'experimental.chat.messages.transform': async (_input, output) => {
+      try {
+        const messages = output?.messages;
+        const body = computeInjection(messages, currentAgentId);
+        if (!body) return;
+        const firstUser = messages.find((m) => m.info?.role === 'user');
+        if (!firstUser?.parts?.length) return;
+
+        const sections = await buildSections(body, firstUser, currentAgentId);
+        const ref = firstUser.parts[0];
+        firstUser.parts.unshift({
+          ...ref,
+          type: 'text',
+          text: wrap(sections),
+        });
+      } catch {
+        // Fail-safe (m13): ошибка плагина не имеет права уронить сессию.
+      }
+    },
+  };
+}
+
+// v2-контракт: loader v2 вызывает `setup(ctx)`. agent-id — из текстов
+// event.system (маркер рамки), первый user — по m.role, инъекция — text-блок
+// в начало content (мутация доходит до модельного запроса).
+async function setup(ctx) {
+  ensureSession();
+  await ctx.session.hook('context', async (event) => {
     try {
-      const messages = output?.messages;
+      const messages = event?.messages;
+      const systemText = (event?.system ?? []).map((s) => s?.text ?? '').join('\n');
+      const m = systemText.match(AGENT_ID_RE);
+      currentAgentId = m ? m[1] : typeof event?.agent === 'string' ? event.agent : null;
       const body = computeInjection(messages, currentAgentId);
       if (!body) return;
-      const firstUser = messages.find((m) => m.info?.role === 'user');
-      if (!firstUser?.parts?.length) return;
-
-      const sections = [body];
-      // MAJ-1: БЕЗ кэша на процесс — каждый запуск без маркера пересчитывает
-      // recap/call заново (маркер исчез после /clear или compact → снова).
-      if (!(currentAgentId ?? '').startsWith('worker-')) {
-        const topic = topicOf(firstUser);
-        const [recap, call] = await Promise.all([
-          runWolf(['recap']),
-          topic ? runWolf(['call', '--for', topic, '--compact', '600']) : null,
-        ]);
-        if (call?.trim()) sections.unshift(`## Active injections\n${call.trim()}`);
-        if (recap?.trim()) sections.unshift(`## Recap\n${recap.trim()}`);
-      }
+      const firstUser = Array.isArray(messages) ? messages.find((mm) => mm?.role === 'user') : null;
+      if (!Array.isArray(firstUser?.content) || firstUser.content.length === 0) return;
 
-      const ref = firstUser.parts[0];
-      firstUser.parts.unshift({
-        ...ref,
-        type: 'text',
-        text: `<session_context>\n${MARKER}\n\n${sections.join('\n\n')}\n</session_context>`,
-      });
+      const sections = await buildSections(body, firstUser, currentAgentId);
+      firstUser.content.unshift({ type: 'text', text: wrap(sections) });
     } catch {
       // Fail-safe (m13): ошибка плагина не имеет права уронить сессию.
     }
-  },
-});
+  });
+}
+
+// РОВНО ОДИН export на файл (контракт loader'а opencode): dual v1/v2 entry.
+export default { id: 'wolf-session-start', setup, server };