@enfyra/mcp-server 0.1.63 → 0.1.65

package/dist/lib/required-knowledge.d.ts

@@ -1,6 +1,13 @@
-export declare const GLOBAL_RULES_ACK_KEY = "EFYRA::GLOBAL-RULES::RUNTIME-ZONES::SCHEMA-DESIGN-CONTEXT::RECORD-BATCH::20260704H";
-export declare const DYNAMIC_CODE_KNOWLEDGE_ACK_KEY = "EFYRA::DYNAMIC-REPOSITORY-CONTRACT::RUNTIME-SURFACE-CONTRACTS::20260716D";
-export declare const EXTENSION_KNOWLEDGE_ACK_KEY = "EFYRA::EXTENSION-APP-COMPOSABLE-CONTRACT::20260708A";
+export declare const GLOBAL_RULES_ACK_KEY = "EFYRA::GLOBAL-RULES::RUNTIME-ZONE-INVENTORY::SCHEMA-DESIGN-CONTEXT::20260717I";
+export declare const DYNAMIC_CODE_KNOWLEDGE_ACK_KEY = "EFYRA::DYNAMIC-REPOSITORY-CONTRACT::LOCATOR-FIRST::ASYNC-HELPER-BRIDGE::20260717B";
+export declare const EXTENSION_KNOWLEDGE_ACK_KEY = "EFYRA::EXTENSION-APP-COMPOSABLE-CONTRACT::20260716B";
+export declare function resetRequiredKnowledgeSession(): void;
+export declare function getRequiredKnowledgeSessionState(): {
+    acknowledgedDomains: string[];
+};
+export declare function acknowledgeRequiredKnowledge(scope?: string): {
+    acknowledgedDomains: string[];
+};
 export declare function globalRulesAckParam(z: any): any;
 export declare function dynamicCodeKnowledgeAckParam(z: any): any;
 export declare function extensionKnowledgeAckParam(z: any): any;

package/dist/lib/required-knowledge.js

