@jsonstudio/llms 0.6.2979 → 0.6.3238

package/dist/conversion/hub/pipeline/stages/resp_process/resp_process_stage1_tool_governance/index.js

@@ -3,13 +3,28 @@ import { buildChatResponseFromResponses } from '../../../../../shared/responses-
 import { normalizeAssistantTextToToolCalls } from '../../../../../shared/text-markup-normalizer.js';
 import { recordStage } from '../../../stages/utils.js';
 import { applyRespProcessToolGovernanceWithNative, stripOrphanFunctionCallsTagWithNative } from '../../../../../../router/virtual-router/engine-selection/native-chat-process-governance-semantics.js';
-const TOOL_CALL_JSON_MARKER = /["']tool_calls["']\s*:/i;
 const SHELL_TOOL_NAME_ALIASES = {
     shell_command: 'exec_command',
     shell: 'exec_command',
     bash: 'exec_command',
     terminal: 'exec_command'
 };
+/**
+ * Unified text-to-tool-calls harvest config.
+ * Shared across all providers via chat process tool governance.
+ */
+const DEFAULT_TEXT_NORMALIZER_CONFIG = {
+    jsonToolRepair: {
+        toolNameAliases: SHELL_TOOL_NAME_ALIASES,
+        argumentAliases: {
+            exec_command: {
+                cmd: ['cmd', 'command', 'input.command', 'script'],
+                command: ['cmd', 'command', 'input.command', 'script'],
+                workdir: ['workdir', 'cwd', 'input.cwd']
+            }
+        }
+    }
+};
 function isCanonicalChatCompletion(payload) {
     if (!payload || typeof payload !== 'object' || Array.isArray(payload)) {
         return false;
@@ -42,7 +57,11 @@ function coerceToCanonicalChatCompletion(payload) {
     }
     return payload;
 }
-function maybeHarvestEmptyToolCallsFromJsonContent(payload) {
+/**
+ * Harvest tool calls from assistant text content when native tool_calls are missing or empty.
+ * This is the single entry point for text-based tool call extraction across all providers.
+ */
+function harvestToolCallsFromText(payload) {
     if (!payload || typeof payload !== 'object') {
         return payload;
     }
@@ -50,6 +69,7 @@ function maybeHarvestEmptyToolCallsFromJsonContent(payload) {
     if (!choices.length) {
         return payload;
     }
+    let changed = false;
     for (const choice of choices) {
         if (!choice || typeof choice !== 'object' || Array.isArray(choice)) {
             continue;
@@ -58,37 +78,29 @@ function maybeHarvestEmptyToolCallsFromJsonContent(payload) {
         if (!message || typeof message !== 'object' || Array.isArray(message)) {
             continue;
         }
-        const toolCalls = Array.isArray(message.tool_calls) ? message.tool_calls : undefined;
-        if (!toolCalls || toolCalls.length !== 0) {
+        // Skip if already has native tool_calls
+        const existingToolCalls = Array.isArray(message.tool_calls) ? message.tool_calls : undefined;
+        if (existingToolCalls && existingToolCalls.length > 0) {
             continue;
         }
-        const content = typeof message.content === 'string' ? String(message.content).trim() : '';
-        if (!content || !TOOL_CALL_JSON_MARKER.test(content)) {
-            continue;
-        }
-        const normalized = normalizeAssistantTextToToolCalls(message, {
-            jsonToolRepair: {
-                toolNameAliases: SHELL_TOOL_NAME_ALIASES,
-                argumentAliases: {
-                    exec_command: {
-                        cmd: ['cmd', 'command', 'input.command', 'script'],
-                        command: ['cmd', 'command', 'input.command', 'script'],
-                        workdir: ['workdir', 'cwd', 'input.cwd']
-                    }
-                }
+        // Try to harvest from text content
+        const normalized = normalizeAssistantTextToToolCalls(message, DEFAULT_TEXT_NORMALIZER_CONFIG);
+        const harvestedCalls = Array.isArray(normalized.tool_calls)
+            ? normalized.tool_calls
+            : [];
+        if (harvestedCalls.length > 0) {
+            choice.message = normalized;
+            changed = true;
+            // Update finish_reason if needed
+            const finish = typeof choice.finish_reason === 'string'
+                ? String(choice.finish_reason).trim().toLowerCase()
+                : '';
+            if (!finish || finish === 'stop') {
+                choice.finish_reason = 'tool_calls';
             }
-        });
-        const repairedCalls = Array.isArray(normalized.tool_calls) ? normalized.tool_calls : [];
-        if (!repairedCalls.length) {
-            continue;
-        }
-        choice.message = normalized;
-        const finish = typeof choice.finish_reason === 'string' ? String(choice.finish_reason).trim().toLowerCase() : '';
-        if (!finish || finish === 'stop') {
-            choice.finish_reason = 'tool_calls';
         }
     }
-    return payload;
+    return changed ? payload : payload;
 }
 function sanitizeResponseShapeBeforeGovernance(payload) {
     return stripOrphanFunctionCallsTagWithNative(payload);
@@ -96,7 +108,8 @@ function sanitizeResponseShapeBeforeGovernance(payload) {
 export async function runRespProcessStage1ToolGovernance(options) {
     const canonicalInput = coerceToCanonicalChatCompletion(options.payload);
     const shapeSanitizedInput = sanitizeResponseShapeBeforeGovernance(canonicalInput);
-    maybeHarvestEmptyToolCallsFromJsonContent(shapeSanitizedInput);
+    // Single entry point for text-to-tool-calls harvest across all providers
+    harvestToolCallsFromText(shapeSanitizedInput);
     recordStage(options.stageRecorder, 'chat_process.resp.stage6.canonicalize_chat_completion', {
         converted: canonicalInput !== options.payload,
         shapeSanitized: shapeSanitizedInput !== canonicalInput,

package/dist/conversion/hub/pipeline/stages/resp_process/resp_process_stage2_finalize/index.js

@@ -1,7 +1,19 @@
 import { buildProcessedRequestFromChatResponse } from '../../../../response/chat-response-utils.js';
 import { recordStage } from '../../../stages/utils.js';
 import { finalizeRespProcessChatResponseWithNative } from '../../../../../../router/virtual-router/engine-selection/native-chat-process-governance-semantics.js';
+import { normalizeReasoningInChatPayload } from '../../../../../shared/reasoning-normalizer.js';
 export async function runRespProcessStage2Finalize(options) {
+    const endpoint = (options.entryEndpoint || '').toLowerCase();
+    const wantsAnthropicReasoning = endpoint.includes('/v1/messages');
+    const shouldNormalize = (options.reasoningMode && options.reasoningMode !== 'keep') || wantsAnthropicReasoning;
+    if (shouldNormalize) {
+        try {
+            normalizeReasoningInChatPayload(options.payload);
+        }
+        catch {
+            // best-effort inline reasoning extraction
+        }
+    }
     const finalized = (await finalizeRespProcessChatResponseWithNative({
         payload: options.payload,
         stream: options.wantsStream,

package/dist/conversion/hub/policy/protocol-spec.js

@@ -1,4 +1,4 @@
-import { ANTHROPIC_ALLOWED_FIELDS, ANTHROPIC_PARAMETERS_WRAPPER_ALLOW_KEYS, GEMINI_ALLOWED_FIELDS, OPENAI_CHAT_ALLOWED_FIELDS, OPENAI_CHAT_PARAMETERS_WRAPPER_ALLOW_KEYS, OPENAI_RESPONSES_ALLOWED_FIELDS, OPENAI_RESPONSES_PARAMETERS_WRAPPER_ALLOW_KEYS } from '../../shared/protocol-field-allowlists.js';
+import { ANTHROPIC_ALLOWED_FIELDS, ANTHROPIC_PARAMETERS_WRAPPER_ALLOW_KEYS, GEMINI_ALLOWED_FIELDS, OPENAI_CHAT_ALLOWED_FIELDS, OPENAI_CHAT_PARAMETERS_WRAPPER_ALLOW_KEYS, OPENAI_RESPONSES_ALLOWED_FIELDS, OPENAI_RESPONSES_PARAMETERS_WRAPPER_ALLOW_KEYS } from '../../protocol-field-allowlists.js';
 import { resolveHubProtocolSpecWithNative } from '../../../router/virtual-router/engine-selection/native-hub-bridge-policy-semantics.js';
 const ALLOWLISTS = {
     openaiChatAllowedFields: OPENAI_CHAT_ALLOWED_FIELDS,

package/dist/conversion/hub/process/chat-process-clock-reminders.js

@@ -1,4 +1,4 @@
-import { readRuntimeMetadata } from '../../shared/runtime-metadata.js';
+import { readRuntimeMetadata } from '../../runtime-metadata.js';
 import { clearClockSession, resolveClockConfig, startClockDaemonIfNeeded } from '../../../servertool/clock/task-store.js';
 import { logClock } from '../../../servertool/clock/log.js';
 import { resolveClockSessionScope } from '../../../servertool/clock/session-scope.js';

package/dist/conversion/hub/process/chat-process-clock-tools.js

@@ -1,4 +1,4 @@
-import { readRuntimeMetadata } from '../../shared/runtime-metadata.js';
+import { readRuntimeMetadata } from '../../runtime-metadata.js';
 import { logClock } from '../../../servertool/clock/log.js';
 import { buildClockStandardToolAppendOperations, buildClockToolAppendOperations } from './chat-process-clock-tool-schemas.js';
 import { planChatClockOperationsWithNative } from '../../../router/virtual-router/engine-selection/native-chat-process-servertool-orchestration-semantics.js';

package/dist/conversion/hub/process/chat-process-continue-execution.js

@@ -1,4 +1,4 @@
-import { readRuntimeMetadata } from '../../shared/runtime-metadata.js';
+import { readRuntimeMetadata } from '../../runtime-metadata.js';
 import { loadRoutingInstructionStateSync } from '../../../router/virtual-router/sticky-session-store.js';
 import { logContinueExecution } from '../../../servertool/continue-execution/log.js';
 import { buildContinueExecutionOperationsWithNative, injectContinueExecutionDirectiveWithNative, planContinueExecutionOperationsWithNative, resolveHasActiveStopMessageForContinueExecutionWithNative, resolveStopMessageSessionScopeWithNative } from '../../../router/virtual-router/engine-selection/native-chat-process-servertool-orchestration-semantics.js';

package/dist/conversion/hub/process/chat-process-servertool-orchestration.js

@@ -4,7 +4,7 @@ import { buildWebSearchOperations } from './chat-process-web-search.js';
 import { buildClockOperationsWithPlan } from './chat-process-clock-tools.js';
 import { buildReviewOperations } from './chat-process-review.js';
 import { maybeInjectClockRemindersAndApplyDirectives } from './chat-process-clock-reminders.js';
-import { readRuntimeMetadata } from '../../shared/runtime-metadata.js';
+import { readRuntimeMetadata } from '../../runtime-metadata.js';
 import { tryPlanChatServerToolBundleWithNative } from '../../../router/virtual-router/engine-selection/native-chat-process-servertool-orchestration-semantics.js';
 export async function applyServerToolOrchestration(options) {
     let request = options.request;

package/dist/conversion/hub/process/chat-process-web-search.js

@@ -1,4 +1,4 @@
-import { readRuntimeMetadata } from '../../shared/runtime-metadata.js';
+import { readRuntimeMetadata } from '../../runtime-metadata.js';
 import { buildWebSearchToolAppendOperations } from './chat-process-web-search-tool-schema.js';
 import { planChatWebSearchOperationsWithNative } from '../../../router/virtual-router/engine-selection/native-chat-process-servertool-orchestration-semantics.js';
 export function buildWebSearchOperations(request, metadata, precomputedPlan) {

package/dist/conversion/hub/response/provider-response.js

@@ -15,8 +15,8 @@ import { runRespProcessStage3ServerToolOrchestration } from '../pipeline/stages/
 import { runRespOutboundStage1ClientRemap } from '../pipeline/stages/resp_outbound/resp_outbound_stage1_client_remap/index.js';
 import { runRespOutboundStage2SseStream } from '../pipeline/stages/resp_outbound/resp_outbound_stage2_sse_stream/index.js';
 import { recordResponsesResponse } from '../../shared/responses-conversation-store.js';
-import { ProviderProtocolError } from '../../shared/errors.js';
-import { readRuntimeMetadata } from '../../shared/runtime-metadata.js';
+import { ProviderProtocolError } from '../../provider-protocol-error.js';
+import { readRuntimeMetadata } from '../../runtime-metadata.js';
 import { commitClockReservation, resolveClockConfig } from '../../../servertool/clock/task-store.js';
 import { detectProviderResponseShapeWithNative } from '../../../router/virtual-router/engine-selection/native-chat-process-servertool-orchestration-semantics.js';
 const PROVIDER_RESPONSE_REGISTRY = {
@@ -260,8 +260,11 @@ function applyModelOverride(payload, model) {
         /* ignore */
     }
 }
-function resolveChatReasoningMode(_entryEndpoint) {
-    // 当前保持默认策略：保留 reasoning_content 字段，不做额外拼接或删除。
+function resolveChatReasoningMode(entryEndpoint) {
+    const lowered = (entryEndpoint || '').toLowerCase();
+    if (lowered.includes('/v1/chat/completions')) {
+        return 'keep';
+    }
     return 'keep';
 }
 export async function convertProviderResponse(options) {
@@ -449,7 +452,13 @@ export async function convertProviderResponse(options) {
     // Commit scheduled-task delivery only after a successful client payload/stream is prepared.
     await maybeCommitClockReservationFromContext(options.context);
     if (outbound.stream) {
-        return { __sse_responses: outbound.stream, format: clientProtocol };
+        const usage = clientPayload && typeof clientPayload === 'object' && !Array.isArray(clientPayload)
+            ? clientPayload.usage
+            : undefined;
+        const body = usage !== undefined
+            ? { usage }
+            : undefined;
+        return { __sse_responses: outbound.stream, body, format: clientProtocol };
     }
     return { body: clientPayload, format: clientProtocol };
 }

package/dist/conversion/hub/response/response-mappers.js

@@ -2,9 +2,31 @@ import { buildOpenAIChatFromGeminiResponse } from '../../codecs/gemini-openai-co
 import { buildChatResponseFromResponses } from '../../shared/responses-response-utils.js';
 import { buildOpenAIChatFromAnthropicMessage } from './response-runtime.js';
 import { resolveAliasMapFromRespSemanticsWithNative } from '../../../router/virtual-router/engine-selection/native-hub-pipeline-resp-semantics.js';
+function injectResponsesReasoningExtension(payload) {
+    if (payload.__responses_reasoning) {
+        return;
+    }
+    const choices = Array.isArray(payload.choices) ? payload.choices : [];
+    const primary = choices[0] && typeof choices[0] === 'object' ? choices[0] : undefined;
+    const message = primary && typeof primary.message === 'object' ? primary.message : undefined;
+    if (!message)
+        return;
+    const reasoningText = typeof message.reasoning_content === 'string' && message.reasoning_content.trim().length
+        ? String(message.reasoning_content).trim()
+        : undefined;
+    if (!reasoningText)
+        return;
+    payload.__responses_reasoning = {
+        content: [{ type: 'reasoning_text', text: reasoningText }]
+    };
+}
 export class OpenAIChatResponseMapper {
     toChatCompletion(format, _ctx) {
-        return (format.payload ?? {});
+        const payload = (format.payload ?? {});
+        if (payload && typeof payload === 'object') {
+            injectResponsesReasoningExtension(payload);
+        }
+        return payload;
     }
 }
 export class ResponsesResponseMapper {

package/dist/conversion/hub/response/response-runtime.js

@@ -1,7 +1,7 @@
 import { extractToolCallsFromReasoningText } from '../../shared/reasoning-tool-parser.js';
 import { deriveToolCallKey } from '../../shared/tool-call-utils.js';
-import { createBridgeActionState, runBridgeActionPipeline } from '../../shared/bridge-actions.js';
-import { resolveBridgePolicy, resolvePolicyActions } from '../../shared/bridge-policies.js';
+import { createBridgeActionState, runBridgeActionPipeline } from '../../bridge-actions.js';
+import { resolveBridgePolicy, resolvePolicyActions } from '../../bridge-policies.js';
 import { normalizeAnthropicToolName } from '../../shared/anthropic-message-utils.js';
 import { buildAnthropicResponseFromChatWithNative } from '../../../router/virtual-router/engine-selection/native-hub-pipeline-resp-semantics.js';
 import { registerResponsesReasoning, consumeResponsesReasoning, registerResponsesOutputTextMeta, consumeResponsesOutputTextMeta, consumeResponsesPayloadSnapshot, registerResponsesPayloadSnapshot, consumeResponsesPassthrough, registerResponsesPassthrough } from '../../shared/responses-reasoning-registry.js';
@@ -153,7 +153,20 @@ export function buildOpenAIChatFromAnthropicMessage(payload, options) {
             continue;
         const kind = String(part.type || '').toLowerCase();
         if (kind === 'text' && typeof part.text === 'string') {
-            textParts.push(part.text);
+            const rawText = part.text;
+            if (/<\s*(tool_call|function_call)\b|\[\s*(tool_call|function_call)\b/i.test(rawText)) {
+                const { cleanedText, toolCalls: inferred } = extractToolCallsFromReasoningText(rawText, { idPrefix: 'anthropic_text' });
+                const trimmed = cleanedText.trim();
+                if (trimmed.length) {
+                    textParts.push(trimmed);
+                }
+                if (Array.isArray(inferred) && inferred.length) {
+                    inferredToolCalls.push(...inferred);
+                }
+            }
+            else {
+                textParts.push(rawText);
+            }
         }
         else if (kind === 'tool_use') {
             const rawName = typeof part.name === 'string'
@@ -278,10 +291,18 @@ export function buildOpenAIChatFromAnthropicMessage(payload, options) {
             ? payload['usage']
             : undefined
     };
+    const localReasoning = reasoningParts.length
+        ? {
+            content: reasoningParts.map((text) => ({ type: 'reasoning_text', text }))
+        }
+        : undefined;
     const preserved = consumeResponsesReasoning(chatResponse.id);
-    if (preserved && preserved.length) {
+    if (preserved) {
         chatResponse.__responses_reasoning = preserved;
     }
+    else if (localReasoning) {
+        chatResponse.__responses_reasoning = localReasoning;
+    }
     const preservedOutputMeta = consumeResponsesOutputTextMeta(chatResponse.id);
     if (preservedOutputMeta) {
         chatResponse.__responses_output_text_meta = preservedOutputMeta;
@@ -289,6 +310,7 @@ export function buildOpenAIChatFromAnthropicMessage(payload, options) {
     const payloadSnapshot = consumeResponsesPayloadSnapshot(chatResponse.id);
     if (payloadSnapshot) {
         registerResponsesPayloadSnapshot(chatResponse.id, payloadSnapshot);
+        chatResponse.__responses_payload_snapshot = payloadSnapshot;
         if (typeof chatResponse.request_id !== 'string') {
             chatResponse.request_id = chatResponse.id;
         }
@@ -296,6 +318,7 @@ export function buildOpenAIChatFromAnthropicMessage(payload, options) {
     const passthroughPayload = consumeResponsesPassthrough(chatResponse.id);
     if (passthroughPayload) {
         registerResponsesPassthrough(chatResponse.id, passthroughPayload);
+        chatResponse.__responses_passthrough = passthroughPayload;
         if (typeof chatResponse.request_id !== 'string') {
             chatResponse.request_id = chatResponse.id;
         }
@@ -372,7 +395,7 @@ export function buildAnthropicResponseFromChat(chatResponse, options) {
         }
     }
     const sanitized = buildAnthropicResponseFromChatWithNative(chatResponse, aliasMap);
-    if (Array.isArray(chatResponse?.__responses_reasoning)) {
+    if (chatResponse?.__responses_reasoning) {
         registerResponsesReasoning(sanitized.id, chatResponse.__responses_reasoning);
     }
     if (chatResponse?.__responses_output_text_meta) {

package/dist/conversion/hub/snapshot-recorder.js

@@ -1,6 +1,5 @@
-import { createSnapshotWriter } from '../shared/snapshot-utils.js';
-import { jsonClone } from './types/json.js';
-import { parseLenientJsonishWithNative } from '../../router/virtual-router/engine-selection/native-shared-conversion-semantics.js';
+import { createSnapshotWriter } from '../snapshot-utils.js';
+import { normalizeSnapshotStagePayloadWithNative } from '../../router/virtual-router/engine-selection/native-snapshot-hooks.js';
 export class SnapshotStageRecorder {
     options;
     writer;
@@ -22,7 +21,7 @@ export class SnapshotStageRecorder {
         if (!this.writer) {
             return;
         }
-        const normalized = normalizeStagePayload(stage, payload);
+        const normalized = normalizeSnapshotStagePayloadWithNative(stage, payload);
         if (!normalized) {
             return;
         }
@@ -37,91 +36,3 @@ export class SnapshotStageRecorder {
 export function createSnapshotRecorder(context, endpoint) {
     return new SnapshotStageRecorder({ context, endpoint });
 }
-const STAGE_KIND_MAP = {
-    req_inbound_stage2_semantic_map: 'request_inbound',
-    'chat_process.req.stage2.semantic_map': 'request_inbound',
-    req_outbound_stage1_semantic_map: 'request_outbound',
-    'chat_process.req.stage6.outbound.semantic_map': 'request_outbound',
-    resp_inbound_stage3_semantic_map: 'response_inbound',
-    'chat_process.resp.stage4.semantic_map_to_chat': 'response_inbound',
-    resp_outbound_stage1_client_remap: 'response_outbound',
-    'chat_process.resp.stage9.client_remap': 'response_outbound'
-};
-function normalizeStagePayload(stage, payload) {
-    const kind = STAGE_KIND_MAP[stage];
-    if (!kind) {
-        return payload;
-    }
-    if ((kind === 'request_inbound' || kind === 'request_outbound') && isChatEnvelope(payload)) {
-        return buildOpenAIChatSnapshot(payload);
-    }
-    if (kind === 'response_inbound' || kind === 'response_outbound') {
-        return cloneJson(payload);
-    }
-    return payload;
-}
-function isChatEnvelope(value) {
-    return Boolean(value &&
-        typeof value === 'object' &&
-        Array.isArray(value.messages) &&
-        value.metadata &&
-        typeof value.metadata === 'object');
-}
-function buildOpenAIChatSnapshot(envelope) {
-    const snapshot = {};
-    if (envelope.parameters && Object.keys(envelope.parameters).length) {
-        Object.assign(snapshot, jsonClone(envelope.parameters));
-    }
-    snapshot.messages = jsonClone(envelope.messages);
-    if (envelope.tools && envelope.tools.length) {
-        snapshot.tools = jsonClone(envelope.tools);
-    }
-    if (envelope.toolOutputs && envelope.toolOutputs.length) {
-        snapshot.tool_outputs = jsonClone(envelope.toolOutputs);
-    }
-    const meta = buildMetaSnapshot(envelope.metadata);
-    if (meta) {
-        snapshot.meta = meta;
-    }
-    return snapshot;
-}
-function buildMetaSnapshot(metadata) {
-    const meta = {};
-    if (metadata.context) {
-        meta.context = jsonClone(metadata.context);
-    }
-    if (Array.isArray(metadata.missingFields) && metadata.missingFields.length) {
-        meta.missing_fields = jsonClone(metadata.missingFields);
-    }
-    const extraKeys = Object.keys(metadata).filter((key) => key !== 'context' && key !== 'missingFields');
-    if (extraKeys.length) {
-        const extras = {};
-        for (const key of extraKeys) {
-            const value = metadata[key];
-            if (value !== undefined) {
-                extras[key] = jsonClone(value);
-            }
-        }
-        if (Object.keys(extras).length) {
-            meta.extra = extras;
-        }
-    }
-    return Object.keys(meta).length ? meta : undefined;
-}
-function cloneJson(payload) {
-    try {
-        const nativeCloned = parseLenientJsonishWithNative(payload);
-        if (nativeCloned && typeof nativeCloned === 'object' && !Array.isArray(nativeCloned)) {
-            return nativeCloned;
-        }
-    }
-    catch {
-        // native clone is best-effort
-    }
-    try {
-        return JSON.parse(JSON.stringify(payload));
-    }
-    catch {
-        return payload;
-    }
-}

package/dist/conversion/hub/tool-governance/engine.d.ts

@@ -1,6 +1,14 @@
 import type { JsonObject } from '../types/json.js';
 import type { StandardizedRequest } from '../types/standardized.js';
 import type { GovernedChatCompletionPayload, GovernedStandardizedRequest, ToolGovernanceProtocol, ToolGovernanceRegistry } from './types.js';
+/**
+ * Hybrid governance engine:
+ * - request path: native-primary
+ * - response path: native-primary
+ *
+ * Legacy-only snapshot retained at:
+ * - src/conversion/hub/tool-governance/archive/engine.legacy.ts
+ */
 export declare class ToolGovernanceError extends Error {
     readonly protocol: ToolGovernanceProtocol;
     readonly direction: 'request' | 'response';