@nimiplatform/sdk 0.5.14

package/dist/runtime/runtime-agent-timeline-parsers.js

@@ -0,0 +1,170 @@
+import { ReasonCode } from '../types/index.js';
+import { createNimiError } from './errors.js';
+import { asRecord, normalizeText } from './helpers.js';
+function expectString(value, fieldName, messageType) {
+    const normalized = normalizeText(value);
+    if (!normalized) {
+        throw createNimiError({
+            message: `${messageType} requires ${fieldName}`,
+            reasonCode: ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED,
+            actionHint: 'check_runtime_agent_projection_shape',
+            source: 'sdk',
+        });
+    }
+    return normalized;
+}
+function parseTimelineFiniteNumber(value) {
+    if (typeof value === 'number') {
+        return Number.isFinite(value) ? value : undefined;
+    }
+    if (typeof value === 'string') {
+        const normalized = value.trim();
+        if (!/^[-+]?(?:\d+|\d+\.\d+|\.\d+)(?:[eE][-+]?\d+)?$/.test(normalized)) {
+            return undefined;
+        }
+        const parsed = Number(normalized);
+        return Number.isFinite(parsed) ? parsed : undefined;
+    }
+    return undefined;
+}
+function expectTimelineNumber(value, fieldName, messageType) {
+    const parsed = parseTimelineFiniteNumber(value);
+    if (parsed === undefined) {
+        throw createNimiError({
+            message: `${messageType} timeline.${fieldName} must be a finite number`,
+            reasonCode: ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED,
+            actionHint: 'check_runtime_agent_timeline_projection_shape',
+            source: 'sdk',
+        });
+    }
+    return parsed;
+}
+function expectTimelineBoolean(value, expected, fieldName, messageType) {
+    if (value !== expected) {
+        throw createNimiError({
+            message: `${messageType} timeline.${fieldName} must be ${String(expected)}`,
+            reasonCode: ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED,
+            actionHint: 'check_runtime_agent_timeline_projection_shape',
+            source: 'sdk',
+        });
+    }
+    return expected;
+}
+function timelineChannelForEvent(messageType) {
+    switch (messageType) {
+        case 'runtime.agent.turn.text_delta':
+        case 'runtime.agent.turn.reasoning_delta':
+        case 'runtime.agent.turn.structured':
+        case 'runtime.agent.turn.message_committed':
+            return 'text';
+        case 'runtime.agent.turn.accepted':
+        case 'runtime.agent.turn.started':
+        case 'runtime.agent.turn.post_turn':
+        case 'runtime.agent.turn.completed':
+        case 'runtime.agent.turn.failed':
+        case 'runtime.agent.turn.interrupted':
+        case 'runtime.agent.turn.interrupt_ack':
+            return 'state';
+        case 'runtime.agent.presentation.voice_playback_requested':
+            return 'voice';
+        case 'runtime.agent.presentation.lipsync_frame_batch':
+            return 'lipsync';
+        default:
+            throw createNimiError({
+                message: `${messageType} does not admit runtime timeline metadata`,
+                reasonCode: ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED,
+                actionHint: 'check_runtime_agent_timeline_projection_shape',
+                source: 'sdk',
+            });
+    }
+}
+export function parseRuntimeAgentTimeline(value, messageType, expectedTurnId, expectedStreamId) {
+    const payload = asRecord(value);
+    const allowedKeys = [
+        'app_local_authority',
+        'channel',
+        'clock_basis',
+        'observed_at_wall',
+        'offset_ms',
+        'projection_rule_id',
+        'provider_neutral',
+        'sequence',
+        'started_at_wall',
+        'stream_id',
+        'timebase_owner',
+        'turn_id',
+    ];
+    const unknownKeys = Object.keys(payload).sort().filter((key) => !allowedKeys.includes(key));
+    if (unknownKeys.length > 0) {
+        throw createNimiError({
+            message: `${messageType} timeline contains unknown fields: ${unknownKeys.join(', ')}`,
+            reasonCode: ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED,
+            actionHint: 'check_runtime_agent_timeline_projection_shape',
+            source: 'sdk',
+        });
+    }
+    const turnId = expectString(payload.turn_id, 'timeline.turn_id', messageType);
+    const streamId = expectString(payload.stream_id, 'timeline.stream_id', messageType);
+    if (turnId !== expectedTurnId || streamId !== expectedStreamId) {
+        throw createNimiError({
+            message: `${messageType} timeline turn_id and stream_id must match the turn envelope`,
+            reasonCode: ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED,
+            actionHint: 'check_runtime_agent_timeline_projection_shape',
+            source: 'sdk',
+        });
+    }
+    const channel = expectString(payload.channel, 'timeline.channel', messageType);
+    const expectedChannel = timelineChannelForEvent(messageType);
+    if (channel !== expectedChannel) {
+        throw createNimiError({
+            message: `${messageType} timeline.channel must be ${expectedChannel}`,
+            reasonCode: ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED,
+            actionHint: 'check_runtime_agent_timeline_projection_shape',
+            source: 'sdk',
+        });
+    }
+    const offsetMs = expectTimelineNumber(payload.offset_ms, 'offset_ms', messageType);
+    if (offsetMs < 0) {
+        throw createNimiError({
+            message: `${messageType} timeline.offset_ms must be non-negative`,
+            reasonCode: ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED,
+            actionHint: 'check_runtime_agent_timeline_projection_shape',
+            source: 'sdk',
+        });
+    }
+    const sequence = expectTimelineNumber(payload.sequence, 'sequence', messageType);
+    if (sequence <= 0 || !Number.isInteger(sequence)) {
+        throw createNimiError({
+            message: `${messageType} timeline.sequence must be a positive integer`,
+            reasonCode: ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED,
+            actionHint: 'check_runtime_agent_timeline_projection_shape',
+            source: 'sdk',
+        });
+    }
+    const timebaseOwner = expectString(payload.timebase_owner, 'timeline.timebase_owner', messageType);
+    const projectionRuleId = expectString(payload.projection_rule_id, 'timeline.projection_rule_id', messageType);
+    const clockBasis = expectString(payload.clock_basis, 'timeline.clock_basis', messageType);
+    if (timebaseOwner !== 'runtime' || projectionRuleId !== 'K-AGCORE-051' || clockBasis !== 'monotonic_with_wall_anchor') {
+        throw createNimiError({
+            message: `${messageType} timeline authority fields must match runtime K-AGCORE-051`,
+            reasonCode: ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED,
+            actionHint: 'check_runtime_agent_timeline_projection_shape',
+            source: 'sdk',
+        });
+    }
+    return {
+        turnId,
+        streamId,
+        channel: channel,
+        offsetMs,
+        sequence,
+        startedAtWall: expectString(payload.started_at_wall, 'timeline.started_at_wall', messageType),
+        observedAtWall: expectString(payload.observed_at_wall, 'timeline.observed_at_wall', messageType),
+        timebaseOwner,
+        projectionRuleId,
+        clockBasis,
+        providerNeutral: expectTimelineBoolean(payload.provider_neutral, true, 'provider_neutral', messageType),
+        appLocalAuthority: expectTimelineBoolean(payload.app_local_authority, false, 'app_local_authority', messageType),
+    };
+}
+//# sourceMappingURL=runtime-agent-timeline-parsers.js.map

