vgxness 1.20.4 → 1.20.6

package/dist/interfaces/mcp/validation/skills.js

@@ -0,0 +1,685 @@
+import { agentModes, copyOptionalStrings, copyRequiredStrings, inputRecord, payloadModes, readNonEmptyString, readOptionalBoundedLimit, readOptionalJsonObject, readOptionalNonEmptyString, readOptionalOneOf, readOptionalStringArray, readRequiredOneOf, readSkillLifecycleActor, readSkillSource, scopes, skillAttachmentTargetTypes, skillEvaluationRequestStatuses, skillImprovementProposalStatuses, skillSourceKinds, skillUsageOutcomes, skillVersionStatuses, validationFailure, } from './common.js';
+export function validateSkillIndexInput(input, tool) {
+    const record = inputRecord(input, tool, ['project', 'scope']);
+    if (!record.ok)
+        return record;
+    const project = readNonEmptyString(record.value, 'project', tool);
+    if (!project.ok)
+        return project;
+    const scope = readRequiredOneOf(record.value, 'scope', scopes, tool);
+    if (!scope.ok)
+        return scope;
+    return { ok: true, value: { project: project.value, scope: scope.value } };
+}
+export function validateSkillSearchInput(input, tool) {
+    const record = inputRecord(input, tool, ['project', 'scope', 'query', 'status', 'sourceKind', 'limit']);
+    if (!record.ok)
+        return record;
+    const project = readNonEmptyString(record.value, 'project', tool);
+    if (!project.ok)
+        return project;
+    const result = { project: project.value };
+    const scope = readOptionalOneOf(record.value, 'scope', scopes, tool);
+    if (!scope.ok)
+        return scope;
+    if (scope.value !== undefined)
+        result.scope = scope.value;
+    const query = readOptionalNonEmptyString(record.value, 'query', tool);
+    if (!query.ok)
+        return query;
+    if (query.value !== undefined)
+        result.query = query.value;
+    const status = readOptionalOneOf(record.value, 'status', skillVersionStatuses, tool);
+    if (!status.ok)
+        return status;
+    if (status.value !== undefined)
+        result.status = status.value;
+    const sourceKind = readOptionalOneOf(record.value, 'sourceKind', skillSourceKinds, tool);
+    if (!sourceKind.ok)
+        return sourceKind;
+    if (sourceKind.value !== undefined)
+        result.sourceKind = sourceKind.value;
+    if (record.value.limit !== undefined) {
+        const limit = record.value.limit;
+        if (typeof limit !== 'number' || !Number.isSafeInteger(limit) || limit < 1 || limit > 100)
+            return validationFailure('limit must be an integer between 1 and 100', tool);
+        result.limit = limit;
+    }
+    return { ok: true, value: result };
+}
+export function validateSkillGetInput(input, tool) {
+    const record = inputRecord(input, tool, ['project', 'scope', 'id', 'name', 'includeUsage']);
+    if (!record.ok)
+        return record;
+    const project = readNonEmptyString(record.value, 'project', tool);
+    if (!project.ok)
+        return project;
+    const result = { project: project.value };
+    const scope = readOptionalOneOf(record.value, 'scope', scopes, tool);
+    if (!scope.ok)
+        return scope;
+    if (scope.value !== undefined)
+        result.scope = scope.value;
+    const id = readOptionalNonEmptyString(record.value, 'id', tool);
+    if (!id.ok)
+        return id;
+    if (id.value !== undefined)
+        result.id = id.value;
+    const name = readOptionalNonEmptyString(record.value, 'name', tool);
+    if (!name.ok)
+        return name;
+    if (name.value !== undefined)
+        result.name = name.value;
+    if (result.id === undefined && result.name === undefined)
+        return validationFailure('Either id or name is required', tool);
+    if (record.value.includeUsage !== undefined) {
+        if (typeof record.value.includeUsage !== 'boolean')
+            return validationFailure('includeUsage must be boolean', tool);
+        result.includeUsage = record.value.includeUsage;
+    }
+    return { ok: true, value: result };
+}
+export function validateSkillStatusInput(input, tool) {
+    const record = inputRecord(input, tool, ['project', 'scope', 'provider', 'mode', 'agent']);
+    if (!record.ok)
+        return record;
+    const project = readNonEmptyString(record.value, 'project', tool);
+    if (!project.ok)
+        return project;
+    const result = { project: project.value };
+    const scope = readOptionalOneOf(record.value, 'scope', scopes, tool);
+    if (!scope.ok)
+        return scope;
+    if (scope.value !== undefined)
+        result.scope = scope.value;
+    const mode = readOptionalOneOf(record.value, 'mode', agentModes, tool);
+    if (!mode.ok)
+        return mode;
+    if (mode.value !== undefined)
+        result.mode = mode.value;
+    const copied = copyOptionalStrings(result, record.value, tool, ['provider', 'agent']);
+    if (!copied.ok)
+        return copied;
+    return { ok: true, value: result };
+}
+export function validateSkillPayloadInput(input, tool) {
+    const record = inputRecord(input, tool, [
+        'workspaceRoot',
+        'maxSourceBytes',
+        'project',
+        'scope',
+        'agentId',
+        'agentName',
+        'workflow',
+        'phase',
+        'intentSignals',
+        'providerAdapter',
+        'runId',
+        'mode',
+    ]);
+    if (!record.ok)
+        return record;
+    const workspaceRoot = readNonEmptyString(record.value, 'workspaceRoot', tool);
+    if (!workspaceRoot.ok)
+        return workspaceRoot;
+    const result = { workspaceRoot: workspaceRoot.value };
+    const copied = copyOptionalStrings(result, record.value, tool, ['project', 'agentId', 'agentName', 'workflow', 'phase', 'providerAdapter', 'runId']);
+    if (!copied.ok)
+        return copied;
+    const intentSignals = readOptionalStringArray(record.value, 'intentSignals', tool);
+    if (!intentSignals.ok)
+        return intentSignals;
+    if (intentSignals.value !== undefined)
+        result.intentSignals = intentSignals.value;
+    const scope = readOptionalOneOf(record.value, 'scope', scopes, tool);
+    if (!scope.ok)
+        return scope;
+    if (scope.value !== undefined)
+        result.scope = scope.value;
+    const mode = readOptionalOneOf(record.value, 'mode', payloadModes, tool);
+    if (!mode.ok)
+        return mode;
+    if (mode.value !== undefined)
+        result.mode = mode.value;
+    if (record.value.maxSourceBytes !== undefined) {
+        const maxSourceBytes = record.value.maxSourceBytes;
+        if (typeof maxSourceBytes !== 'number' || !Number.isSafeInteger(maxSourceBytes) || maxSourceBytes <= 0)
+            return validationFailure('maxSourceBytes must be a positive safe integer', tool);
+        result.maxSourceBytes = maxSourceBytes;
+    }
+    return { ok: true, value: result };
+}
+export function validateSkillActivateInput(input, tool) {
+    const record = inputRecord(input, tool, [
+        'project',
+        'scope',
+        'skillId',
+        'name',
+        'versionId',
+        'version',
+        'runId',
+        'agentId',
+        'workflow',
+        'phase',
+        'providerAdapter',
+        'intent',
+        'reason',
+        'workspaceRoot',
+        'maxSourceBytes',
+        'mode',
+    ]);
+    if (!record.ok)
+        return record;
+    const project = readNonEmptyString(record.value, 'project', tool);
+    if (!project.ok)
+        return project;
+    const result = { project: project.value };
+    const copied = copyOptionalStrings(result, record.value, tool, [
+        'skillId',
+        'name',
+        'versionId',
+        'version',
+        'runId',
+        'agentId',
+        'workflow',
+        'phase',
+        'providerAdapter',
+        'reason',
+        'workspaceRoot',
+    ]);
+    if (!copied.ok)
+        return copied;
+    if (result.skillId === undefined && result.name === undefined)
+        return validationFailure('Either skillId or name is required', tool);
+    if (result.versionId !== undefined && result.version !== undefined)
+        return validationFailure('Use either versionId or version, not both', tool);
+    const scope = readOptionalOneOf(record.value, 'scope', scopes, tool);
+    if (!scope.ok)
+        return scope;
+    if (scope.value !== undefined)
+        result.scope = scope.value;
+    const mode = readOptionalOneOf(record.value, 'mode', payloadModes, tool);
+    if (!mode.ok)
+        return mode;
+    if (mode.value !== undefined)
+        result.mode = mode.value;
+    const intent = readOptionalJsonObject(record.value, 'intent', tool);
+    if (!intent.ok)
+        return intent;
+    if (intent.value !== undefined)
+        result.intent = intent.value;
+    if (record.value.maxSourceBytes !== undefined) {
+        const maxSourceBytes = record.value.maxSourceBytes;
+        if (typeof maxSourceBytes !== 'number' || !Number.isSafeInteger(maxSourceBytes) || maxSourceBytes <= 0)
+            return validationFailure('maxSourceBytes must be a positive safe integer', tool);
+        result.maxSourceBytes = maxSourceBytes;
+    }
+    return { ok: true, value: result };
+}
+export function validateSkillRecordUsageInput(input, tool) {
+    const record = inputRecord(input, tool, [
+        'skillId',
+        'versionId',
+        'runId',
+        'targetType',
+        'targetKey',
+        'outcome',
+        'notes',
+        'workflow',
+        'phase',
+        'providerAdapter',
+        'agentId',
+        'intent',
+        'evidence',
+    ]);
+    if (!record.ok)
+        return record;
+    const skillId = readNonEmptyString(record.value, 'skillId', tool);
+    if (!skillId.ok)
+        return skillId;
+    const outcome = readRequiredOneOf(record.value, 'outcome', skillUsageOutcomes, tool);
+    if (!outcome.ok)
+        return outcome;
+    const result = { skillId: skillId.value, outcome: outcome.value };
+    const copied = copyOptionalStrings(result, record.value, tool, [
+        'versionId',
+        'runId',
+        'targetKey',
+        'notes',
+        'workflow',
+        'phase',
+        'providerAdapter',
+        'agentId',
+    ]);
+    if (!copied.ok)
+        return copied;
+    const targetType = readOptionalOneOf(record.value, 'targetType', skillAttachmentTargetTypes, tool);
+    if (!targetType.ok)
+        return targetType;
+    if (targetType.value !== undefined)
+        result.targetType = targetType.value;
+    if (result.targetType !== undefined && result.targetKey === undefined)
+        return validationFailure('targetKey is required when targetType is set', tool);
+    if (result.targetType === undefined && result.targetKey !== undefined)
+        return validationFailure('targetType is required when targetKey is set', tool);
+    const intent = readOptionalJsonObject(record.value, 'intent', tool);
+    if (!intent.ok)
+        return intent;
+    if (intent.value !== undefined)
+        result.intent = intent.value;
+    const evidence = readOptionalJsonObject(record.value, 'evidence', tool);
+    if (!evidence.ok)
+        return evidence;
+    if (evidence.value !== undefined)
+        result.evidence = evidence.value;
+    return { ok: true, value: result };
+}
+export function validateSkillProposeImprovementInput(input, tool) {
+    const record = inputRecord(input, tool, [
+        'project',
+        'scope',
+        'skillId',
+        'name',
+        'baseVersionId',
+        'baseVersion',
+        'proposedVersion',
+        'proposedSource',
+        'proposedCompatibility',
+        'title',
+        'problem',
+        'suggestedChange',
+        'sourceContext',
+        'runId',
+        'agentId',
+        'workflow',
+        'phase',
+        'providerAdapter',
+        'evidenceRefs',
+        'evidence',
+        'actor',
+    ]);
+    if (!record.ok)
+        return record;
+    const result = {};
+    const copied = copyRequiredStrings(result, record.value, tool, ['project', 'proposedVersion', 'title', 'problem', 'suggestedChange']);
+    if (!copied.ok)
+        return copied;
+    const optional = copyOptionalStrings(result, record.value, tool, [
+        'skillId',
+        'name',
+        'baseVersionId',
+        'baseVersion',
+        'runId',
+        'agentId',
+        'workflow',
+        'phase',
+        'providerAdapter',
+        'actor',
+    ]);
+    if (!optional.ok)
+        return optional;
+    if (result.skillId === undefined && result.name === undefined)
+        return validationFailure('Either skillId or name is required', tool);
+    if (result.baseVersionId !== undefined && result.baseVersion !== undefined)
+        return validationFailure('Use either baseVersionId or baseVersion, not both', tool);
+    const scope = readOptionalOneOf(record.value, 'scope', scopes, tool);
+    if (!scope.ok)
+        return scope;
+    if (scope.value !== undefined)
+        result.scope = scope.value;
+    const source = readSkillSource(record.value, 'proposedSource', tool);
+    if (!source.ok)
+        return source;
+    result.proposedSource = source.value;
+    const compatibility = readOptionalJsonObject(record.value, 'proposedCompatibility', tool);
+    if (!compatibility.ok)
+        return compatibility;
+    if (compatibility.value !== undefined) {
+        const proposedCompatibility = compatibility.value;
+        if (proposedCompatibility !== undefined)
+            result.proposedCompatibility = proposedCompatibility;
+    }
+    const sourceContext = readOptionalJsonObject(record.value, 'sourceContext', tool);
+    if (!sourceContext.ok)
+        return sourceContext;
+    if (sourceContext.value !== undefined)
+        result.sourceContext = sourceContext.value;
+    const evidence = readOptionalJsonObject(record.value, 'evidence', tool);
+    if (!evidence.ok)
+        return evidence;
+    if (evidence.value !== undefined)
+        result.evidence = evidence.value;
+    const evidenceRefs = readOptionalStringArray(record.value, 'evidenceRefs', tool);
+    if (!evidenceRefs.ok)
+        return evidenceRefs;
+    if (evidenceRefs.value !== undefined)
+        result.evidenceRefs = evidenceRefs.value;
+    return { ok: true, value: result };
+}
+export function validateSkillListImprovementProposalsInput(input, tool) {
+    const record = inputRecord(input, tool, ['project', 'scope', 'skillId', 'name', 'baseVersionId', 'status', 'runId', 'agentId', 'limit']);
+    if (!record.ok)
+        return record;
+    const project = readNonEmptyString(record.value, 'project', tool);
+    if (!project.ok)
+        return project;
+    const result = { project: project.value };
+    const copied = copyOptionalStrings(result, record.value, tool, ['skillId', 'name', 'baseVersionId', 'runId', 'agentId']);
+    if (!copied.ok)
+        return copied;
+    const scope = readOptionalOneOf(record.value, 'scope', scopes, tool);
+    if (!scope.ok)
+        return scope;
+    if (scope.value !== undefined)
+        result.scope = scope.value;
+    const status = readOptionalOneOf(record.value, 'status', skillImprovementProposalStatuses, tool);
+    if (!status.ok)
+        return status;
+    if (status.value !== undefined)
+        result.status = status.value;
+    const limit = readOptionalBoundedLimit(record.value, tool);
+    if (!limit.ok)
+        return limit;
+    if (limit.value !== undefined)
+        result.limit = limit.value;
+    return { ok: true, value: result };
+}
+export function validateSkillRequestEvaluationInput(input, tool) {
+    const record = inputRecord(input, tool, [
+        'project',
+        'scope',
+        'skillId',
+        'name',
+        'versionId',
+        'version',
+        'scenarioId',
+        'proposalId',
+        'requestedBy',
+        'runId',
+        'agentId',
+        'workflow',
+        'phase',
+        'providerAdapter',
+        'risk',
+        'preflight',
+    ]);
+    if (!record.ok)
+        return record;
+    const result = {};
+    const copied = copyRequiredStrings(result, record.value, tool, ['project', 'requestedBy']);
+    if (!copied.ok)
+        return copied;
+    const optional = copyOptionalStrings(result, record.value, tool, [
+        'skillId',
+        'name',
+        'versionId',
+        'version',
+        'scenarioId',
+        'proposalId',
+        'runId',
+        'agentId',
+        'workflow',
+        'phase',
+        'providerAdapter',
+    ]);
+    if (!optional.ok)
+        return optional;
+    if (result.skillId === undefined && result.name === undefined)
+        return validationFailure('Either skillId or name is required', tool);
+    if (result.versionId !== undefined && result.version !== undefined)
+        return validationFailure('Use either versionId or version, not both', tool);
+    const scope = readOptionalOneOf(record.value, 'scope', scopes, tool);
+    if (!scope.ok)
+        return scope;
+    if (scope.value !== undefined)
+        result.scope = scope.value;
+    const risk = readOptionalJsonObject(record.value, 'risk', tool);
+    if (!risk.ok)
+        return risk;
+    if (risk.value !== undefined)
+        result.risk = risk.value;
+    const preflight = readOptionalJsonObject(record.value, 'preflight', tool);
+    if (!preflight.ok)
+        return preflight;
+    if (preflight.value !== undefined)
+        result.preflight = preflight.value;
+    return { ok: true, value: result };
+}
+export function validateSkillListEvaluationsInput(input, tool) {
+    const record = inputRecord(input, tool, [
+        'project',
+        'scope',
+        'skillId',
+        'name',
+        'versionId',
+        'scenarioId',
+        'proposalId',
+        'status',
+        'runId',
+        'agentId',
+        'limit',
+    ]);
+    if (!record.ok)
+        return record;
+    const project = readNonEmptyString(record.value, 'project', tool);
+    if (!project.ok)
+        return project;
+    const result = { project: project.value };
+    const copied = copyOptionalStrings(result, record.value, tool, ['skillId', 'name', 'versionId', 'scenarioId', 'proposalId', 'runId', 'agentId']);
+    if (!copied.ok)
+        return copied;
+    const scope = readOptionalOneOf(record.value, 'scope', scopes, tool);
+    if (!scope.ok)
+        return scope;
+    if (scope.value !== undefined)
+        result.scope = scope.value;
+    const status = readOptionalOneOf(record.value, 'status', skillEvaluationRequestStatuses, tool);
+    if (!status.ok)
+        return status;
+    if (status.value !== undefined)
+        result.status = status.value;
+    const limit = readOptionalBoundedLimit(record.value, tool);
+    if (!limit.ok)
+        return limit;
+    if (limit.value !== undefined)
+        result.limit = limit.value;
+    return { ok: true, value: result };
+}
+export function validateSkillGetEvaluationInput(input, tool) {
+    const record = inputRecord(input, tool, ['project', 'scope', 'id']);
+    if (!record.ok)
+        return record;
+    const project = readNonEmptyString(record.value, 'project', tool);
+    if (!project.ok)
+        return project;
+    const id = readNonEmptyString(record.value, 'id', tool);
+    if (!id.ok)
+        return id;
+    const result = { project: project.value, id: id.value };
+    const scope = readOptionalOneOf(record.value, 'scope', scopes, tool);
+    if (!scope.ok)
+        return scope;
+    if (scope.value !== undefined)
+        result.scope = scope.value;
+    return { ok: true, value: result };
+}
+export function validateSkillCreateDraftInput(input, tool) {
+    const record = inputRecord(input, tool, [
+        'project',
+        'scope',
+        'name',
+        'description',
+        'version',
+        'source',
+        'compatibility',
+        'draftParentVersionId',
+        'actor',
+        'reason',
+        'runId',
+        'agentId',
+        'evidence',
+        'governance',
+    ]);
+    if (!record.ok)
+        return record;
+    const result = {};
+    const required = copyRequiredStrings(result, record.value, tool, ['project', 'name', 'description', 'version']);
+    if (!required.ok)
+        return required;
+    const optional = copyOptionalStrings(result, record.value, tool, ['draftParentVersionId', 'reason', 'runId', 'agentId']);
+    if (!optional.ok)
+        return optional;
+    const scope = readOptionalOneOf(record.value, 'scope', scopes, tool);
+    if (!scope.ok)
+        return scope;
+    if (scope.value !== undefined)
+        result.scope = scope.value;
+    const source = readSkillSource(record.value, 'source', tool);
+    if (!source.ok)
+        return source;
+    result.source = source.value;
+    const actor = readSkillLifecycleActor(record.value, tool);
+    if (!actor.ok)
+        return actor;
+    result.actor = actor.value;
+    const compatibility = readOptionalJsonObject(record.value, 'compatibility', tool);
+    if (!compatibility.ok)
+        return compatibility;
+    if (compatibility.value !== undefined)
+        result.compatibility = compatibility.value;
+    const evidence = readOptionalJsonObject(record.value, 'evidence', tool);
+    if (!evidence.ok)
+        return evidence;
+    if (evidence.value !== undefined)
+        result.evidence = evidence.value;
+    const governance = readOptionalJsonObject(record.value, 'governance', tool);
+    if (!governance.ok)
+        return governance;
+    if (governance.value !== undefined)
+        result.governance = governance.value;
+    return { ok: true, value: result };
+}
+export function validateSkillUpdateDraftInput(input, tool) {
+    const record = inputRecord(input, tool, [
+        'project',
+        'scope',
+        'skillId',
+        'name',
+        'versionId',
+        'version',
+        'source',
+        'compatibility',
+        'expectedDraftRevision',
+        'actor',
+        'reason',
+        'runId',
+        'agentId',
+        'evidence',
+        'governance',
+    ]);
+    if (!record.ok)
+        return record;
+    const result = {};
+    const required = copyRequiredStrings(result, record.value, tool, ['project']);
+    if (!required.ok)
+        return required;
+    const optional = copyOptionalStrings(result, record.value, tool, ['skillId', 'name', 'versionId', 'version', 'reason', 'runId', 'agentId']);
+    if (!optional.ok)
+        return optional;
+    if (result.skillId === undefined && result.name === undefined)
+        return validationFailure('Either skillId or name is required', tool);
+    if (result.versionId === undefined && result.version === undefined)
+        return validationFailure('Either versionId or version is required', tool);
+    if (result.versionId !== undefined && result.version !== undefined)
+        return validationFailure('Use either versionId or version, not both', tool);
+    const scope = readOptionalOneOf(record.value, 'scope', scopes, tool);
+    if (!scope.ok)
+        return scope;
+    if (scope.value !== undefined)
+        result.scope = scope.value;
+    const actor = readSkillLifecycleActor(record.value, tool);
+    if (!actor.ok)
+        return actor;
+    result.actor = actor.value;
+    if (record.value.source !== undefined) {
+        const source = readSkillSource(record.value, 'source', tool);
+        if (!source.ok)
+            return source;
+        result.source = source.value;
+    }
+    const compatibility = readOptionalJsonObject(record.value, 'compatibility', tool);
+    if (!compatibility.ok)
+        return compatibility;
+    if (compatibility.value !== undefined)
+        result.compatibility = compatibility.value;
+    if (record.value.expectedDraftRevision !== undefined) {
+        const revision = record.value.expectedDraftRevision;
+        if (typeof revision !== 'number' || !Number.isSafeInteger(revision) || revision < 1)
+            return validationFailure('expectedDraftRevision must be a positive safe integer', tool);
+        result.expectedDraftRevision = revision;
+    }
+    const evidence = readOptionalJsonObject(record.value, 'evidence', tool);
+    if (!evidence.ok)
+        return evidence;
+    if (evidence.value !== undefined)
+        result.evidence = evidence.value;
+    const governance = readOptionalJsonObject(record.value, 'governance', tool);
+    if (!governance.ok)
+        return governance;
+    if (governance.value !== undefined)
+        result.governance = governance.value;
+    if (result.source === undefined && result.compatibility === undefined && result.governance === undefined)
+        return validationFailure('At least one draft update field is required', tool);
+    return { ok: true, value: result };
+}
+export function validateSkillPublishVersionInput(input, tool) {
+    const record = inputRecord(input, tool, [
+        'project',
+        'scope',
+        'skillId',
+        'name',
+        'versionId',
+        'version',
+        'actor',
+        'reason',
+        'runId',
+        'agentId',
+        'evidence',
+        'governance',
+    ]);
+    if (!record.ok)
+        return record;
+    const result = {};
+    const required = copyRequiredStrings(result, record.value, tool, ['project', 'reason']);
+    if (!required.ok)
+        return required;
+    const optional = copyOptionalStrings(result, record.value, tool, ['skillId', 'name', 'versionId', 'version', 'runId', 'agentId']);
+    if (!optional.ok)
+        return optional;
+    if (result.skillId === undefined && result.name === undefined)
+        return validationFailure('Either skillId or name is required', tool);
+    if (result.versionId === undefined && result.version === undefined)
+        return validationFailure('Either versionId or version is required', tool);
+    if (result.versionId !== undefined && result.version !== undefined)
+        return validationFailure('Use either versionId or version, not both', tool);
+    const scope = readOptionalOneOf(record.value, 'scope', scopes, tool);
+    if (!scope.ok)
+        return scope;
+    if (scope.value !== undefined)
+        result.scope = scope.value;
+    const actor = readSkillLifecycleActor(record.value, tool);
+    if (!actor.ok)
+        return actor;
+    result.actor = actor.value;
+    const evidence = readOptionalJsonObject(record.value, 'evidence', tool);
+    if (!evidence.ok)
+        return evidence;
+    if (evidence.value !== undefined)
+        result.evidence = evidence.value;
+    const governance = readOptionalJsonObject(record.value, 'governance', tool);
+    if (!governance.ok)
+        return governance;
+    if (governance.value !== undefined)
+        result.governance = governance.value;
+    return { ok: true, value: result };
+}