@jsonstudio/llms 0.6.2172 → 0.6.3214

package/dist/router/virtual-router/engine-selection/native-hub-pipeline-resp-semantics.js

@@ -0,0 +1,637 @@
+import { failNativeRequired, isNativeDisabledByEnv } from './native-router-hotpath-policy.js';
+import { loadNativeRouterHotpathBindingForInternalUse } from './native-router-hotpath.js';
+function readNativeFunction(name) {
+    const binding = loadNativeRouterHotpathBindingForInternalUse();
+    const fn = binding?.[name];
+    return typeof fn === 'function' ? fn : null;
+}
+function safeStringify(value) {
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+function parseAliasMap(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed === null) {
+            return undefined;
+        }
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            return null;
+        }
+        const out = {};
+        for (const [key, value] of Object.entries(parsed)) {
+            if (typeof key !== 'string' || typeof value !== 'string') {
+                return null;
+            }
+            const trimmedKey = key.trim();
+            const trimmedValue = value.trim();
+            if (!trimmedKey || !trimmedValue) {
+                return null;
+            }
+            out[trimmedKey] = trimmedValue;
+        }
+        return Object.keys(out).length ? out : undefined;
+    }
+    catch {
+        return null;
+    }
+}
+function parseClientToolsRaw(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed === null) {
+            return undefined;
+        }
+        if (!Array.isArray(parsed)) {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function parseRecord(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function parseBoolean(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        return typeof parsed === 'boolean' ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function parseStringOrUndefined(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed === null) {
+            return undefined;
+        }
+        return typeof parsed === 'string' ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function parseContextLengthDiagnostics(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            return null;
+        }
+        const row = parsed;
+        const output = {};
+        const estimated = row.estimatedPromptTokens;
+        const maxContext = row.maxContextTokens;
+        if (typeof estimated === 'number' && Number.isFinite(estimated)) {
+            output.estimatedPromptTokens = Math.floor(estimated);
+        }
+        if (typeof maxContext === 'number' && Number.isFinite(maxContext)) {
+            output.maxContextTokens = Math.floor(maxContext);
+        }
+        return output;
+    }
+    catch {
+        return null;
+    }
+}
+function parseJsonObjectCandidate(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed === null) {
+            return null;
+        }
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            return undefined;
+        }
+        return parsed;
+    }
+    catch {
+        return undefined;
+    }
+}
+function parseResponsesHostPolicyResult(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            return null;
+        }
+        const row = parsed;
+        if (typeof row.shouldStripHostManagedFields !== 'boolean') {
+            return null;
+        }
+        if (typeof row.targetProtocol !== 'string') {
+            return null;
+        }
+        const targetProtocol = row.targetProtocol.trim();
+        if (!targetProtocol.length) {
+            return null;
+        }
+        return {
+            shouldStripHostManagedFields: row.shouldStripHostManagedFields,
+            targetProtocol
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export function normalizeAliasMapWithNative(candidate) {
+    const capability = 'normalizeAliasMapJson';
+    const fail = (reason) => failNativeRequired(capability, reason);
+    if (isNativeDisabledByEnv()) {
+        return fail('native disabled');
+    }
+    const fn = readNativeFunction('normalizeAliasMapJson');
+    if (!fn) {
+        return fail();
+    }
+    const candidateJson = safeStringify(candidate ?? null);
+    if (!candidateJson) {
+        return fail('json stringify failed');
+    }
+    try {
+        const raw = fn(candidateJson);
+        if (typeof raw !== 'string' || !raw) {
+            return fail('empty result');
+        }
+        const parsed = parseAliasMap(raw);
+        return parsed === null ? fail('invalid payload') : parsed;
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error ?? 'unknown');
+        return fail(reason);
+    }
+}
+export function resolveClientToolsRawWithNative(candidate) {
+    const capability = 'resolveClientToolsRawJson';
+    const fail = (reason) => failNativeRequired(capability, reason);
+    if (isNativeDisabledByEnv()) {
+        return fail('native disabled');
+    }
+    const fn = readNativeFunction('resolveClientToolsRawJson');
+    if (!fn) {
+        return fail();
+    }
+    const candidateJson = safeStringify(candidate ?? null);
+    if (!candidateJson) {
+        return fail('json stringify failed');
+    }
+    try {
+        const raw = fn(candidateJson);
+        if (typeof raw !== 'string' || !raw) {
+            return fail('empty result');
+        }
+        const parsed = parseClientToolsRaw(raw);
+        return parsed === null ? fail('invalid payload') : parsed;
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error ?? 'unknown');
+        return fail(reason);
+    }
+}
+export function resolveAliasMapFromRespSemanticsWithNative(semantics) {
+    const capability = 'resolveAliasMapFromRespSemanticsJson';
+    const fail = (reason) => failNativeRequired(capability, reason);
+    if (isNativeDisabledByEnv()) {
+        return fail('native disabled');
+    }
+    const fn = readNativeFunction('resolveAliasMapFromRespSemanticsJson');
+    if (!fn) {
+        return fail();
+    }
+    const semanticsJson = safeStringify(semantics ?? null);
+    if (!semanticsJson) {
+        return fail('json stringify failed');
+    }
+    try {
+        const raw = fn(semanticsJson);
+        if (typeof raw !== 'string' || !raw) {
+            return fail('empty result');
+        }
+        const parsed = parseAliasMap(raw);
+        return parsed === null ? fail('invalid payload') : parsed;
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error ?? 'unknown');
+        return fail(reason);
+    }
+}
+export function resolveClientToolsRawFromRespSemanticsWithNative(semantics) {
+    const capability = 'resolveClientToolsRawFromRespSemanticsJson';
+    const fail = (reason) => failNativeRequired(capability, reason);
+    if (isNativeDisabledByEnv()) {
+        return fail('native disabled');
+    }
+    const fn = readNativeFunction('resolveClientToolsRawFromRespSemanticsJson');
+    if (!fn) {
+        return fail();
+    }
+    const semanticsJson = safeStringify(semantics ?? null);
+    if (!semanticsJson) {
+        return fail('json stringify failed');
+    }
+    try {
+        const raw = fn(semanticsJson);
+        if (typeof raw !== 'string' || !raw) {
+            return fail('empty result');
+        }
+        const parsed = parseClientToolsRaw(raw);
+        return parsed === null ? fail('invalid payload') : parsed;
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error ?? 'unknown');
+        return fail(reason);
+    }
+}
+export function sanitizeResponsesFunctionNameWithNative(rawName) {
+    const capability = 'sanitizeResponsesFunctionNameJson';
+    const fail = (reason) => failNativeRequired(capability, reason);
+    if (isNativeDisabledByEnv()) {
+        return fail('native disabled');
+    }
+    const fn = readNativeFunction(capability);
+    if (!fn) {
+        return fail();
+    }
+    const rawNameJson = safeStringify(rawName ?? null);
+    if (!rawNameJson) {
+        return fail('json stringify failed');
+    }
+    try {
+        const raw = fn(rawNameJson);
+        if (typeof raw !== 'string' || !raw) {
+            return fail('empty result');
+        }
+        const parsed = parseStringOrUndefined(raw);
+        return parsed === null ? fail('invalid payload') : parsed;
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error ?? 'unknown');
+        return fail(reason);
+    }
+}
+export function extractSseWrapperErrorWithNative(payload) {
+    const capability = 'extractSseWrapperErrorJson';
+    const fail = (reason) => failNativeRequired(capability, reason);
+    if (isNativeDisabledByEnv()) {
+        return fail('native disabled');
+    }
+    const fn = readNativeFunction(capability);
+    if (!fn) {
+        return fail();
+    }
+    const payloadJson = safeStringify(payload ?? null);
+    if (!payloadJson) {
+        return fail('json stringify failed');
+    }
+    try {
+        const raw = fn(payloadJson);
+        if (typeof raw !== 'string' || !raw) {
+            return fail('empty result');
+        }
+        const parsed = parseStringOrUndefined(raw);
+        return parsed === null ? fail('invalid payload') : parsed;
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error ?? 'unknown');
+        return fail(reason);
+    }
+}
+export function extractContextLengthDiagnosticsWithNative(adapterContext) {
+    const capability = 'extractContextLengthDiagnosticsJson';
+    const fail = (reason) => failNativeRequired(capability, reason);
+    if (isNativeDisabledByEnv()) {
+        return fail('native disabled');
+    }
+    const fn = readNativeFunction(capability);
+    if (!fn) {
+        return fail();
+    }
+    const contextJson = safeStringify(adapterContext ?? null);
+    if (!contextJson) {
+        return fail('json stringify failed');
+    }
+    try {
+        const raw = fn(contextJson);
+        if (typeof raw !== 'string' || !raw) {
+            return fail('empty result');
+        }
+        const parsed = parseContextLengthDiagnostics(raw);
+        return parsed ?? fail('invalid payload');
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error ?? 'unknown');
+        return fail(reason);
+    }
+}
+export function isContextLengthExceededSignalWithNative(code, message, context) {
+    const capability = 'isContextLengthExceededSignalJson';
+    const fail = (reason) => failNativeRequired(capability, reason);
+    if (isNativeDisabledByEnv()) {
+        return fail('native disabled');
+    }
+    const fn = readNativeFunction(capability);
+    if (!fn) {
+        return fail();
+    }
+    const contextJson = safeStringify(context ?? null);
+    if (!contextJson) {
+        return fail('json stringify failed');
+    }
+    const normalizedCode = typeof code === 'string' ? code : '';
+    try {
+        const raw = fn(normalizedCode, String(message || ''), contextJson);
+        if (typeof raw !== 'string' || !raw) {
+            return fail('empty result');
+        }
+        const parsed = parseBoolean(raw);
+        return parsed === null ? fail('invalid payload') : parsed;
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error ?? 'unknown');
+        return fail(reason);
+    }
+}
+export function applyClientPassthroughPatchWithNative(clientPayload, sourcePayload) {
+    const capability = 'applyClientPassthroughPatchJson';
+    const fail = (reason) => failNativeRequired(capability, reason);
+    if (isNativeDisabledByEnv()) {
+        return fail('native disabled');
+    }
+    const fn = readNativeFunction(capability);
+    if (!fn) {
+        return fail();
+    }
+    const clientPayloadJson = safeStringify(clientPayload);
+    const sourcePayloadJson = safeStringify(sourcePayload);
+    if (!clientPayloadJson || !sourcePayloadJson) {
+        return fail('json stringify failed');
+    }
+    try {
+        const raw = fn(clientPayloadJson, sourcePayloadJson);
+        if (typeof raw !== 'string' || !raw) {
+            return fail('empty result');
+        }
+        const parsed = parseRecord(raw);
+        return parsed ?? fail('invalid payload');
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error ?? 'unknown');
+        return fail(reason);
+    }
+}
+export function buildAnthropicResponseFromChatWithNative(chatResponse, aliasMap) {
+    const capability = 'buildAnthropicResponseFromChatJson';
+    const fail = (reason) => failNativeRequired(capability, reason);
+    if (isNativeDisabledByEnv()) {
+        return fail('native disabled');
+    }
+    const fn = readNativeFunction(capability);
+    if (!fn) {
+        return fail();
+    }
+    const chatResponseJson = safeStringify(chatResponse);
+    const aliasMapJson = safeStringify(aliasMap ?? null);
+    if (!chatResponseJson || !aliasMapJson) {
+        return fail('json stringify failed');
+    }
+    try {
+        const raw = fn(chatResponseJson, aliasMapJson);
+        const nativeErrorMessage = raw instanceof Error
+            ? raw.message
+            : raw && typeof raw === 'object' && 'message' in raw
+                ? (() => {
+                    const candidate = raw.message;
+                    return typeof candidate === 'string' ? candidate : '';
+                })()
+                : '';
+        if (nativeErrorMessage) {
+            return fail(nativeErrorMessage);
+        }
+        if (typeof raw !== 'string' || !raw) {
+            return fail('empty result');
+        }
+        const parsed = parseRecord(raw);
+        return parsed ?? fail('invalid payload');
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error ?? 'unknown');
+        return fail(reason);
+    }
+}
+export function normalizeResponsesToolCallArgumentsForClientWithNative(responsesPayload, toolsRaw) {
+    const capability = 'normalizeResponsesToolCallArgumentsForClientJson';
+    const fail = (reason) => failNativeRequired(capability, reason);
+    if (isNativeDisabledByEnv()) {
+        return fail('native disabled');
+    }
+    const fn = readNativeFunction(capability);
+    if (!fn) {
+        return fail();
+    }
+    const payloadJson = safeStringify(responsesPayload);
+    const toolsRawJson = safeStringify(toolsRaw ?? []);
+    if (!payloadJson || !toolsRawJson) {
+        return fail('json stringify failed');
+    }
+    try {
+        const raw = fn(payloadJson, toolsRawJson);
+        const nativeErrorMessage = raw instanceof Error
+            ? raw.message
+            : raw && typeof raw === 'object' && 'message' in raw
+                ? (() => {
+                    const candidate = raw.message;
+                    return typeof candidate === 'string' ? candidate : '';
+                })()
+                : '';
+        if (nativeErrorMessage) {
+            return fail(nativeErrorMessage);
+        }
+        if (typeof raw !== 'string' || !raw) {
+            return fail('empty result');
+        }
+        const parsed = parseRecord(raw);
+        return parsed ?? fail('invalid payload');
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error ?? 'unknown');
+        return fail(reason);
+    }
+}
+export function normalizeResponsesUsageWithNative(usageRaw) {
+    const capability = 'normalizeResponsesUsageJson';
+    const fail = (reason) => failNativeRequired(capability, reason);
+    if (isNativeDisabledByEnv()) {
+        return fail('native disabled');
+    }
+    const fn = readNativeFunction(capability);
+    if (!fn) {
+        return fail();
+    }
+    const usageJson = safeStringify(usageRaw ?? null);
+    if (!usageJson) {
+        return fail('json stringify failed');
+    }
+    try {
+        const raw = fn(usageJson);
+        const nativeErrorMessage = raw instanceof Error
+            ? raw.message
+            : raw && typeof raw === 'object' && 'message' in raw
+                ? (() => {
+                    const candidate = raw.message;
+                    return typeof candidate === 'string' ? candidate : '';
+                })()
+                : '';
+        if (nativeErrorMessage) {
+            return fail(nativeErrorMessage);
+        }
+        if (typeof raw !== 'string' || !raw) {
+            return fail('empty result');
+        }
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            return fail('invalid payload');
+        }
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error ?? 'unknown');
+        return fail(reason);
+    }
+}
+export function buildResponsesPayloadFromChatWithNative(payload, context = {}) {
+    const capability = 'buildResponsesPayloadFromChatJson';
+    const fail = (reason) => failNativeRequired(capability, reason);
+    if (isNativeDisabledByEnv()) {
+        return fail('native disabled');
+    }
+    const fn = readNativeFunction(capability);
+    if (!fn) {
+        return fail();
+    }
+    const payloadJson = safeStringify(payload);
+    const contextJson = safeStringify({
+        requestId: context.requestId,
+        toolsRaw: Array.isArray(context.toolsRaw) ? context.toolsRaw : []
+    });
+    if (!payloadJson || !contextJson) {
+        return fail('json stringify failed');
+    }
+    try {
+        const raw = fn(payloadJson, contextJson);
+        const nativeErrorMessage = raw instanceof Error
+            ? raw.message
+            : raw && typeof raw === 'object' && 'message' in raw
+                ? (() => {
+                    const candidate = raw.message;
+                    return typeof candidate === 'string' ? candidate : '';
+                })()
+                : '';
+        if (nativeErrorMessage) {
+            return fail(nativeErrorMessage);
+        }
+        if (typeof raw !== 'string' || !raw) {
+            return fail('empty result');
+        }
+        const parsed = parseRecord(raw);
+        return parsed ?? fail('invalid payload');
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error ?? 'unknown');
+        return fail(reason);
+    }
+}
+export function looksLikeJsonStreamPrefixWithNative(firstChunkText) {
+    const capability = 'looksLikeJsonStreamPrefixJson';
+    const fail = (reason) => failNativeRequired(capability, reason);
+    if (isNativeDisabledByEnv()) {
+        return fail('native disabled');
+    }
+    const fn = readNativeFunction('looksLikeJsonStreamPrefixJson');
+    if (!fn) {
+        return fail();
+    }
+    try {
+        const raw = fn(String(firstChunkText || ''));
+        if (typeof raw !== 'string' || !raw) {
+            return fail('empty result');
+        }
+        const parsed = parseBoolean(raw);
+        return parsed === null ? fail('invalid payload') : parsed;
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error ?? 'unknown');
+        return fail(reason);
+    }
+}
+export function parseJsonObjectCandidateWithNative(rawText, maxBytes) {
+    const capability = 'parseJsonObjectCandidateJson';
+    const fail = (reason) => failNativeRequired(capability, reason);
+    if (isNativeDisabledByEnv()) {
+        return fail('native disabled');
+    }
+    const fn = readNativeFunction('parseJsonObjectCandidateJson');
+    if (!fn) {
+        return fail();
+    }
+    const bounded = Number.isFinite(maxBytes) && maxBytes > 0 ? Math.floor(maxBytes) : 0;
+    try {
+        const raw = fn(String(rawText || ''), bounded);
+        if (typeof raw !== 'string' || !raw) {
+            return fail('empty result');
+        }
+        const parsed = parseJsonObjectCandidate(raw);
+        return parsed === undefined ? fail('invalid payload') : parsed;
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error ?? 'unknown');
+        return fail(reason);
+    }
+}
+export function evaluateResponsesHostPolicyWithNative(context, targetProtocol) {
+    const capability = 'evaluateResponsesHostPolicyJson';
+    const fail = (reason) => failNativeRequired(capability, reason);
+    if (isNativeDisabledByEnv()) {
+        return fail('native disabled');
+    }
+    const fn = readNativeFunction(capability);
+    if (!fn) {
+        return fail();
+    }
+    const payloadJson = safeStringify({
+        context: context && typeof context === 'object' && !Array.isArray(context) ? context : undefined,
+        targetProtocol
+    });
+    if (!payloadJson) {
+        return fail('json stringify failed');
+    }
+    try {
+        const raw = fn(payloadJson);
+        if (typeof raw !== 'string' || !raw) {
+            return fail('empty result');
+        }
+        const parsed = parseResponsesHostPolicyResult(raw);
+        return parsed ?? fail('invalid payload');
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error ?? 'unknown');
+        return fail(reason);
+    }
+}

package/dist/router/virtual-router/engine-selection/native-hub-pipeline-session-identifiers-semantics.d.ts

@@ -0,0 +1,11 @@
+export interface NativeSessionIdentifiersOutput {
+    sessionId?: string;
+    conversationId?: string;
+}
+type NativeHeaderMap = Record<string, string>;
+export declare function extractSessionIdentifiersFromMetadataWithNative(metadata: Record<string, unknown> | undefined): NativeSessionIdentifiersOutput;
+export declare function coerceClientHeadersWithNative(raw: unknown): NativeHeaderMap | undefined;
+export declare function findHeaderValueWithNative(headers: Record<string, string>, target: string): string | undefined;
+export declare function pickHeaderWithNative(headers: Record<string, string>, candidates: string[]): string | undefined;
+export declare function normalizeHeaderKeyWithNative(value: string): string;
+export {};