brainclaw 1.9.0 → 1.9.1

package/dist/commands/harvest.js

@@ -299,7 +299,7 @@ export function harvestLaneResults(options = {}) {
 // ─────────────────────────────────────────────────────────────────────────────
 // pln#534 — worktree-as-contract: integrate a worker's lane on its behalf.
 //
-// LEVER #1 from the LeaseUp frontier (can_100f1e8c). The worker's contract is
+// LEVER #1 from a cross-project field session. The worker's contract is
 // reduced to "edit files in this worktree + drop LANE-RESULT.json". brainclaw
 // carries the rest for a worker that cannot (a sandboxed agent whose root
 // excludes `.git`, i.e. dispatchCanCommit=false): it COMMITS the worktree diff

package/dist/commands/hooks.js

@@ -9,33 +9,33 @@ import { BRAINCLAW_SECTION_START, BRAINCLAW_SECTION_END, upsertBrainclawSection,
  * deterministically into every agent conversation.
  */
 export function generateCursorHook(projectName) {
-    return `---
-description: brainclaw session bootstrap for ${projectName}
-alwaysApply: true
----
-
-# Brainclaw session bootstrap
-
-Brainclaw is the shared coordination layer for this project. Use its MCP facades first — the CLI is only a fallback when MCP is unavailable.
-
-## At the start of every session
-
-Call \`bclaw_work(intent)\` — it handles session setup, context load, and scope claim in a single call.
-
-- \`bclaw_work(intent: "resume")\` when continuing an existing task.
-- \`bclaw_work(intent: "execute", scope: "<path>", task: "<text>")\` when starting new work on a specific scope.
-- \`bclaw_work(intent: "consult")\` to read context without claiming.
-
-## To coordinate with other agents
-
-\`bclaw_coordinate(intent)\` — \`assign\`, \`consult\`, \`review\`, or \`reroute\`.
-
-## Before finishing
-
-- Release your claims: \`bclaw_release_claim(id)\`.
-- Close out the session: \`bclaw_session_end\` (or let it auto-release via the session hook).
-
-CLI fallback only: \`brainclaw context\` / \`brainclaw session-end --auto-release\` if MCP is not reachable.
+    return `---
+description: brainclaw session bootstrap for ${projectName}
+alwaysApply: true
+---
+
+# Brainclaw session bootstrap
+
+Brainclaw is the shared coordination layer for this project. Use its MCP facades first — the CLI is only a fallback when MCP is unavailable.
+
+## At the start of every session
+
+Call \`bclaw_work(intent)\` — it handles session setup, context load, and scope claim in a single call.
+
+- \`bclaw_work(intent: "resume")\` when continuing an existing task.
+- \`bclaw_work(intent: "execute", scope: "<path>", task: "<text>")\` when starting new work on a specific scope.
+- \`bclaw_work(intent: "consult")\` to read context without claiming.
+
+## To coordinate with other agents
+
+\`bclaw_coordinate(intent)\` — \`assign\`, \`consult\`, \`review\`, or \`reroute\`.
+
+## Before finishing
+
+- Release your claims: \`bclaw_release_claim(id)\`.
+- Close out the session: \`bclaw_session_end\` (or let it auto-release via the session hook).
+
+CLI fallback only: \`brainclaw context\` / \`brainclaw session-end --auto-release\` if MCP is not reachable.
 `;
 }
 /**
@@ -44,58 +44,58 @@ CLI fallback only: \`brainclaw context\` / \`brainclaw session-end --auto-releas
  * delimited "SESSION START" block acts as a deterministic trigger.
  */
 export function generateWindsurfHook(projectName) {
-    return `# Brainclaw session trigger — ${projectName}
-# This block is always active. Windsurf Cascade reads .windsurfrules on every activation.
-
-## SESSION START (always run first)
-
-Call the Brainclaw MCP facade before responding to any request:
-
-- \`bclaw_work(intent: "resume")\` when continuing an existing task.
-- \`bclaw_work(intent: "execute", scope: "<path>", task: "<text>")\` when starting new work on a specific scope.
-- \`bclaw_work(intent: "consult")\` to read context without claiming.
-
-This returns active constraints, recent decisions, known traps, open plans, active claims, and the last handoff. Do not skip.
-
-## COORDINATION
-
-\`bclaw_coordinate(intent)\` to assign, consult, review, or reroute other agents.
-
-## SESSION END (before finishing)
-
-- \`bclaw_release_claim(id)\` for each claim you hold.
-- \`bclaw_session_end\` to close the session (auto-releases remaining claims).
-
-CLI fallback only when MCP is unavailable: \`brainclaw context\` / \`brainclaw session-end --auto-release\`.
+    return `# Brainclaw session trigger — ${projectName}
+# This block is always active. Windsurf Cascade reads .windsurfrules on every activation.
+
+## SESSION START (always run first)
+
+Call the Brainclaw MCP facade before responding to any request:
+
+- \`bclaw_work(intent: "resume")\` when continuing an existing task.
+- \`bclaw_work(intent: "execute", scope: "<path>", task: "<text>")\` when starting new work on a specific scope.
+- \`bclaw_work(intent: "consult")\` to read context without claiming.
+
+This returns active constraints, recent decisions, known traps, open plans, active claims, and the last handoff. Do not skip.
+
+## COORDINATION
+
+\`bclaw_coordinate(intent)\` to assign, consult, review, or reroute other agents.
+
+## SESSION END (before finishing)
+
+- \`bclaw_release_claim(id)\` for each claim you hold.
+- \`bclaw_session_end\` to close the session (auto-releases remaining claims).
+
+CLI fallback only when MCP is unavailable: \`brainclaw context\` / \`brainclaw session-end --auto-release\`.
 `;
 }
 /**
  * Generate a generic markdown session-trigger section.
  */
 export function generateMarkdownHook(agentName, projectName) {
-    return `# Brainclaw session trigger — ${projectName}
-# This block is always active. ${agentName} reads this file on every activation.
-
-## SESSION START (always run first)
-
-Call the Brainclaw MCP facade before responding to any request:
-
-- \`bclaw_work(intent: "resume")\` when continuing an existing task.
-- \`bclaw_work(intent: "execute", scope: "<path>", task: "<text>")\` when starting new work on a specific scope.
-- \`bclaw_work(intent: "consult")\` to read context without claiming.
-
-This returns active constraints, recent decisions, known traps, open plans, active claims, and the last handoff. Do not skip.
-
-## COORDINATION
-
-\`bclaw_coordinate(intent)\` to assign, consult, review, or reroute other agents.
-
-## SESSION END (before finishing)
-
-- \`bclaw_release_claim(id)\` for each claim you hold.
-- \`bclaw_session_end\` to close the session (auto-releases remaining claims).
-
-CLI fallback only when MCP is unavailable: \`brainclaw context\` / \`brainclaw session-end --auto-release\`.
+    return `# Brainclaw session trigger — ${projectName}
+# This block is always active. ${agentName} reads this file on every activation.
+
+## SESSION START (always run first)
+
+Call the Brainclaw MCP facade before responding to any request:
+
+- \`bclaw_work(intent: "resume")\` when continuing an existing task.
+- \`bclaw_work(intent: "execute", scope: "<path>", task: "<text>")\` when starting new work on a specific scope.
+- \`bclaw_work(intent: "consult")\` to read context without claiming.
+
+This returns active constraints, recent decisions, known traps, open plans, active claims, and the last handoff. Do not skip.
+
+## COORDINATION
+
+\`bclaw_coordinate(intent)\` to assign, consult, review, or reroute other agents.
+
+## SESSION END (before finishing)
+
+- \`bclaw_release_claim(id)\` for each claim you hold.
+- \`bclaw_session_end\` to close the session (auto-releases remaining claims).
+
+CLI fallback only when MCP is unavailable: \`brainclaw context\` / \`brainclaw session-end --auto-release\`.
 `;
 }
 export function writeHook(content, relativePath, cwd) {

package/dist/commands/init.js

@@ -117,7 +117,7 @@ export async function runInit(options = {}) {
     });
     // Auto-detect and register the AI coding agent running in this environment
     const detectedAi = skipAgentBootstrap ? undefined : detectAiAgent();
-    let registeredAiAgent = detectedAi
+    const registeredAiAgent = detectedAi
         ? registerAgentIdentity({
             agentName: detectedAi.name,
             kind: detectedAi.kind,

package/dist/commands/install-hooks.js

@@ -40,63 +40,63 @@ export function runInstallHooks(options = {}) {
     }
 }
 function generateClaudePreToolScript() {
-    return `#!/bin/sh
-# brainclaw Claude Code preToolUse hook
-# Generated by: brainclaw install-hooks
-exec node -e "
-const fs = require('fs');
-const path = require('path');
-const { execSync } = require('child_process');
-
-const toolName = process.env.CLAUDE_TOOL_NAME || process.argv[2] || process.env.TOOL_NAME || '';
-const isWrite = /edit|write|replace|bash|str_replace/i.test(toolName);
-
-if (!isWrite || !toolName) process.exit(0);
-
-try {
-  const BCLAW_CMD = fs.existsSync(path.join(process.cwd(), 'node_modules', '.bin', 'brainclaw')) 
-    ? 'npx brainclaw' : 'brainclaw';
-  const out = execSync(BCLAW_CMD + ' claim list --json', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'ignore'] });
-  const claims = JSON.parse(out);
-  if (claims && claims.length > 0) process.exit(0);
-} catch (e) {
-  // ignore if brainclaw not found or fails
-  process.exit(0);
-}
-
-const sessionMark = path.join(process.cwd(), '.brainclaw', 'tmp', 'claude_warned');
-if (!fs.existsSync(path.dirname(sessionMark))) fs.mkdirSync(path.dirname(sessionMark), { recursive: true });
-
-if (fs.existsSync(sessionMark)) {
-  const mtime = fs.statSync(sessionMark).mtimeMs;
-  if (Date.now() - mtime < 2 * 60 * 60 * 1000) {
-    process.exit(0); // already warned this session
-  }
-}
-fs.writeFileSync(sessionMark, Date.now().toString());
-
-process.stderr.write('\\n[Brainclaw] ⚠️  WARNING: You are about to use an Edit/Write tool (' + toolName + ') but you have NO active claim.\\n');
-process.stderr.write('[Brainclaw] Consider running \\\`brainclaw claim create <scope>\\\` to lock your work and avoid conflicts.\\n\\n');
-" 2>&1 || exit 0
+    return `#!/bin/sh
+# brainclaw Claude Code preToolUse hook
+# Generated by: brainclaw install-hooks
+exec node -e "
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const toolName = process.env.CLAUDE_TOOL_NAME || process.argv[2] || process.env.TOOL_NAME || '';
+const isWrite = /edit|write|replace|bash|str_replace/i.test(toolName);
+
+if (!isWrite || !toolName) process.exit(0);
+
+try {
+  const BCLAW_CMD = fs.existsSync(path.join(process.cwd(), 'node_modules', '.bin', 'brainclaw')) 
+    ? 'npx brainclaw' : 'brainclaw';
+  const out = execSync(BCLAW_CMD + ' claim list --json', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'ignore'] });
+  const claims = JSON.parse(out);
+  if (claims && claims.length > 0) process.exit(0);
+} catch (e) {
+  // ignore if brainclaw not found or fails
+  process.exit(0);
+}
+
+const sessionMark = path.join(process.cwd(), '.brainclaw', 'tmp', 'claude_warned');
+if (!fs.existsSync(path.dirname(sessionMark))) fs.mkdirSync(path.dirname(sessionMark), { recursive: true });
+
+if (fs.existsSync(sessionMark)) {
+  const mtime = fs.statSync(sessionMark).mtimeMs;
+  if (Date.now() - mtime < 2 * 60 * 60 * 1000) {
+    process.exit(0); // already warned this session
+  }
+}
+fs.writeFileSync(sessionMark, Date.now().toString());
+
+process.stderr.write('\\n[Brainclaw] ⚠️  WARNING: You are about to use an Edit/Write tool (' + toolName + ') but you have NO active claim.\\n');
+process.stderr.write('[Brainclaw] Consider running \\\`brainclaw claim create <scope>\\\` to lock your work and avoid conflicts.\\n\\n');
+" 2>&1 || exit 0
 `;
 }
 function generatePostMergeScript() {
-    return `#!/bin/sh
-# brainclaw post-merge hook
-# Auto-releases claims whose scope overlaps with files changed by the merge
-# Generated by: brainclaw install-hooks
-
-BCLAW_CMD=""
-if command -v brainclaw >/dev/null 2>&1; then
-  BCLAW_CMD="brainclaw"
-elif command -v bclaw >/dev/null 2>&1; then
-  BCLAW_CMD="bclaw"
-else
-  BCLAW_CMD="npx --no brainclaw"
-fi
-
-$BCLAW_CMD release-claims --from-git-diff 2>/dev/null || true
-$BCLAW_CMD worktree clean 2>/dev/null || true
+    return `#!/bin/sh
+# brainclaw post-merge hook
+# Auto-releases claims whose scope overlaps with files changed by the merge
+# Generated by: brainclaw install-hooks
+
+BCLAW_CMD=""
+if command -v brainclaw >/dev/null 2>&1; then
+  BCLAW_CMD="brainclaw"
+elif command -v bclaw >/dev/null 2>&1; then
+  BCLAW_CMD="bclaw"
+else
+  BCLAW_CMD="npx --no brainclaw"
+fi
+
+$BCLAW_CMD release-claims --from-git-diff 2>/dev/null || true
+$BCLAW_CMD worktree clean 2>/dev/null || true
 `;
 }
 function findGitRoot(cwd) {
@@ -113,30 +113,30 @@ function findGitRoot(cwd) {
 function generateHookScript() {
     // Use node directly to avoid sh.exe pipe issues on Windows (SIGPIPE).
     // The script is a self-contained node -e that runs both checks.
-    return `#!/bin/sh
-# brainclaw pre-commit hook — generated by brainclaw install-hooks
-# Runs via node to avoid sh.exe SIGPIPE issues on Windows.
-exec node -e "
-const { execSync } = require('child_process');
-const staged = execSync('git diff --cached --name-only', { encoding: 'utf-8' }).trim();
-if (!staged) process.exit(0);
-
-// Check 1: reject staged .brainclaw/ files
-const brainclawFiles = staged.split('\\\\n').filter(f => f.startsWith('.brainclaw/'));
-if (brainclawFiles.length > 0) {
-  process.stderr.write('\\\\nbrainclaw: .brainclaw/ files are staged — blocked.\\\\n');
-  brainclawFiles.forEach(f => process.stderr.write('  ' + f + '\\\\n'));
-  process.stderr.write('  Fix: git reset HEAD .brainclaw/\\\\n\\\\n');
-  process.exit(1);
-}
-
-// Check 2: active constraint violations
-try {
-  execSync('brainclaw check-constraints --staged', { stdio: 'inherit' });
-} catch (e) {
-  if (e.status) process.exit(e.status);
-}
-" 2>&1 || exit $?
+    return `#!/bin/sh
+# brainclaw pre-commit hook — generated by brainclaw install-hooks
+# Runs via node to avoid sh.exe SIGPIPE issues on Windows.
+exec node -e "
+const { execSync } = require('child_process');
+const staged = execSync('git diff --cached --name-only', { encoding: 'utf-8' }).trim();
+if (!staged) process.exit(0);
+
+// Check 1: reject staged .brainclaw/ files
+const brainclawFiles = staged.split('\\\\n').filter(f => f.startsWith('.brainclaw/'));
+if (brainclawFiles.length > 0) {
+  process.stderr.write('\\\\nbrainclaw: .brainclaw/ files are staged — blocked.\\\\n');
+  brainclawFiles.forEach(f => process.stderr.write('  ' + f + '\\\\n'));
+  process.stderr.write('  Fix: git reset HEAD .brainclaw/\\\\n\\\\n');
+  process.exit(1);
+}
+
+// Check 2: active constraint violations
+try {
+  execSync('brainclaw check-constraints --staged', { stdio: 'inherit' });
+} catch (e) {
+  if (e.status) process.exit(e.status);
+}
+" 2>&1 || exit $?
 `;
 }
 //# sourceMappingURL=install-hooks.js.map

package/dist/commands/mcp-read-handlers.js

@@ -6,7 +6,7 @@ import { buildContext } from '../core/context.js';
 import { buildExecutionContext, renderExecutionContextSummary } from '../core/execution-context.js';
 import { checkBrainclawInstallableUpdate, renderBrainclawInstallableUpdateNotice } from '../core/brainclaw-version.js';
 import { loadConfig } from '../core/config.js';
-import { loadAllSessions, loadCurrentSession, saveCurrentSession, gcStaleSessions } from '../core/identity.js';
+import { loadAllSessions, loadCurrentSession, loadSessionById, saveCurrentSession, gcStaleSessions } from '../core/identity.js';
 import { loadState } from '../core/state.js';
 import { listArchivedCandidates, listCandidates, resolvedSource } from '../core/candidates.js';
 import { listClaims, assessClaimLiveness } from '../core/claims.js';
@@ -27,13 +27,13 @@ import { checkPolicy } from '../core/policy.js';
 import { buildGovernanceReport, renderGovernanceMarkdown } from '../core/governance.js';
 import { inferProjectFromTarget, loadInstructions, resolveInstructions } from '../core/instructions.js';
 import { buildReputationSnapshot, toPublicReputationSummary } from '../core/reputation.js';
-import { search } from '../core/search.js';
+import { countLegacySearchMatches, search } from '../core/search.js';
 import { buildEstimationReport } from './estimation-report.js';
 import { runDoctor } from './doctor.js';
 import { buildProjectDiscovery, saveDiscoveryProfile, loadDiscoveryProfile, renderDiscoverySummary } from '../core/project-discovery.js';
 import { listCapabilities, listTools as listRegistryTools } from '../core/registries.js';
-import { listAvailableProjects, switchProject } from './switch.js';
-import { resolveEffectiveCwd } from '../core/store-resolution.js';
+import { listAvailableProjectsForSession, switchProject } from './switch.js';
+import { resolveEffectiveCwdInfo } from '../core/store-resolution.js';
 import { resolveProjectCwd } from '../core/cross-project.js';
 import { readUnseenEvents, buildNotificationSummary } from '../core/event-log.js';
 import { boundListResult, DEFAULT_FIND_CHAR_BUDGET } from '../core/entity-operations.js';
@@ -100,9 +100,12 @@ function getReviewAssignee(tags) {
 }
 export function handleMcpReadToolCall(name, args = {}, context = {}) {
     const baseCwd = context.cwd ?? process.cwd();
-    let cwd = name === 'bclaw_switch'
-        ? baseCwd
-        : resolveEffectiveCwd({ baseCwd });
+    const effective = name === 'bclaw_switch'
+        ? { cwd: baseCwd, active_source: 'cwd', resolved_project: undefined }
+        : context.effectiveScope ?? resolveEffectiveCwdInfo({ baseCwd, sessionId: context.connectionSessionId });
+    let cwd = effective.cwd;
+    let activeSource = effective.active_source;
+    let resolvedProject = effective.resolved_project;
     // If a project param is provided, resolve it to an actual cwd override.
     // resolveProjectCwd unifies cross_project_links (siblings/peers) AND
     // workspace store-chain children. Throws on unknown project — surfaces
@@ -115,6 +118,14 @@ export function handleMcpReadToolCall(name, args = {}, context = {}) {
     let projectRoutingApplied = false;
     if (targetProjectArg) {
         cwd = resolveProjectCwd(targetProjectArg, cwd);
+        activeSource = 'explicit';
+        try {
+            const config = loadConfig(cwd);
+            resolvedProject = { path: cwd, name: config.project_name };
+        }
+        catch {
+            resolvedProject = { path: cwd };
+        }
         projectRoutingApplied = true;
     }
     if (name === 'bclaw_get_context') {
@@ -631,13 +642,25 @@ export function handleMcpReadToolCall(name, args = {}, context = {}) {
         }
         const offset = Math.max(0, Number(args.offset) || 0);
         const limit = typeof args.limit === 'number' ? args.limit : 10;
+        const includeLegacy = args.includeLegacy === true || (typeof args.filter === 'object' && args.filter?.includeLegacy === true);
         const allResults = search({
             query,
             section: (args.section ?? args.type),
             since: args.since,
-            maxResults: offset + limit,
+            maxResults: Number.MAX_SAFE_INTEGER,
+            includeLegacy,
             cwd,
         });
+        const excludedLegacy = includeLegacy
+            ? 0
+            : countLegacySearchMatches({
+                query,
+                section: (args.section ?? args.type),
+                since: args.since,
+                maxResults: offset + limit,
+                includeLegacy: true,
+                cwd,
+            });
         const total = allResults.length;
         const page = allResults.slice(offset, offset + limit);
         // trp#449 class — bound the page by size (pln#542). budget_tokens tightens
@@ -647,16 +670,34 @@ export function handleMcpReadToolCall(name, args = {}, context = {}) {
         const bounded = boundListResult({ entity: 'search_result', total, items: page }, offset, charBudget);
         const lines = bounded.items.map((result) => `[${result.id}] (${result.section}) score=${result.score.toFixed(2)}: ${result.text.slice(0, 120)}`);
         const nextActions = bounded.has_more
-            ? [{ tool: 'bclaw_search', args: { query, offset: bounded.next_offset, limit }, when: 'to fetch the next page' }]
+            ? [{
+                    tool: 'bclaw_search',
+                    args: {
+                        query,
+                        offset: bounded.next_offset,
+                        limit,
+                        ...(args.project ? { project: args.project } : {}),
+                        ...(args.section ? { section: args.section } : {}),
+                        ...(args.type ? { type: args.type } : {}),
+                        ...(args.since ? { since: args.since } : {}),
+                        ...(args.budget_tokens ? { budget_tokens: args.budget_tokens } : {}),
+                        ...(includeLegacy ? { includeLegacy: true } : {}),
+                    },
+                    when: 'to fetch the next page',
+                }]
             : [];
+        const legacyNote = excludedLegacy > 0 ? ` (${excludedLegacy} legacy result(s) excluded; pass includeLegacy=true to include them)` : '';
         return {
-            content: [{ type: 'text', text: bounded.items.length > 0 ? lines.join('\n') : 'No results found.' }],
+            content: [{ type: 'text', text: bounded.items.length > 0 ? `${lines.join('\n')}${legacyNote}` : `No results found.${legacyNote}` }],
             structuredContent: {
                 total,
                 offset,
                 limit,
                 results: bounded.items,
                 returned: bounded.returned,
+                excluded_legacy: excludedLegacy,
+                resolved_project: resolvedProject ?? { path: cwd },
+                active_source: activeSource,
                 has_more: bounded.has_more,
                 ...(bounded.next_offset !== undefined ? { next_offset: bounded.next_offset } : {}),
                 ...(bounded.omitted_for_size ? { omitted_for_size: bounded.omitted_for_size } : {}),
@@ -1034,7 +1075,7 @@ export function handleMcpReadToolCall(name, args = {}, context = {}) {
             }
             catch { /* defensive: never block events query on reconcile failure */ }
         }
-        let events = queryRuntimeEvents({
+        const events = queryRuntimeEvents({
             ...(id ? { id } : {}),
             ...(assignmentId ? { assignment_id: assignmentId } : {}),
             ...(runId ? { run_id: runId } : {}),
@@ -1422,7 +1463,7 @@ export function handleMcpReadToolCall(name, args = {}, context = {}) {
     if (name === 'bclaw_switch') {
         if (args.list === true) {
             try {
-                const result = listAvailableProjects(cwd);
+                const result = listAvailableProjectsForSession(cwd, context.connectionSessionId);
                 const lines = result.projects.map(p => {
                     const marker = p.active ? '→' : ' ';
                     const label = p.name ? `${p.name} (${p.relative_path})` : p.relative_path;
@@ -1439,7 +1480,9 @@ export function handleMcpReadToolCall(name, args = {}, context = {}) {
         }
         if (args.clear === true) {
             try {
-                const session = loadCurrentSession(cwd);
+                const session = context.connectionSessionId
+                    ? loadSessionById(context.connectionSessionId, cwd)
+                    : loadCurrentSession(cwd);
                 if (session?.active_project) {
                     const { active_project: _removed, ...rest } = session;
                     saveCurrentSession(rest, cwd);
@@ -1458,7 +1501,7 @@ export function handleMcpReadToolCall(name, args = {}, context = {}) {
             return createToolErrorResponse('validation_error', 'Missing required argument: project (or use list=true / clear=true)');
         }
         try {
-            const result = switchProject(projectRef, { cwd, sessionOnly: true });
+            const result = switchProject(projectRef, { cwd, sessionOnly: true, sessionId: context.connectionSessionId });
             const text = `✔ Switched to ${result.name ? `"${result.name}"` : result.path} (${result.scope}-scoped)`;
             return {
                 content: [{ type: 'text', text }],