@@ -1,18 +1,42 @@
-export const GLOBAL_RULES_ACK_KEY = 'EFYRA::GLOBAL-RULES::RUNTIME-ZONES::SCHEMA-DESIGN-CONTEXT::RECORD-BATCH::20260704H';
-export const DYNAMIC_CODE_KNOWLEDGE_ACK_KEY = 'EFYRA::DYNAMIC-REPOSITORY-CONTRACT::RUNTIME-SURFACE-CONTRACTS::20260716D';
-export const EXTENSION_KNOWLEDGE_ACK_KEY = 'EFYRA::EXTENSION-APP-COMPOSABLE-CONTRACT::20260708A';
-const REQUIRED_KNOWLEDGE_VERSION = '2026-07-16.runtime-surface-contracts';
+export const GLOBAL_RULES_ACK_KEY = 'EFYRA::GLOBAL-RULES::RUNTIME-ZONE-INVENTORY::SCHEMA-DESIGN-CONTEXT::20260717I';
+export const DYNAMIC_CODE_KNOWLEDGE_ACK_KEY = 'EFYRA::DYNAMIC-REPOSITORY-CONTRACT::LOCATOR-FIRST::ASYNC-HELPER-BRIDGE::20260717B';
+export const EXTENSION_KNOWLEDGE_ACK_KEY = 'EFYRA::EXTENSION-APP-COMPOSABLE-CONTRACT::20260716B';
+const REQUIRED_KNOWLEDGE_VERSION = '2026-07-17.runtime-zone-inventory-locator-first';
+const acknowledgedDomains = new Set();
+function hasExplicitAckKey(key) {
+    return key !== undefined && key !== null;
+}
+export function resetRequiredKnowledgeSession() {
+    acknowledgedDomains.clear();
+}
+export function getRequiredKnowledgeSessionState() {
+    return {
+        acknowledgedDomains: ['globalRules', 'dynamicServerCode', 'extensions']
+            .filter((domain) => acknowledgedDomains.has(domain)),
+    };
+}
+export function acknowledgeRequiredKnowledge(scope = 'full') {
+    const resolvedScope = requireScope(scope);
+    acknowledgedDomains.add('globalRules');
+    if (resolvedScope === 'full' || resolvedScope === 'dynamic-code' || resolvedScope === 'flow') {
+        acknowledgedDomains.add('dynamicServerCode');
+    }
+    if (resolvedScope === 'full' || resolvedScope === 'extension') {
+        acknowledgedDomains.add('extensions');
+    }
+    return getRequiredKnowledgeSessionState();
+}
 export function globalRulesAckParam(z) {
-    return z.string().describe('Required global-rules acknowledgement key from get_enfyra_required_knowledge. Call that tool, read the global Enfyra MCP rules, then pass globalRulesAckKey exactly.');
+    return z.string().optional().describe('Backward-compatible explicit acknowledgement key. Omit after get_enfyra_required_knowledge has loaded global rules in this MCP process session.');
 }
 export function dynamicCodeKnowledgeAckParam(z) {
-    return z.string().describe('Required dynamic-code acknowledgement key from get_enfyra_required_knowledge. Call that tool, read the dynamic server code knowledge, then pass dynamicCodeAckKey exactly.');
+    return z.string().optional().describe('Backward-compatible explicit acknowledgement key. Omit after get_enfyra_required_knowledge has loaded dynamic-code or flow rules in this MCP process session.');
 }
 export function extensionKnowledgeAckParam(z) {
-    return z.string().describe('Required extension acknowledgement key from get_enfyra_required_knowledge. Call that tool, read the extension/theme knowledge, then pass extensionAckKey exactly.');
+    return z.string().optional().describe('Backward-compatible explicit acknowledgement key. Omit after get_enfyra_required_knowledge has loaded extension rules in this MCP process session.');
 }
 export function assertGlobalRulesAck(key) {
-    if (key !== GLOBAL_RULES_ACK_KEY) {
+    if (!acknowledgedDomains.has('globalRules') && (!hasExplicitAckKey(key) || key !== GLOBAL_RULES_ACK_KEY)) {
         throw new Error('Missing or invalid global-rules acknowledgement. Call get_enfyra_required_knowledge, read the global Enfyra MCP rules, then pass globalRulesAckKey as globalRulesAckKey.');
     }
 }
@@ -21,7 +45,7 @@ export function assertGlobalRulesAckIf(condition, key) {
         assertGlobalRulesAck(key);
 }
 export function assertDynamicCodeKnowledgeAck(key) {
-    if (key !== DYNAMIC_CODE_KNOWLEDGE_ACK_KEY) {
+    if (!acknowledgedDomains.has('dynamicServerCode') && (!hasExplicitAckKey(key) || key !== DYNAMIC_CODE_KNOWLEDGE_ACK_KEY)) {
         throw new Error('Missing or invalid dynamic-code knowledge acknowledgement. Call get_enfyra_required_knowledge, read the dynamic server code contracts, then pass dynamicCodeAckKey as knowledgeAckKey.');
     }
 }
@@ -30,7 +54,7 @@ export function assertDynamicCodeKnowledgeAckIf(condition, key) {
         assertDynamicCodeKnowledgeAck(key);
 }
 export function assertExtensionKnowledgeAck(key) {
-    if (key !== EXTENSION_KNOWLEDGE_ACK_KEY) {
+    if (!acknowledgedDomains.has('extensions') && (!hasExplicitAckKey(key) || key !== EXTENSION_KNOWLEDGE_ACK_KEY)) {
         throw new Error('Missing or invalid extension knowledge acknowledgement. Call get_enfyra_required_knowledge, read the extension/theme contracts, then pass extensionAckKey as extensionKnowledgeAckKey.');
     }
 }
@@ -69,6 +93,7 @@ const GLOBAL_RULES_SECTIONS = [
         rules: [
             'Use search_admin_extensions for menu + extension UI: page extensions, widget extensions, global shell extensions, menu chips, account panel entries, visible buttons, labels, icons, tabs, and blocks.',
             'Use search_runtime_zone as the zone search/inspect tool for non-admin-UI DB-backed artifacts.',
+            'If the correct zone is unclear, call search_runtime_zone once without zone to receive the compact zone catalog. With a selected zone, omit query/path only for a bounded inventory; add query/path for ranked matching.',
             'Search first, then inspect with nextInspect.input before editing.',
             'Use search_runtime_zone with zone=api_runtime for routes, handlers, pre-hooks, post-hooks, guards, guard rules, and route permissions.',
             'Use search_runtime_zone with zone=flow_runtime for flows and flow steps.',
@@ -85,8 +110,9 @@ const GLOBAL_RULES_SECTIONS = [
     {
         id: 'mutations-are-intentional',
         rules: [
+            'Call get_enfyra_api_context before the first mutation in each MCP process and verify the connected API base. The MCP rejects writes until this target confirmation succeeds.',
             'Prefer business operation tools over generic CRUD when a specific tool exists.',
-            'Destructive operations are preview-first; pass confirm=true only after explicit user approval.',
+            'Destructive operations are preview-first. A confirmed delete must match a successful preview from the same MCP process session; pass confirm=true only after inspecting that preview and receiving explicit user approval.',
             'Do not manually reload caches unless natural partial reload is proven stale or a concrete reload error requires it.',
             'Never fabricate ids, field names, relation names, paths, package names, or permission scopes.',
         ],
@@ -98,6 +124,7 @@ const GLOBAL_RULES_SECTIONS = [
             'Then call get_enfyra_examples with category=schema-relations only for reasoning patterns, not for domain-specific table names.',
             'Use plural mutation tools for writes: create_tables/update_tables/delete_tables, create_columns/update_columns/delete_columns, create_relations/delete_relations, and create_records/update_records/delete_records. Pass native JSON arrays; use one item in the array for a single mutation.',
             'Create entity tables with scalar columns first, then add relations once target tables exist. create_tables defers relation creation until all tables in the same batch exist.',
+            'Enfyra table names are lowercase. create_tables lowercases names and matching same-batch relation targets before writing and reports the normalization; use aliases for human-facing labels.',
             'Do not declare id, _id, createdAt, or updatedAt columns; Enfyra manages them automatically.',
             'For one-pass relation-based unique/index constraints, declare the owning relations in the same create_tables item as the constraints. If relations already exist or will be created separately, add those constraints afterward with update_tables.',
             'Use live Enfyra column types, not SQL dialect names. Common safe choices: varchar for short text, text/richtext for long prose, float for price/amount/rating/decimal-like values, int/bigint for counts, boolean, date/datetime/timestamp, enum, simple-json for structured objects/arrays when listed by live metadata, and code for source fields.',
@@ -106,6 +133,7 @@ const GLOBAL_RULES_SECTIONS = [
             'If the app must deep-read a parent with child collections, create the child owning relation with inversePropertyName from the start; otherwise parent.deepChild queries will fail until an inverse relation is added.',
             'When inserting/updating records with relations, use relation propertyName values in the body, not hidden physical FK columns. Inspect the table to learn propertyName values.',
             'For record writes, always use create_records/update_records/delete_records with native array inputs; these tools validate every item against live metadata before posting/patching/deleting sequentially.',
+            'Generic record CRUD cannot mutate domain-owned structure rows in enfyra_table, enfyra_column, enfyra_relation, or enfyra_route. Use the table/column/relation tools or API endpoint/route tools so physical changes, dependencies, reloads, and previews stay correct.',
             'For reads, query_table accepts native object filter/deep/aggregate values. Deep keys are relation names; query_table auto-adds missing top-level deep relation keys to fields so nested records can appear. Inside deep, use fields/filter/sort/limit/page/deep; never use _fields.',
             'Filters use Enfyra operators, not SQL operators. Use _contains, _starts_with, or _ends_with for text matching; do not use _like.',
             'This auto-add behavior is MCP query_table only. Inside dynamic server scripts, repository find({ deep }) requires the relation property to also be present in top-level fields, otherwise row.<relation> may be undefined.',
@@ -174,6 +202,7 @@ const DYNAMIC_CODE_SECTIONS = [
         id: 'dynamic-script-shape',
         rules: [
             'Use sourceCode and scriptLanguage; never send compiledCode.',
+            'Locate script-backed records with search_runtime_zone and inspect the returned nextInspect.input before source reads. Inspection already returns exact source artifacts; never guess or probe ids with get_script_source.',
             'Prefer macros such as @BODY, @QUERY, @PARAMS, @USER, @REQ, @RES, @REPOS, @HELPERS, @STORAGE, @SOCKET, and @THROW* when available.',
             'Call build_dynamic_repository_usage for list, find-one, create, update, or delete code instead of composing secure/trusted repository syntax and result shapes from memory.',
             'An enfyra_oauth_config sourceCode script runs before a new OAuth user insert, has no authenticated @USER, and must return a plain object of additional user fields. Provider identity fields are merged afterward and take precedence.',
@@ -184,10 +213,13 @@ const DYNAMIC_CODE_SECTIONS = [
             'Use @REPOS.main for the route main table and #secure.table_name or @REPOS.secure.table_name for explicit user-facing table access. Reserve #table_name/@REPOS.table_name for trusted internal work that intentionally bypasses field permissions.',
             'When using repository find({ deep }) in handlers/hooks/flows, include each deep relation name in top-level fields, then choose nested fields under deep.<relation>.fields.',
             'Repository calls are async. Always await secure and trusted repository find/create/update/delete/exists calls; reads return { data: [...], meta? }.',
+            'Every @HELPERS method call crosses the async executor bridge and must be awaited before property access, string interpolation, concatenation, or persistence. Example: const id = await @HELPERS.$crypto.randomUUID().',
             'Create/update repository calls return collection-shaped data arrays; read result.data?.[0] for a single row.',
             '@LOGS is a callable function: use @LOGS(message, details?). It has no .info/.warn/.error/.debug methods.',
             '@SOCKET has no generic emit() method. Bound websocket scripts use reply, emitToCurrentRoom, or broadcastToRoom; global HTTP/flow scripts use emitToGateway, emitToRoom, emitToUser, or broadcast.',
             'ESV fixed flow step configs are static host-side objects. Do not put @FLOW_PAYLOAD, @FLOW_LAST, or @FLOW inside query/create/update/delete/http/sleep/trigger/log config; use a focused script step when runtime values are required.',
+            'trigger_flow only executes enabled flows. Verify a disabled flow with test_flow_step; enable it explicitly before testing the real queue/runtime trigger path.',
+            'For test_flow_step, pass runtime @FLOW_PAYLOAD values through the payload object. mockFlow is only for advanced $last/$meta flow context.',
             'For intentional HTTP errors, numeric helpers are raw HTTP message helpers: @THROW400(message), @THROW404(message), @THROW409(message), @THROW422(message, detailsObject?), @THROW500(message).',
             'When numeric helpers include details, pass an object or array such as @THROW404("Project not found", { id }); do not use @THROW404("Project", id) as a semantic shortcut.',
             'Use @THROW.http(status, message, details?) for dynamic status codes. Use @THROW.notFound(resource, id?) and @THROW.duplicate(resource, field, value) only when you intentionally want Enfyra-formatted semantic messages.',
@@ -223,14 +255,18 @@ const EXTENSION_SECTIONS = [
             'Do not call resolveComponent() in extension SFCs. Use auto-injected components such as <UButton>, <UBadge>, <PermissionGate>, and <Widget> directly in the template so the app/compiler resolves them correctly.',
             'Load app packages with getPackages(["package-name"]) inside extension runtime code.',
             'For generated high-contract UI in guided mode, call build_extension_ui with the matching kind after reading this acknowledgement; it lazy-dispatches drawer, modal, page shell, permission gate, empty state, resource list, resource grid, form editor, widget, menu notification, account panel item, tabs, upload modal, notify, confirm, runtime review, theme classes, theme review, or full review contracts without loading every builder tool at startup.',
-            'For extension useApi code, call build_extension_api_usage with operation=list, find_one, create, update, delete, batch_update, or batch_delete. Do not write useApi path/id/body shapes from memory.',
+            'For extension useApi code in guided mode, call build_extension_ui kind=api_usage with operation=list, find_one, create, update, delete, batch_update, or batch_delete. Do not write useApi path/id/body shapes from memory.',
             'For an ordinary destructive action, call build_extension_ui kind=confirm. It generates useConfirm() -> accepted mutation -> refresh; do not use window.confirm, window.alert, alert, or prompt. Use CommonModal directly only for richer confirmation content or form fields.',
             'CommonResourceListFrame is supported in extension runtime and renders its default slot when loading is false and hasItems is true. Do not remove it to speculate about swallowed slots; inspect the source artifact, hasItems/items expressions, and API response shape first.',
             'Use build_extension_ui kind=resource_grid for workboards, catalogs, dashboards, and card collections. It owns eapp-page-constrained-wide, CommonResourceListFrame variant="plain", one/two/three-column responsive breakpoints, semantic card surfaces, and list loading/empty behavior; use resource_list for dense operational rows.',
+            'For ordinary operator inventories, use build_extension_ui kind=resource_list and review/save with uiPattern="resource_list". Keep search/filter controls in a separate compact surface, constrain the inventory with eapp-page-constrained-wide, and let CommonResourceListFrame own loading, empty, total, and pagination state.',
+            'Use disabled buttons for temporarily unavailable actions, not completed terminal states. Render completed/granted/handled state as a badge or metadata and omit the unavailable action.',
             'Dynamic extension templates expose the app empty-state component as <EmptyState>, not <CommonEmptyState>. Prefer the empty_state, resource_list, or resource_grid builder instead of writing either tag from memory.',
             'For theme choices, call build_extension_ui kind=theme_classes with an intent such as neutral_surface, primary_identity, primary_soft_icon_tile, status_success, primary_action, secondary_action, divider, or text instead of inventing classes from memory.',
             'Use build_extension_ui kind=runtime_review, theme_review, or review before saving generated snippets that include useApi, useNotify, theme classes, drawers, modals, fields, lists, tabs, upload modals, shell registry code, or native buttons.',
             'For same-version edits to an existing extension, inspect the extension first and use the generated /tmp/enfyra-mcp-sources artifact when snippets are not enough. Edit that artifact and apply its contents with update_extension_code, or use patch_extension_code for a focused exact patch. Do not regenerate the full Vue SFC for a small bug fix, styling adjustment, or contract correction unless the user explicitly asks for a rewrite or version-changing redesign.',
+            'patch_extension_code apply=true requires expectedSha256 and writes a bounded .diff artifact. update_extension_code accepts expectedSha256 for stale full-replacement protection.',
+            'ensure_*_extension, update_extension_code, and patch_extension_code apply=true automatically re-read and verify the exact saved source, expected hash, server compilation, static UI/theme/runtime contracts, and page menu wiring. Use verify_extension_runtime for an additional independent recheck. browserRender=not_run means signed-in browser QA is still required for component execution, live data shape, console errors, and responsive layout.',
             'Extension validation rejects UInput/UTextarea/USelect/USelectMenu/UInputMenu/UInputNumber/UInputTags/UInputTime/UInputDate without class="w-full" unless the field is explicitly marked data-compact or data-inline.',
             'PermissionGate is operator UX only; backend route permissions and owner checks remain authoritative.',
         ],
@@ -239,7 +275,7 @@ const EXTENSION_SECTIONS = [
         id: 'extension-app-composables',
         rules: [
             'Call useApi() as a top-level setup composable. It returns data/error/pending/status refs plus execute/refresh; call or await execute()/refresh() from onMounted, watchers, or user actions when the request should run.',
-            'Do not write useApi shapes from memory. Call build_extension_api_usage for known-good list/find_one/create/update/delete/batch snippets.',
+            'Do not write useApi shapes from memory. Call build_extension_ui kind=api_usage for known-good list/find_one/create/update/delete/batch snippets.',
             'Do not write useNotify shapes from memory. Call build_extension_ui kind=notify for known-good notification snippets.',
             'Call build_extension_ui kind=runtime_review or kind=review before saving extension code that includes useApi, useNotify, getPackages, or package loading.',
             'Extension validation rejects static imports, useToast/useNotify.add misuse, JSON.stringify useApi options, unused execute aliases, incorrect modal v-model bindings, unavailable runtime aliases, and script-block callbacks that reassign const refs instead of mutating ref.value. Template expressions remain Vue-auto-unwrapped.',
@@ -264,22 +300,22 @@ export function buildRequiredKnowledgePayload(scope = 'full') {
         purpose: SCOPED_PURPOSES[resolvedScope],
         includedDomains: ['globalRules', ...(includeDynamic ? ['dynamicServerCode'] : []), ...(includeExtensions ? ['extensions'] : [])],
         excludedDomains: [...(!includeDynamic ? ['dynamicServerCode'] : []), ...(!includeExtensions ? ['extensions'] : [])],
-        note: 'Ack keys (globalRulesAckKey, dynamicCodeAckKey, extensionAckKey) are always returned so you can use them when needed. Only domains listed in includedDomains have rules loaded. Domains in excludedDomains have NO rules in this response.',
+        note: 'Reading this response acknowledges included domains for the current MCP process session. Write tools accept the returned keys for backward compatibility, but callers may omit them for acknowledged domains. Only includedDomains rules are loaded.',
         globalRulesAckKey: GLOBAL_RULES_ACK_KEY,
         dynamicCodeAckKey: DYNAMIC_CODE_KNOWLEDGE_ACK_KEY,
         extensionAckKey: EXTENSION_KNOWLEDGE_ACK_KEY,
         usage: [
-            'Pass globalRulesAckKey exactly as globalRulesAckKey when calling MCP tools that mutate Enfyra metadata, schema, routes, permissions, menus, packages, cache state, dynamic code, or extension UI.',
+            'After this response, omit globalRulesAckKey in the same MCP process session or pass it explicitly for backward compatibility.',
         ],
         globalRules: includeGlobal ? GLOBAL_RULES_SECTIONS : undefined,
         dynamicServerCode: includeDynamic ? DYNAMIC_CODE_SECTIONS : undefined,
         extensions: includeExtensions ? EXTENSION_SECTIONS : undefined,
     };
     if (includeDynamic) {
-        payload.usage.push('Pass dynamicCodeAckKey exactly as knowledgeAckKey when calling MCP tools that create or update dynamic server code.');
+        payload.usage.push('After this response, omit knowledgeAckKey in the same MCP process session or pass dynamicCodeAckKey explicitly for backward compatibility.');
     }
     if (includeExtensions) {
-        payload.usage.push('Pass extensionAckKey exactly as extensionKnowledgeAckKey when calling MCP tools that create or update Enfyra extension code.');
+        payload.usage.push('After this response, omit extensionKnowledgeAckKey in the same MCP process session or pass extensionAckKey explicitly for backward compatibility.');
     }
     // Strip undefined keys
     Object.keys(payload).forEach((k) => {

package/dist/lib/required-knowledge.js.map

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

package/dist/lib/response-format.js

@@ -1,4 +1,5 @@
 import { recordMcpToolUsage } from './mcp-usage-telemetry.js';
+import { afterMcpToolExecution, beforeMcpToolExecution } from './session-safety.js';
 const RESPONSE_FORMAT = 'json+columnar-v1';
 const COLUMNAR_FORMAT = 'columnar-v1';
 const COMPRESSION_STATS_FIELD = 'compressionStats';
@@ -88,19 +89,6 @@ function buildCompressionStats(originalPayload, candidatePayload, selectedPayloa
         candidateSavedPercent,
     };
 }
-function attachCompressionStats(originalPayload, candidatePayload, selectedPayload, applied) {
-    if (!applied)
-        return selectedPayload;
-    if (isPlainObject(selectedPayload)
-        && selectedPayload.responseFormat === RESPONSE_FORMAT
-        && selectedPayload[COMPRESSION_STATS_FIELD]) {
-        return selectedPayload;
-    }
-    return {
-        ...selectedPayload,
-        [COMPRESSION_STATS_FIELD]: buildCompressionStats(originalPayload, candidatePayload, selectedPayload, applied),
-    };
-}
 function wrapPayload(payload) {
     if (!isPlainObject(payload)) {
         return {
@@ -113,11 +101,17 @@ function wrapPayload(payload) {
         ...payload,
     };
 }
-export function formatJsonPayload(payload) {
-    if (isPlainObject(payload)
-        && payload.responseFormat === RESPONSE_FORMAT
-        && payload[COMPRESSION_STATS_FIELD]) {
-        return payload;
+function formatJsonPayloadDetailed(payload) {
+    if (isPlainObject(payload) && payload.responseFormat === RESPONSE_FORMAT) {
+        const compressionStats = isPlainObject(payload[COMPRESSION_STATS_FIELD])
+            ? payload[COMPRESSION_STATS_FIELD]
+            : undefined;
+        if (compressionStats) {
+            const output = { ...payload };
+            delete output[COMPRESSION_STATS_FIELD];
+            return { payload: output, compressionStats };
+        }
+        return { payload, compressionStats: undefined };
     }
     const originalPayload = wrapPayload(payload);
     const columnarPayload = wrapPayload(toColumnar(payload));
@@ -125,14 +119,24 @@ export function formatJsonPayload(payload) {
     const candidateTokens = estimateTokens(safeJsonStringify(columnarPayload));
     const shouldApplyColumnar = candidateTokens < originalTokens;
     const selectedPayload = shouldApplyColumnar ? columnarPayload : originalPayload;
-    return attachCompressionStats(originalPayload, columnarPayload, selectedPayload, shouldApplyColumnar);
+    return {
+        payload: selectedPayload,
+        compressionStats: shouldApplyColumnar
+            ? buildCompressionStats(originalPayload, columnarPayload, selectedPayload, true)
+            : undefined,
+    };
+}
+export function formatJsonPayload(payload) {
+    return formatJsonPayloadDetailed(payload).payload;
 }
 export function jsonContent(payload, { pretty = false } = {}) {
+    const formatted = formatJsonPayloadDetailed(payload);
     return {
         content: [{
                 type: 'text',
-                text: JSON.stringify(formatJsonPayload(payload), null, pretty ? 2 : 0),
+                text: JSON.stringify(formatted.payload, null, pretty ? 2 : 0),
             }],
+        ...(formatted.compressionStats ? { _meta: { enfyraCompression: formatted.compressionStats } } : {}),
     };
 }
 function tryParseJson(text) {
@@ -150,21 +154,29 @@ function tryParseJson(text) {
 }
 function formatContentItem(item) {
     if (!item || item.type !== 'text')
-        return item;
+        return { item, compressionStats: undefined };
     const parsed = tryParseJson(item.text);
     if (!parsed)
-        return item;
+        return { item, compressionStats: undefined };
+    const formatted = formatJsonPayloadDetailed(parsed);
     return {
-        ...item,
-        text: JSON.stringify(formatJsonPayload(parsed)),
+        item: {
+            ...item,
+            text: JSON.stringify(formatted.payload),
+        },
+        compressionStats: formatted.compressionStats,
     };
 }
 export function formatToolResult(result) {
     if (!result || !Array.isArray(result.content))
         return result;
+    const formattedItems = result.content.map(formatContentItem);
+    const compressionStats = result?._meta?.enfyraCompression
+        || formattedItems.find((entry) => entry.compressionStats)?.compressionStats;
     return {
         ...result,
-        content: result.content.map(formatContentItem),
+        content: formattedItems.map((entry) => entry.item),
+        ...(compressionStats ? { _meta: { ...(result._meta || {}), enfyraCompression: compressionStats } } : {}),
     };
 }
 export function installColumnarToolFormatter(server) {
@@ -176,7 +188,9 @@ export function installColumnarToolFormatter(server) {
         return registerTool(name, description, schema, async (...args) => {
             const startedAt = Date.now();
             try {
+                beforeMcpToolExecution(name, args[0]);
                 const result = await handler(...args);
+                afterMcpToolExecution(name, args[0]);
                 const formatted = formatToolResult(result);
                 recordMcpToolUsage(name, startedAt, args, formatted);
                 return formatted;

package/dist/lib/response-format.js.map

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

package/dist/lib/runtime-zone-tools.d.ts

@@ -3,6 +3,20 @@ type RuntimeZone = typeof RUNTIME_ZONES[number];
 type RuntimeRecord = Record<string, any>;
 export declare const RUNTIME_ZONE_DESCRIPTIONS: Record<RuntimeZone, string>;
 export declare function searchRuntimeZone(apiUrl: string, input: any): Promise<{
+    action: string;
+    zones: {
+        name: "admin_ui" | "api_runtime" | "flow_runtime" | "websocket_runtime" | "graphql_runtime" | "schema_data" | "package_runtime" | "storage_file" | "auth_security";
+        description: string;
+        nextSearch: {
+            tool: string;
+            input: {
+                mode: string;
+                zone: "admin_ui" | "api_runtime" | "flow_runtime" | "websocket_runtime" | "graphql_runtime" | "schema_data" | "package_runtime" | "storage_file" | "auth_security";
+            };
+        };
+    }[];
+    guidance: string[];
+} | {
     action: string;
     zone: string;
     zoneDescription: string;

package/dist/lib/runtime-zone-tools.js

@@ -4,6 +4,7 @@ import { fetchMetadataTables, fetchTableCatalog, fetchTableMetadata, fetchTableM
 import { jsonContent } from './response-format.js';
 import { writeSourceArtifact } from './source-artifacts.js';
 import { inspectExtensionLocation, searchExtensions } from './extension-search-tools.js';
+import { normalizeSnippetChars } from './tool-input-normalization.js';
 const RUNTIME_ZONES = [
     'admin_ui',
     'api_runtime',
@@ -67,6 +68,23 @@ export const RUNTIME_ZONE_DESCRIPTIONS = {
     storage_file: 'Storage configs, folders, files, public file state, and file permissions.',
     auth_security: 'Users, roles, route/field permissions, guards, OAuth provider provisioning, and linked OAuth accounts.',
 };
+function buildRuntimeZoneCatalog() {
+    return {
+        action: 'runtime_zone_catalog',
+        zones: RUNTIME_ZONES.map((name) => ({
+            name,
+            description: RUNTIME_ZONE_DESCRIPTIONS[name],
+            nextSearch: {
+                tool: 'search_runtime_zone',
+                input: { mode: 'search', zone: name },
+            },
+        })),
+        guidance: [
+            'Choose one returned zone and call its nextSearch input.',
+            'Add query or path when you know a target. Keep them omitted for a bounded zone inventory.',
+        ],
+    };
+}
 function getId(record) {
     return record?.id ?? record?._id ?? null;
 }
@@ -266,11 +284,24 @@ function summarizeGenericRecord(zone, table, record, matches, includeSourceArtif
 async function searchSchemaZone(apiUrl, input) {
     const query = String(input.query ?? '').trim();
     const normalizedQuery = normalizeText(query);
+    const inventory = !normalizedQuery;
     const maxResults = Math.min(Math.max(Number(input.maxResults ?? 8), 1), 25);
     const catalog = await fetchTableCatalog(apiUrl);
     const tables = await fetchMetadataTables(apiUrl, catalog);
     const results = [];
     for (const table of tables) {
+        if (inventory) {
+            results.push({
+                zone: 'schema_data',
+                tableName: table.name,
+                id: getId(table),
+                alias: table.alias,
+                score: 0,
+                matches: [],
+                nextInspect: { tool: 'search_runtime_zone', input: { mode: 'inspect', zone: 'schema_data', tableName: table.name } },
+            });
+            continue;
+        }
         const tableMatches = [];
         for (const field of ['name', 'alias', 'description']) {
             const raw = flattenValue(table?.[field]);
@@ -304,7 +335,7 @@ async function searchSchemaZone(apiUrl, input) {
     }
     results.sort((a, b) => b.score - a.score || String(a.tableName).localeCompare(String(b.tableName)));
     return {
-        action: 'runtime_zone_searched',
+        action: inventory ? 'runtime_zone_inventory' : 'runtime_zone_searched',
         zone: 'schema_data',
         zoneDescription: RUNTIME_ZONE_DESCRIPTIONS.schema_data,
         query,
@@ -314,12 +345,15 @@ async function searchSchemaZone(apiUrl, input) {
     };
 }
 export async function searchRuntimeZone(apiUrl, input) {
+    const zone = input.zone;
+    if (!zone)
+        return buildRuntimeZoneCatalog();
     if ((input.mode ?? 'search') === 'inspect')
         return inspectRuntimeZoneLocation(apiUrl, input);
-    const zone = input.zone;
     if (!RUNTIME_ZONES.includes(zone))
         throw new Error(`Unsupported runtime zone: ${zone}`);
     if (zone === 'admin_ui') {
+        const inventory = !String(input.query ?? '').trim() && !String(input.path ?? '').trim();
         const adminResult = await searchExtensions(apiUrl, {
             query: input.query,
             path: input.path,
@@ -328,11 +362,11 @@ export async function searchRuntimeZone(apiUrl, input) {
             maxResults: input.maxResults,
             snippetChars: input.snippetChars,
             maxMatchesPerExtension: input.maxMatchesPerRecord,
-            includeSourceArtifact: input.includeSourceArtifact,
+            includeSourceArtifact: inventory ? false : input.includeSourceArtifact,
         });
         return {
             ...adminResult,
-            action: 'runtime_zone_searched',
+            action: inventory ? 'runtime_zone_inventory' : 'runtime_zone_searched',
             zone,
             zoneDescription: RUNTIME_ZONE_DESCRIPTIONS.admin_ui,
             results: (adminResult.results ?? []).map((item) => ({
@@ -348,12 +382,11 @@ export async function searchRuntimeZone(apiUrl, input) {
     if (zone === 'schema_data')
         return searchSchemaZone(apiUrl, input);
     const query = String(input.query ?? input.path ?? '').trim();
-    if (!query)
-        throw new Error('query or path is required for this runtime zone.');
     const path = input.path ? String(input.path).trim() : '';
+    const inventory = !query && !path;
     const maxResults = Math.min(Math.max(Number(input.maxResults ?? 8), 1), 25);
-    const snippetChars = Math.min(Math.max(Number(input.snippetChars ?? 180), 120), 600);
-    const includeSourceArtifact = Boolean(input.includeSourceArtifact);
+    const snippetChars = normalizeSnippetChars(input.snippetChars);
+    const includeSourceArtifact = inventory ? false : Boolean(input.includeSourceArtifact);
     const tables = ZONE_TABLES[zone];
     const allResults = [];
     const errors = [];
@@ -364,6 +397,10 @@ export async function searchRuntimeZone(apiUrl, input) {
             continue;
         }
         for (const record of records) {
+            if (inventory) {
+                allResults.push(summarizeGenericRecord(zone, table, record, [], false));
+                continue;
+            }
             if (path) {
                 const pathHit = (table.pathFields ?? []).some((field) => flattenValue(valueAt(record, field)) === path);
                 if (!pathHit)
@@ -381,7 +418,7 @@ export async function searchRuntimeZone(apiUrl, input) {
     allResults.sort((a, b) => b.score - a.score || String(a.tableName).localeCompare(String(b.tableName)));
     const results = allResults.slice(0, maxResults);
     return {
-        action: 'runtime_zone_searched',
+        action: inventory ? 'runtime_zone_inventory' : 'runtime_zone_searched',
         zone,
         zoneDescription: RUNTIME_ZONE_DESCRIPTIONS[zone],
         query: query || null,
@@ -396,6 +433,7 @@ export async function searchRuntimeZone(apiUrl, input) {
         },
         guidance: [
             'Use the returned nextInspect input on search_runtime_zone(mode=inspect) for the best candidate before editing.',
+            ...(inventory ? ['This is a bounded inventory. Add query or path when you need ranked matching.'] : []),
             'Use source artifacts only for the selected candidate when snippets are insufficient.',
             'Use zone-specific write tools after inspection instead of generic CRUD when a business operation tool exists.',
         ],
@@ -560,7 +598,7 @@ export async function inspectRuntimeZoneLocation(apiUrl, input) {
         sources,
         nextSteps: [
             'Use zone-specific edit tools where available.',
-            'For source edits, use get_script_source/patch_script_source/update_script_source when the table is script-backed.',
+            'When sources are returned, use those exact artifacts. Call get_script_source only with this concrete record id when a fresh source artifact is needed.',
             'Re-run search_runtime_zone or the specific inspector after mutation.',
         ],
     };
@@ -578,7 +616,7 @@ export function registerRuntimeZoneTools(server, ENFYRA_API_URL) {
         type: z.enum(['page', 'widget', 'global']).optional().describe('Narrows extension type.'),
         includeDisabled: z.boolean().optional().default(true),
         maxResults: z.number().int().min(1).max(25).optional().default(8),
-        snippetChars: z.number().int().min(120).max(600).optional().default(180),
+        snippetChars: z.number().int().optional().default(180).transform(normalizeSnippetChars).describe('Approximate snippet characters per match. Values outside 120-600 are clamped.'),
         includeSourceArtifact: z.boolean().optional().default(false),
     }, async (input) => jsonContent(await searchAdminExtensions(ENFYRA_API_URL, input)));
     server.tool('debug_field_exposure', [
@@ -597,11 +635,11 @@ export function registerRuntimeZoneTools(server, ENFYRA_API_URL) {
     server.tool('search_runtime_zone', [
         'Single zone-scoped search/inspect tool for DB-backed Enfyra runtime artifacts.',
         'Use this before editing anything that lives in the database rather than repo files.',
-        'Choose a zone first so the output stays precise and token-bounded. Use mode=search first, then call this same tool with mode=inspect using nextInspect.input.',
+        'Omit zone once when the correct zone is unclear; the tool returns a compact zone catalog. With a zone, omit query/path for bounded inventory or provide either value for ranked matching. Then call mode=inspect using nextInspect.input.',
     ].join(' '), {
-        mode: z.enum(['search', 'inspect']).optional().default('search').describe('search returns ranked matches. inspect opens one result using tableName/id or admin UI name/path/query.'),
-        zone: z.enum(RUNTIME_ZONES).describe('DB-backed runtime zone to search. admin_ui=menu/extensions, api_runtime=routes/handlers/hooks/guards, flow_runtime=flows, websocket_runtime=socket gateways/events, graphql_runtime=GraphQL, schema_data=tables/fields/relations, package_runtime=packages, storage_file=storage/files, auth_security=access/auth.'),
-        query: z.string().optional().describe('Visible label, path, event name, flow step key, route path, source-code term, field name, package name, or config keyword.'),
+        mode: z.enum(['search', 'inspect']).optional().default('search').describe('search returns a zone catalog, bounded inventory, or ranked matches. inspect opens one result using nextInspect.input.'),
+        zone: z.enum(RUNTIME_ZONES).optional().describe('DB-backed runtime zone. Omit only when the correct zone is unclear; the result returns the zone catalog. admin_ui=menu/extensions, api_runtime=routes/handlers/hooks/guards, flow_runtime=flows, websocket_runtime=socket gateways/events, graphql_runtime=GraphQL, schema_data=tables/fields/relations, package_runtime=packages, storage_file=storage/files, auth_security=access/auth.'),
+        query: z.string().optional().describe('Visible label, path, event name, flow step key, route path, source-code term, field name, package name, or config keyword. Omit with a selected zone for bounded inventory.'),
         path: z.string().optional().describe('Exact route/gateway/menu/file path where the zone supports path lookup.'),
         tableName: z.string().optional().describe('Required for mode=inspect on non-admin zones; use nextInspect.input from search results.'),
         id: z.union([z.string(), z.number()]).optional().describe('Record id for mode=inspect; use nextInspect.input from search results.'),
@@ -609,7 +647,7 @@ export function registerRuntimeZoneTools(server, ENFYRA_API_URL) {
         extensionType: z.enum(['page', 'widget', 'global']).optional().describe('Only for admin_ui zone. Narrows extension type.'),
         includeDisabled: z.boolean().optional().default(true).describe('Only for admin_ui zone. Include disabled extensions.'),
         maxResults: z.number().int().min(1).max(25).optional().default(8).describe('Maximum ranked results.'),
-        snippetChars: z.number().int().min(120).max(600).optional().default(180).describe('Approximate snippet characters per match.'),
+        snippetChars: z.number().int().optional().default(180).transform(normalizeSnippetChars).describe('Approximate snippet characters per match. Values outside 120-600 are clamped.'),
         maxMatchesPerRecord: z.number().int().min(1).max(8).optional().default(2).describe('Only for admin_ui zone. Maximum source matches per extension.'),
         includeSourceArtifact: z.boolean().optional().default(false).describe('Write matched source to /tmp and return compact source artifact metadata. Prefer false unless snippets are insufficient.'),
     }, async (input) => jsonContent(await searchRuntimeZone(ENFYRA_API_URL, input)));