package/dist/runtime/runtime-agent-timeline-parsers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-agent-timeline-parsers.js","sourceRoot":"","sources":["../../src/runtime/runtime-agent-timeline-parsers.ts"],"names":[],"mappings":"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"}

package/dist/runtime/runtime-agent-transcript-parsers.d.ts

@@ -0,0 +1,3 @@
+import type { RuntimeAgentMessage } from './types-runtime-agent.js';
+export declare function parseTranscript(value: unknown): RuntimeAgentMessage[] | undefined;
+//# sourceMappingURL=runtime-agent-transcript-parsers.d.ts.map

package/dist/runtime/runtime-agent-transcript-parsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-agent-transcript-parsers.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime-agent-transcript-parsers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAWpE,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,EAAE,GAAG,SAAS,CAmBjF"}

package/dist/runtime/runtime-agent-transcript-parsers.js

@@ -0,0 +1,29 @@
+import { asRecord, normalizeText } from './helpers.js';
+function optionalString(value) {
+    const normalized = normalizeText(value);
+    return normalized || undefined;
+}
+function optionalContentString(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+export function parseTranscript(value) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const transcript = value.flatMap((item) => {
+        const payload = asRecord(item);
+        const role = normalizeText(payload.role);
+        const content = optionalContentString(payload.content);
+        const name = optionalString(payload.name);
+        if (!role || content === undefined) {
+            return [];
+        }
+        return [{
+                role,
+                content,
+                ...(name ? { name } : {}),
+            }];
+    });
+    return transcript.length > 0 ? transcript : undefined;
+}
+//# sourceMappingURL=runtime-agent-transcript-parsers.js.map

