noteconnection 1.6.8 → 1.8.0

package/dist/src/learning/requestNormalization.js

@@ -0,0 +1,198 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeKnowledgeCorpusScopePayload = normalizeKnowledgeCorpusScopePayload;
+exports.normalizeKnowledgeQueryRequestPayload = normalizeKnowledgeQueryRequestPayload;
+exports.normalizeAgentConversationRequestPayload = normalizeAgentConversationRequestPayload;
+exports.normalizeWorkflowArtifactReviewFollowUpRequestPayload = normalizeWorkflowArtifactReviewFollowUpRequestPayload;
+function isObjectRecord(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+function readFirstPresentValue(record, keys) {
+    for (const key of keys) {
+        if (Object.prototype.hasOwnProperty.call(record, key)) {
+            return record[key];
+        }
+    }
+    return undefined;
+}
+function readFirstNonEmptyString(record, keys) {
+    const value = readFirstPresentValue(record, keys);
+    return typeof value === 'string' ? value.trim() : '';
+}
+function parsePositiveIntegerValue(value) {
+    const numeric = Number(value);
+    if (!Number.isFinite(numeric) || numeric <= 0) {
+        return 0;
+    }
+    return Math.floor(numeric);
+}
+function normalizeStringList(values, options = {}) {
+    const list = Array.isArray(values) ? values : [];
+    const normalized = list
+        .map((value) => String(value || '').trim())
+        .map((value) => options.normalize ? options.normalize(value) : value)
+        .filter((value) => value.length > 0);
+    return Array.from(new Set(normalized));
+}
+function normalizePathPrefix(value) {
+    return value.replace(/\\/g, '/').replace(/\/{2,}/g, '/').replace(/\/+$/g, '');
+}
+function normalizeKnowledgeCorpusScopePayload(payload) {
+    const record = isObjectRecord(payload) ? payload : {};
+    const nestedScope = isObjectRecord(record.scope) ? record.scope : {};
+    const workspaceId = readFirstNonEmptyString(record, ['workspaceId', 'workspace_id'])
+        || readFirstNonEmptyString(nestedScope, ['workspaceId', 'workspace_id']);
+    const corpusId = readFirstNonEmptyString(record, ['corpusId', 'corpus_id'])
+        || readFirstNonEmptyString(nestedScope, ['corpusId', 'corpus_id']);
+    const documentIds = normalizeStringList(readFirstPresentValue(record, ['documentIds', 'document_ids'])
+        ?? readFirstPresentValue(nestedScope, ['documentIds', 'document_ids']));
+    const atomIds = normalizeStringList(readFirstPresentValue(record, ['atomIds', 'atom_ids'])
+        ?? readFirstPresentValue(nestedScope, ['atomIds', 'atom_ids']));
+    const sourcePathPrefixes = normalizeStringList(readFirstPresentValue(record, ['sourcePathPrefixes', 'source_path_prefixes'])
+        ?? readFirstPresentValue(nestedScope, ['sourcePathPrefixes', 'source_path_prefixes']), { normalize: normalizePathPrefix });
+    const languages = normalizeStringList(readFirstPresentValue(record, ['languages', 'languageScope'])
+        ?? readFirstPresentValue(nestedScope, ['languages', 'languageScope']), { normalize: (value) => value.toLowerCase() });
+    if (!workspaceId && !corpusId && documentIds.length <= 0 && atomIds.length <= 0 && sourcePathPrefixes.length <= 0 && languages.length <= 0) {
+        return undefined;
+    }
+    return {
+        workspaceId: workspaceId || undefined,
+        corpusId: corpusId || undefined,
+        documentIds: documentIds.length > 0 ? documentIds : undefined,
+        atomIds: atomIds.length > 0 ? atomIds : undefined,
+        sourcePathPrefixes: sourcePathPrefixes.length > 0 ? sourcePathPrefixes : undefined,
+        languages: languages.length > 0 ? languages : undefined,
+    };
+}
+function normalizeKnowledgeQueryRequestPayload(payload) {
+    const record = isObjectRecord(payload) ? payload : {};
+    const query = readFirstNonEmptyString(record, ['query', 'q']) || '';
+    const topKValue = parsePositiveIntegerValue(readFirstPresentValue(record, ['topK', 'k', 'limit']));
+    const asOf = readFirstNonEmptyString(record, ['asOf', 'as_of', 'timestamp']);
+    const queryBackend = readFirstNonEmptyString(record, ['queryBackend', 'backend', 'query_backend']);
+    return {
+        query,
+        topK: topKValue > 0 ? topKValue : undefined,
+        asOf,
+        queryBackend,
+        scope: normalizeKnowledgeCorpusScopePayload(record),
+    };
+}
+function normalizeAgentConversationRequestPayload(payload) {
+    const record = isObjectRecord(payload) ? payload : {};
+    const topKValue = parsePositiveIntegerValue(readFirstPresentValue(record, ['topK', 'k', 'limit']));
+    return {
+        userId: String(readFirstPresentValue(record, ['userId', 'user_id', 'learnerId']) || '').trim(),
+        sessionId: readFirstNonEmptyString(record, ['sessionId', 'session_id']),
+        activeTarget: readFirstNonEmptyString(record, ['activeTarget', 'active_target', 'target']),
+        message: readFirstNonEmptyString(record, ['message', 'prompt', 'query', 'q', 'text']) || '',
+        topK: topKValue > 0 ? topKValue : undefined,
+        asOf: readFirstNonEmptyString(record, ['asOf', 'as_of', 'timestamp', 'now']),
+        persistMemory: readFirstPresentValue(record, ['persistMemory', 'persist_memory']) !== false,
+        memoryNamespace: readFirstNonEmptyString(record, ['memoryNamespace', 'memory_namespace']),
+        scope: normalizeKnowledgeCorpusScopePayload(record),
+    };
+}
+function normalizeBooleanFlagOrUndefined(value) {
+    if (typeof value === 'boolean') {
+        return value;
+    }
+    const normalized = typeof value === 'string' ? value.trim().toLowerCase() : '';
+    if (!normalized) {
+        return undefined;
+    }
+    if (normalized === 'true' || normalized === '1' || normalized === 'yes' || normalized === 'on') {
+        return true;
+    }
+    if (normalized === 'false' || normalized === '0' || normalized === 'no' || normalized === 'off') {
+        return false;
+    }
+    return undefined;
+}
+function normalizeMemoryLayerValue(value) {
+    const normalized = String(value || '').trim().toLowerCase();
+    if (normalized === 'session') {
+        return 'session';
+    }
+    if (normalized === 'unit') {
+        return 'unit';
+    }
+    if (normalized === 'long_term' || normalized === 'long-term' || normalized === 'longterm') {
+        return 'long_term';
+    }
+    return undefined;
+}
+function normalizeWorkflowArtifactReviewFollowUpRequestPayload(payload) {
+    const record = isObjectRecord(payload) ? payload : {};
+    const actionRecord = isObjectRecord(record.action) ? record.action : {};
+    const actionSource = readFirstNonEmptyString(actionRecord, ['source', 'actionSource'])
+        || readFirstNonEmptyString(record, ['source', 'actionSource']);
+    const actionKind = readFirstNonEmptyString(actionRecord, ['kind', 'learningActionKind', 'actionKind'])
+        || readFirstNonEmptyString(record, ['kind', 'learningActionKind', 'actionKind']);
+    const outcome = readFirstNonEmptyString(record, ['outcome']);
+    return {
+        userId: String(readFirstPresentValue(record, ['userId', 'user_id', 'learnerId']) || '').trim(),
+        sessionId: readFirstNonEmptyString(record, ['sessionId', 'session_id']),
+        artifactId: readFirstNonEmptyString(record, ['artifactId', 'artifact_id']),
+        cardId: readFirstNonEmptyString(record, ['cardId', 'card_id']),
+        action: {
+            atomId: readFirstNonEmptyString(actionRecord, ['atomId', 'atom_id'])
+                || readFirstNonEmptyString(record, ['atomId', 'atom_id']),
+            kind: actionKind
+                ? actionKind
+                : undefined,
+            source: (actionSource || 'flashcard_batch'),
+            prompt: readFirstNonEmptyString(actionRecord, ['prompt'])
+                || readFirstNonEmptyString(record, ['prompt']),
+            answer: readFirstNonEmptyString(actionRecord, ['answer'])
+                || readFirstNonEmptyString(record, ['answer']),
+        },
+        outcome: outcome
+            ? outcome
+            : undefined,
+        errorTag: readFirstNonEmptyString(record, ['errorTag', 'mistakeTag', 'misconceptionTag']),
+        autoAnalyzeAnswer: normalizeBooleanFlagOrUndefined(readFirstPresentValue(record, ['autoAnalyzeAnswer', 'analyzeAnswer'])),
+        autoUpdateMasteryFromAnswer: normalizeBooleanFlagOrUndefined(readFirstPresentValue(record, [
+            'autoUpdateMasteryFromAnswer',
+            'updateMasteryFromAnswer',
+            'inferMasteryFromAnswer',
+        ])),
+        executedAt: readFirstNonEmptyString(record, ['executedAt', 'timestamp', 'now']),
+        persistMemory: normalizeBooleanFlagOrUndefined(readFirstPresentValue(record, ['persistMemory', 'persist', 'persist_memory'])),
+        memoryLayer: normalizeMemoryLayerValue(readFirstPresentValue(record, ['memoryLayer', 'layer'])),
+        tutorAdapterId: readFirstNonEmptyString(record, ['tutorAdapterId', 'adapterId']),
+        tutorProviderName: readFirstNonEmptyString(record, ['tutorProviderName', 'providerName']),
+        tutorProviderMode: readFirstNonEmptyString(record, ['tutorProviderMode', 'providerMode']),
+        autoPromoteMemory: normalizeBooleanFlagOrUndefined(readFirstPresentValue(record, [
+            'autoPromoteMemory',
+            'promoteMemory',
+            'autoPromote',
+            'promote_memory',
+        ])),
+        promoteMemoryTargetLayer: normalizeMemoryLayerValue(readFirstPresentValue(record, [
+            'promoteMemoryTargetLayer',
+            'promoteTargetLayer',
+            'targetLayer',
+            'toLayer',
+        ])),
+        promoteMemoryMinConfidence: Number.isFinite(Number(readFirstPresentValue(record, [
+            'promoteMemoryMinConfidence',
+            'promoteMinConfidence',
+            'minPromotionConfidence',
+            'minConfidence',
+        ])))
+            ? Number(readFirstPresentValue(record, [
+                'promoteMemoryMinConfidence',
+                'promoteMinConfidence',
+                'minPromotionConfidence',
+                'minConfidence',
+            ]))
+            : undefined,
+        promoteMemoryRemoveFromSource: normalizeBooleanFlagOrUndefined(readFirstPresentValue(record, [
+            'promoteMemoryRemoveFromSource',
+            'promoteRemoveFromSource',
+            'removeFromSource',
+            'remove_source',
+        ])),
+    };
+}