package/dist/runtime/runtime-agent-transcript-parsers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-agent-transcript-parsers.js","sourceRoot":"","sources":["../../src/runtime/runtime-agent-transcript-parsers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGvD,SAAS,cAAc,CAAC,KAAc;IACpC,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,UAAU,IAAI,SAAS,CAAC;AACjC,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACxC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAqC,CAAC;QAC7E,MAAM,OAAO,GAAG,qBAAqB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvD,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACnC,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,CAAC;gBACN,IAAI;gBACJ,OAAO;gBACP,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC"}

package/dist/runtime/runtime-agent-voice-lipsync-parsers.d.ts

@@ -0,0 +1,4 @@
+import type { RuntimeAgentPresentationLipsyncFrameBatchEvent, RuntimeAgentPresentationVoicePlaybackRequestedEvent } from './types-runtime-agent.js';
+export declare function parseRuntimeAgentVoicePlaybackDetail(detail: Record<string, unknown>, messageType: string): RuntimeAgentPresentationVoicePlaybackRequestedEvent['detail'];
+export declare function parseRuntimeAgentLipsyncFrameBatchDetail(detail: Record<string, unknown>, messageType: string): RuntimeAgentPresentationLipsyncFrameBatchEvent['detail'];
+//# sourceMappingURL=runtime-agent-voice-lipsync-parsers.d.ts.map

package/dist/runtime/runtime-agent-voice-lipsync-parsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-agent-voice-lipsync-parsers.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime-agent-voice-lipsync-parsers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,8CAA8C,EAC9C,mDAAmD,EAEpD,MAAM,0BAA0B,CAAC;AAuFlC,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,WAAW,EAAE,MAAM,GAClB,mDAAmD,CAAC,QAAQ,CAAC,CAS/D;AAED,wBAAgB,wCAAwC,CACtD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,WAAW,EAAE,MAAM,GAClB,8CAA8C,CAAC,QAAQ,CAAC,CA4C1D"}

package/dist/runtime/runtime-agent-voice-lipsync-parsers.js

@@ -0,0 +1,131 @@
+import { ReasonCode } from '../types/index.js';
+import { createNimiError } from './errors.js';
+import { asRecord, normalizeText, parseCount } from './helpers.js';
+function expectString(value, fieldName, messageType) {
+    const normalized = normalizeText(value);
+    if (!normalized) {
+        throw createNimiError({
+            message: `${messageType} requires ${fieldName}`,
+            reasonCode: ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED,
+            actionHint: 'check_runtime_agent_projection_shape',
+            source: 'sdk',
+        });
+    }
+    return normalized;
+}
+function optionalString(value) {
+    const normalized = normalizeText(value);
+    return normalized || undefined;
+}
+function optionalNumber(value) {
+    return parseCount(value);
+}
+function expectNonNegativeNumber(value, fieldName, messageType) {
+    const parsed = parseCount(value);
+    if (parsed === undefined) {
+        throw createNimiError({
+            message: `${messageType} ${fieldName} must be a non-negative number`,
+            reasonCode: ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED,
+            actionHint: 'check_runtime_agent_projection_shape',
+            source: 'sdk',
+        });
+    }
+    return parsed;
+}
+function expectPositiveInteger(value, fieldName, messageType) {
+    const parsed = parseCount(value);
+    if (parsed === undefined || parsed <= 0 || !Number.isInteger(parsed)) {
+        throw createNimiError({
+            message: `${messageType} ${fieldName} must be a positive integer`,
+            reasonCode: ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED,
+            actionHint: 'check_runtime_agent_projection_shape',
+            source: 'sdk',
+        });
+    }
+    return parsed;
+}
+function expectUnitNumber(value, fieldName, messageType) {
+    const parsed = parseCount(value);
+    if (parsed === undefined || parsed < 0 || parsed > 1) {
+        throw createNimiError({
+            message: `${messageType} ${fieldName} must be between 0 and 1`,
+            reasonCode: ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED,
+            actionHint: 'check_runtime_agent_projection_shape',
+            source: 'sdk',
+        });
+    }
+    return parsed;
+}
+function expectVoicePlaybackState(value, fieldName, messageType) {
+    const normalized = expectString(value, fieldName, messageType);
+    if (normalized === 'requested'
+        || normalized === 'started'
+        || normalized === 'completed'
+        || normalized === 'interrupted'
+        || normalized === 'canceled'
+        || normalized === 'failed') {
+        return normalized;
+    }
+    throw createNimiError({
+        message: `${messageType} ${fieldName} is not an admitted playback state`,
+        reasonCode: ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED,
+        actionHint: 'check_runtime_agent_projection_shape',
+        source: 'sdk',
+    });
+}
+export function parseRuntimeAgentVoicePlaybackDetail(detail, messageType) {
+    return {
+        audioArtifactId: expectString(detail.audio_artifact_id, 'detail.audio_artifact_id', messageType),
+        audioMimeType: expectString(detail.audio_mime_type, 'detail.audio_mime_type', messageType),
+        playbackState: expectVoicePlaybackState(detail.playback_state, 'detail.playback_state', messageType),
+        ...(optionalNumber(detail.duration_ms) !== undefined ? { durationMs: optionalNumber(detail.duration_ms) } : {}),
+        ...(optionalNumber(detail.deadline_offset_ms) !== undefined ? { deadlineOffsetMs: optionalNumber(detail.deadline_offset_ms) } : {}),
+        ...(optionalString(detail.reason) ? { reason: optionalString(detail.reason) } : {}),
+    };
+}
+export function parseRuntimeAgentLipsyncFrameBatchDetail(detail, messageType) {
+    if (!Array.isArray(detail.frames) || detail.frames.length === 0) {
+        throw createNimiError({
+            message: `${messageType} detail.frames must be a non-empty array`,
+            reasonCode: ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED,
+            actionHint: 'check_runtime_agent_projection_shape',
+            source: 'sdk',
+        });
+    }
+    let previousSequence = 0;
+    let previousOffset = -1;
+    return {
+        audioArtifactId: expectString(detail.audio_artifact_id, 'detail.audio_artifact_id', messageType),
+        frames: detail.frames.map((item) => {
+            const frame = asRecord(item);
+            const frameSequence = expectPositiveInteger(frame.frame_sequence, 'detail.frames[].frame_sequence', messageType);
+            const offsetMs = expectNonNegativeNumber(frame.offset_ms, 'detail.frames[].offset_ms', messageType);
+            if (frameSequence <= previousSequence) {
+                throw createNimiError({
+                    message: `${messageType} detail.frames[].frame_sequence must be monotonic`,
+                    reasonCode: ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED,
+                    actionHint: 'check_runtime_agent_projection_shape',
+                    source: 'sdk',
+                });
+            }
+            if (offsetMs < previousOffset) {
+                throw createNimiError({
+                    message: `${messageType} detail.frames[].offset_ms must be monotonic`,
+                    reasonCode: ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED,
+                    actionHint: 'check_runtime_agent_projection_shape',
+                    source: 'sdk',
+                });
+            }
+            previousSequence = frameSequence;
+            previousOffset = offsetMs;
+            return {
+                frameSequence,
+                offsetMs,
+                durationMs: expectPositiveInteger(frame.duration_ms, 'detail.frames[].duration_ms', messageType),
+                mouthOpenY: expectUnitNumber(frame.mouth_open_y, 'detail.frames[].mouth_open_y', messageType),
+                audioLevel: expectUnitNumber(frame.audio_level, 'detail.frames[].audio_level', messageType),
+            };
+        }),
+    };
+}
+//# sourceMappingURL=runtime-agent-voice-lipsync-parsers.js.map

package/dist/runtime/runtime-agent-voice-lipsync-parsers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-agent-voice-lipsync-parsers.js","sourceRoot":"","sources":["../../src/runtime/runtime-agent-voice-lipsync-parsers.ts"],"names":[],"mappings":"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"}

package/dist/runtime/runtime-ai-text.d.ts

@@ -0,0 +1,6 @@
+import type { RuntimeInternalContext } from './internal-context.js';
+import type { EmbeddingGenerateInput, EmbeddingGenerateOutput, TextGenerateInput, TextGenerateOutput, TextStreamInput, TextStreamOutput } from './types.js';
+export declare function runtimeGenerateText(ctx: RuntimeInternalContext, input: TextGenerateInput): Promise<TextGenerateOutput>;
+export declare function runtimeStreamText(ctx: RuntimeInternalContext, input: TextStreamInput): Promise<TextStreamOutput>;
+export declare function runtimeGenerateEmbedding(ctx: RuntimeInternalContext, input: EmbeddingGenerateInput): Promise<EmbeddingGenerateOutput>;
+//# sourceMappingURL=runtime-ai-text.d.ts.map

package/dist/runtime/runtime-ai-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-ai-text.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime-ai-text.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EACV,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAkBpB,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,sBAAsB,EAC3B,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,kBAAkB,CAAC,CA0E7B;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,sBAAsB,EAC3B,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,gBAAgB,CAAC,CA+I3B;AAED,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,sBAAsB,EAC3B,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CA6ElC"}