@nimiplatform/sdk 0.5.14

package/dist/runtime/runtime-companion-participation.js

@@ -0,0 +1,241 @@
+import { CompanionParticipationStatus, CompanionParticipationSurfaceKind, CompanionParticipationTriggerSource, } from './generated/runtime/v1/agent_service.js';
+import { toIsoFromTimestamp } from './helpers.js';
+const COMPANION_PARTICIPATION_READ_SCOPE = 'runtime.agent.companion_participation.read';
+const COMPANION_PARTICIPATION_WRITE_SCOPE = 'runtime.agent.companion_participation.write';
+function optionalString(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
+function requiredString(value, label) {
+    const normalized = optionalString(value);
+    if (!normalized) {
+        throw new Error(`runtime companion participation projection missing ${label}`);
+    }
+    return normalized;
+}
+function toScopedBindingAttachment(input, defaults) {
+    const bindingId = optionalString(input?.bindingId);
+    if (!bindingId) {
+        return undefined;
+    }
+    return {
+        bindingId,
+        bindingHandle: optionalString(input?.bindingHandle) || '',
+        runtimeAppId: optionalString(input?.runtimeAppId) || defaults.runtimeAppId,
+        appInstanceId: optionalString(input?.appInstanceId) || '',
+        windowId: optionalString(input?.windowId) || '',
+        avatarInstanceId: optionalString(input?.avatarInstanceId) || '',
+        agentId: optionalString(input?.localAgentRef) || optionalString(defaults.localAgentRef) || '',
+        conversationAnchorId: optionalString(input?.conversationAnchorId) || optionalString(defaults.conversationAnchorId) || '',
+        worldId: optionalString(input?.worldId) || '',
+    };
+}
+function requireLocalAgentIdentity(request) {
+    if (optionalString(request.agentId)) {
+        throw new Error('runtime companion participation request must use localAgentRef, not agentId');
+    }
+    const ownerUserId = optionalString(request.ownerUserId);
+    const realmAgentId = optionalString(request.realmAgentId);
+    const localAgentRef = optionalString(request.localAgentRef);
+    if (!ownerUserId || !realmAgentId || !localAgentRef) {
+        throw new Error('runtime companion participation request requires ownerUserId, realmAgentId, and localAgentRef');
+    }
+    if (!localAgentRef.startsWith('local-agent:')) {
+        throw new Error('runtime companion participation request localAgentRef is malformed');
+    }
+    if (localAgentRef !== `local-agent:${ownerUserId}:${realmAgentId}`) {
+        throw new Error('runtime companion participation request localAgentRef must match ownerUserId and realmAgentId');
+    }
+    return { ownerUserId, realmAgentId, localAgentRef };
+}
+async function contextForCompanionParticipation(input) {
+    const identity = requireLocalAgentIdentity(input.request);
+    const scopedBinding = toScopedBindingAttachment(input.request.scopedBinding, {
+        runtimeAppId: input.appId,
+        localAgentRef: identity.localAgentRef,
+        conversationAnchorId: input.request.conversationAnchorId,
+    });
+    if (scopedBinding) {
+        return {
+            appId: input.appId,
+            subjectUserId: '',
+            ownerUserId: identity.ownerUserId,
+            realmAgentId: identity.realmAgentId,
+            localAgentRef: identity.localAgentRef,
+            scopedBinding,
+        };
+    }
+    return {
+        appId: input.appId,
+        subjectUserId: await input.resolveSubjectUserId(input.request.subjectUserId || identity.ownerUserId),
+        ownerUserId: identity.ownerUserId,
+        realmAgentId: identity.realmAgentId,
+        localAgentRef: identity.localAgentRef,
+    };
+}
+function toProtoSurfaceKind(value) {
+    switch (value) {
+        case 'avatar_companion':
+            return CompanionParticipationSurfaceKind.AVATAR_COMPANION;
+        case 'desktop_companion_panel':
+            return CompanionParticipationSurfaceKind.DESKTOP_COMPANION_PANEL;
+        case 'avatar_debug_workbench':
+            return CompanionParticipationSurfaceKind.AVATAR_DEBUG_WORKBENCH;
+        default:
+            throw new Error(`unknown companion participation surface kind: ${String(value)}`);
+    }
+}
+function fromProtoSurfaceKind(value) {
+    switch (value) {
+        case CompanionParticipationSurfaceKind.AVATAR_COMPANION:
+            return 'avatar_companion';
+        case CompanionParticipationSurfaceKind.DESKTOP_COMPANION_PANEL:
+            return 'desktop_companion_panel';
+        case CompanionParticipationSurfaceKind.AVATAR_DEBUG_WORKBENCH:
+            return 'avatar_debug_workbench';
+        default:
+            throw new Error(`unknown companion participation projection surface kind: ${String(value)}`);
+    }
+}
+function toProtoTriggerSource(value) {
+    switch (value) {
+        case 'user_explicit':
+            return CompanionParticipationTriggerSource.USER_EXPLICIT;
+        case 'scheduled_proactive':
+            return CompanionParticipationTriggerSource.SCHEDULED_PROACTIVE;
+        case 'domain_event':
+            return CompanionParticipationTriggerSource.DOMAIN_EVENT;
+        default:
+            throw new Error(`unknown companion participation trigger source: ${String(value)}`);
+    }
+}
+function fromProtoTriggerSource(value) {
+    switch (value) {
+        case CompanionParticipationTriggerSource.USER_EXPLICIT:
+            return 'user_explicit';
+        case CompanionParticipationTriggerSource.SCHEDULED_PROACTIVE:
+            return 'scheduled_proactive';
+        case CompanionParticipationTriggerSource.DOMAIN_EVENT:
+            return 'domain_event';
+        default:
+            throw new Error(`unknown companion participation projection trigger source: ${String(value)}`);
+    }
+}
+function fromProtoStatus(value) {
+    switch (value) {
+        case CompanionParticipationStatus.IDLE:
+            return 'idle';
+        case CompanionParticipationStatus.ADMISSION_PENDING:
+            return 'admission_pending';
+        case CompanionParticipationStatus.BLOCKED:
+            return 'blocked';
+        case CompanionParticipationStatus.RUNNING:
+            return 'running';
+        case CompanionParticipationStatus.CANDIDATE_READY:
+            return 'candidate_ready';
+        case CompanionParticipationStatus.COMMITTED_BY_OWNER:
+            return 'committed_by_owner';
+        case CompanionParticipationStatus.FAILED:
+            return 'failed';
+        case CompanionParticipationStatus.CANCELED:
+            return 'canceled';
+        default:
+            throw new Error(`unknown companion participation projection status: ${String(value)}`);
+    }
+}
+export function decodeCompanionParticipationProjection(projection) {
+    if (!projection) {
+        throw new Error('runtime companion participation projection is required');
+    }
+    const status = fromProtoStatus(projection.status);
+    const candidateRef = optionalString(projection.candidateRef);
+    const commitRef = optionalString(projection.commitRef);
+    if (status === 'candidate_ready' && !candidateRef) {
+        throw new Error('runtime companion participation candidate_ready projection missing candidate_ref');
+    }
+    if (status === 'committed_by_owner' && !commitRef) {
+        throw new Error('runtime companion participation committed_by_owner projection missing commit_ref');
+    }
+    return {
+        projectionId: requiredString(projection.projectionId, 'projection_id'),
+        agentId: requiredString(projection.agentId, 'agent_id'),
+        surfaceKind: fromProtoSurfaceKind(projection.surfaceKind),
+        profileRef: requiredString(projection.profileRef, 'profile_ref'),
+        roomOrchestrationRef: requiredString(projection.roomOrchestrationRef, 'room_orchestration_ref'),
+        triggerSource: fromProtoTriggerSource(projection.triggerSource),
+        status,
+        ...(candidateRef ? { candidateRef } : {}),
+        ...(commitRef ? { commitRef } : {}),
+        ...(optionalString(projection.refusalReason) ? { refusalReason: optionalString(projection.refusalReason) } : {}),
+        ...(optionalString(projection.presentationRef) ? { presentationRef: optionalString(projection.presentationRef) } : {}),
+        auditRef: requiredString(projection.auditRef, 'audit_ref'),
+        ...(toIsoFromTimestamp(projection.observedAt) ? { observedAt: toIsoFromTimestamp(projection.observedAt) } : {}),
+        conversationAnchorId: requiredString(projection.conversationAnchorId, 'conversation_anchor_id'),
+        ...(optionalString(projection.turnId) ? { turnId: optionalString(projection.turnId) } : {}),
+        ...(optionalString(projection.streamId) ? { streamId: optionalString(projection.streamId) } : {}),
+    };
+}
+export function createRuntimeCompanionParticipationModule(input) {
+    async function buildContext(request) {
+        return contextForCompanionParticipation({
+            appId: input.appId,
+            request,
+            resolveSubjectUserId: input.resolveSubjectUserId,
+        });
+    }
+    function baseRequest(request, context) {
+        return {
+            context,
+            agentId: context.localAgentRef,
+            conversationAnchorId: request.conversationAnchorId,
+            surfaceKind: toProtoSurfaceKind(request.surfaceKind),
+            triggerSource: toProtoTriggerSource(request.triggerSource),
+            profileRef: optionalString(request.profileRef) || '',
+            roomOrchestrationRef: optionalString(request.roomOrchestrationRef) || '',
+            requestId: optionalString(request.requestId) || '',
+        };
+    }
+    return {
+        async getProjection(request, options) {
+            const context = await buildContext(request);
+            const callOptions = await input.protectedAccess.getCallOptions([COMPANION_PARTICIPATION_READ_SCOPE], options);
+            const response = await input.agent.getCompanionParticipationProjection(baseRequest(request, context), callOptions);
+            return decodeCompanionParticipationProjection(response.projection);
+        },
+        async request(request, options) {
+            const context = await buildContext(request);
+            const callOptions = await input.protectedAccess.getCallOptions([COMPANION_PARTICIPATION_WRITE_SCOPE], options);
+            const response = await input.agent.requestCompanionParticipation({
+                ...baseRequest(request, context),
+                text: requiredString(request.text, 'text'),
+                threadId: optionalString(request.threadId) || '',
+                worldId: optionalString(request.worldId) || '',
+                maxOutputTokens: Number.isFinite(request.maxOutputTokens) ? Math.trunc(Number(request.maxOutputTokens)) : 0,
+            }, callOptions);
+            return decodeCompanionParticipationProjection(response.projection);
+        },
+        async cancel(request, options) {
+            const context = await buildContext(request);
+            const callOptions = await input.protectedAccess.getCallOptions([COMPANION_PARTICIPATION_WRITE_SCOPE], options);
+            const response = await input.agent.cancelCompanionParticipation({
+                ...baseRequest(request, context),
+                projectionId: optionalString(request.projectionId) || '',
+                turnId: optionalString(request.turnId) || '',
+                reason: optionalString(request.reason) || '',
+            }, callOptions);
+            return decodeCompanionParticipationProjection(response.projection);
+        },
+        async openReplay(request, options) {
+            const context = await buildContext(request);
+            const callOptions = await input.protectedAccess.getCallOptions([COMPANION_PARTICIPATION_READ_SCOPE], options);
+            const response = await input.agent.openCompanionParticipationReplay({
+                ...baseRequest(request, context),
+                projectionId: requiredString(request.projectionId, 'projection_id'),
+            }, callOptions);
+            return {
+                replayRef: requiredString(response.replayRef, 'replay_ref'),
+                projection: decodeCompanionParticipationProjection(response.projection),
+            };
+        },
+    };
+}
+//# sourceMappingURL=runtime-companion-participation.js.map

package/dist/runtime/runtime-companion-participation.js.map

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

package/dist/runtime/runtime-convenience.d.ts

@@ -0,0 +1,64 @@
+import type { AiRoutePolicy, NimiError } from '../types/index.js';
+import type { RuntimeMetadata } from './types.js';
+import type { NimiFinishReason, NimiReasoningConfig, TextGenerateInput, TextGenerateOutput, TextMessage, TextStreamInput, TextStreamOutput } from './types-media.js';
+export type RuntimePrompt = string | TextMessage[];
+export type RuntimeGenerateInput = {
+    model?: string;
+    provider?: string;
+    prompt: RuntimePrompt;
+    system?: string;
+    reasoning?: NimiReasoningConfig;
+    maxTokens?: number;
+    temperature?: number;
+    topP?: number;
+    subjectUserId?: string;
+    timeoutMs?: number;
+    metadata?: RuntimeMetadata;
+};
+export type RuntimeGenerateResult = {
+    text: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    finishReason: NimiFinishReason | string;
+    traceId: string;
+    modelResolved: string;
+    routeDecision: AiRoutePolicy;
+};
+export type RuntimeStreamInput = RuntimeGenerateInput & {
+    signal?: AbortSignal;
+};
+export type RuntimeStreamChunk = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'reasoning';
+    text: string;
+} | {
+    type: 'done';
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    finishReason: NimiFinishReason | string;
+    traceId: string;
+    modelResolved: string;
+    routeDecision: AiRoutePolicy;
+} | {
+    type: 'error';
+    error: NimiError;
+};
+type RuntimeTextGenerateDelegate = {
+    ai: {
+        text: {
+            generate(input: TextGenerateInput): Promise<TextGenerateOutput>;
+            stream(input: TextStreamInput): Promise<TextStreamOutput>;
+        };
+    };
+};
+export declare function toRuntimeGenerateResult(output: TextGenerateOutput): RuntimeGenerateResult;
+export declare function runtimeGenerateConvenience(runtime: RuntimeTextGenerateDelegate, input: RuntimeGenerateInput): Promise<RuntimeGenerateResult>;
+export declare function runtimeStreamConvenience(runtime: RuntimeTextGenerateDelegate, input: RuntimeStreamInput): Promise<AsyncIterable<RuntimeStreamChunk>>;
+export {};
+//# sourceMappingURL=runtime-convenience.d.ts.map

package/dist/runtime/runtime-convenience.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-convenience.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime-convenience.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAIlE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,eAAe,EAEf,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAG1B,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,WAAW,EAAE,CAAC;AAEnD,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,YAAY,EAAE,gBAAgB,GAAG,MAAM,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,oBAAoB,GAAG;IACtD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnC;IACA,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,YAAY,EAAE,gBAAgB,GAAG,MAAM,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,aAAa,CAAC;CAC9B,GACC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAExC,KAAK,2BAA2B,GAAG;IACjC,EAAE,EAAE;QACF,IAAI,EAAE;YACJ,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;YAChE,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;SAC3D,CAAC;KACH,CAAC;CACH,CAAC;AAsJF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,kBAAkB,GAAG,qBAAqB,CASzF;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,2BAA2B,EACpC,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CAGhC;AAkCD,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,2BAA2B,EACpC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC,CAY5C"}

package/dist/runtime/runtime-convenience.js

@@ -0,0 +1,164 @@
+import { ReasonCode } from '../types/index.js';
+import { assertNoLegacyLocalModelPrefix } from '../internal/legacy-local-model-prefix.js';
+import { createNimiError } from './errors.js';
+import { REMOTE_PROVIDER_IDS } from './provider-targeting.generated.js';
+const REMOTE_PROVIDER_SET = new Set(REMOTE_PROVIDER_IDS);
+function normalize(value) {
+    return String(value || '').trim();
+}
+function isLowercaseQualifiedPrefix(prefix) {
+    return prefix === prefix.toLowerCase() && /^[a-z0-9_][a-z0-9_-]*$/u.test(prefix);
+}
+function looksLikeQualifiedRemoteModel(model) {
+    const normalized = normalize(model);
+    if (!normalized.includes('/')) {
+        return false;
+    }
+    assertNoLegacyLocalModelPrefix(normalized);
+    const [prefix = ''] = normalized.split('/', 1);
+    const lowered = prefix.toLowerCase();
+    if (lowered === 'cloud'
+        || lowered === 'local'
+        || lowered === 'llama'
+        || lowered === 'media'
+        || lowered === 'speech'
+        || lowered === 'sidecar') {
+        return true;
+    }
+    return isLowercaseQualifiedPrefix(prefix) && REMOTE_PROVIDER_SET.has(lowered);
+}
+function createRuntimeConvenienceInputError(message, actionHint) {
+    return createNimiError({
+        message,
+        reasonCode: ReasonCode.ACTION_INPUT_INVALID,
+        actionHint,
+        source: 'sdk',
+    });
+}
+function resolveRuntimeConvenienceTarget(input) {
+    const provider = normalize(input.provider);
+    const model = normalize(input.model);
+    if (!provider && !model) {
+        throw createRuntimeConvenienceInputError('high-level Runtime.generate()/stream() requires an explicit local model or provider + model.', 'provide_runtime_target');
+    }
+    if (!provider) {
+        if (looksLikeQualifiedRemoteModel(model)) {
+            throw createRuntimeConvenienceInputError('high-level Runtime.generate()/stream() does not accept fully-qualified remote model ids. Use provider + model, or use runtime.ai.text.generate() for explicit remote model ids.', 'remove_remote_model_prefix');
+        }
+        return {
+            model: `local/${model}`,
+            route: 'local',
+        };
+    }
+    if (!REMOTE_PROVIDER_SET.has(provider.toLowerCase())) {
+        throw createRuntimeConvenienceInputError(`unsupported provider "${provider}". Use a canonical provider id such as gemini, openai, anthropic, or deepseek.`, 'use_supported_provider_id');
+    }
+    if (!model) {
+        throw createRuntimeConvenienceInputError('high-level Runtime.generate()/stream() requires provider + model for cloud routing. It no longer invents an implicit provider/default target.', 'provide_provider_and_model');
+    }
+    if (model && looksLikeQualifiedRemoteModel(model)) {
+        throw createRuntimeConvenienceInputError('provider + model expects a provider-scoped model id. Remove the remote prefix, or use runtime.ai.text.generate() for explicit fully-qualified remote model ids.', 'remove_remote_model_prefix');
+    }
+    return {
+        model: `${provider}/${model}`,
+        route: 'cloud',
+    };
+}
+function resolveRuntimeConvenienceSubjectUserId(subjectUserId, route) {
+    const normalized = normalize(subjectUserId);
+    if (normalized) {
+        return normalized;
+    }
+    if (route === 'local') {
+        return undefined;
+    }
+    throw createRuntimeConvenienceInputError('high-level Runtime.generate()/stream() requires subjectUserId for non-local routing. It no longer invents an implicit subject identity.', 'provide_subject_user_id');
+}
+function toGenerateInput(input) {
+    const target = resolveRuntimeConvenienceTarget(input);
+    const subjectUserId = resolveRuntimeConvenienceSubjectUserId(input.subjectUserId, target.route);
+    return {
+        model: target.model,
+        input: input.prompt,
+        system: input.system,
+        maxTokens: input.maxTokens,
+        temperature: input.temperature,
+        topP: input.topP,
+        reasoning: input.reasoning,
+        subjectUserId,
+        route: target.route,
+        timeoutMs: input.timeoutMs,
+        metadata: input.metadata,
+    };
+}
+function toStreamInput(input) {
+    return {
+        ...toGenerateInput(input),
+        signal: input.signal,
+    };
+}
+function toUsage(input) {
+    return {
+        inputTokens: Number(input?.inputTokens || 0),
+        outputTokens: Number(input?.outputTokens || 0),
+    };
+}
+export function toRuntimeGenerateResult(output) {
+    return {
+        text: output.text,
+        usage: toUsage(output.usage),
+        finishReason: output.finishReason,
+        traceId: String(output.trace.traceId || ''),
+        modelResolved: String(output.trace.modelResolved || ''),
+        routeDecision: output.trace.routeDecision || 'local',
+    };
+}
+export async function runtimeGenerateConvenience(runtime, input) {
+    const output = await runtime.ai.text.generate(toGenerateInput(input));
+    return toRuntimeGenerateResult(output);
+}
+function mapStreamPart(part) {
+    if (part.type === 'delta') {
+        return {
+            type: 'text',
+            text: part.text,
+        };
+    }
+    if (part.type === 'reasoning-delta') {
+        return {
+            type: 'reasoning',
+            text: part.text,
+        };
+    }
+    if (part.type === 'finish') {
+        return {
+            type: 'done',
+            usage: toUsage(part.usage),
+            finishReason: part.finishReason,
+            traceId: String(part.trace.traceId || ''),
+            modelResolved: String(part.trace.modelResolved || ''),
+            routeDecision: part.trace.routeDecision || 'local',
+        };
+    }
+    if (part.type === 'error') {
+        return {
+            type: 'error',
+            error: part.error,
+        };
+    }
+    return null;
+}
+export async function runtimeStreamConvenience(runtime, input) {
+    const output = await runtime.ai.text.stream(toStreamInput(input));
+    return {
+        async *[Symbol.asyncIterator]() {
+            for await (const part of output.stream) {
+                const chunk = mapStreamPart(part);
+                if (chunk) {
+                    yield chunk;
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=runtime-convenience.js.map

package/dist/runtime/runtime-convenience.js.map

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

package/dist/runtime/runtime-guards.d.ts

@@ -0,0 +1,48 @@
+import type { JsonObject } from '../internal/utils.js';
+import type { NimiError, VersionCompatibilityStatus } from '../types/index.js';
+import { RoutePolicy } from './generated/runtime/v1/ai.js';
+import type { RuntimeMetadata, RuntimeOptions } from './types.js';
+export declare function checkRuntimeVersionCompatibility(input: {
+    version: string;
+    versionChecked: boolean;
+    sdkRuntimeMajor: number;
+    emitTelemetry: (name: string, data?: JsonObject) => void;
+    emitError: (error: NimiError) => void;
+    setStatus?: (status: VersionCompatibilityStatus) => void;
+}): VersionCompatibilityStatus;
+export declare function assertRuntimeMethodAvailable(input: {
+    moduleKey: string;
+    methodKey: string;
+    runtimeVersion: string | null;
+    sdkRuntimeMajor: number;
+    phase2ModuleKeys: ReadonlySet<string>;
+    phase2AuditMethodIds: ReadonlySet<string>;
+    auditMethodIds: Record<string, string>;
+}): void;
+export declare function wrapModeDStream<T>(input: {
+    source: AsyncIterable<T>;
+    onCancelled: () => void;
+}): AsyncIterable<T>;
+export declare function resolveRuntimeSubjectUserId(input: {
+    explicit?: string;
+    subjectContext?: RuntimeOptions['subjectContext'];
+}): Promise<string>;
+export declare function resolveOptionalRuntimeSubjectUserId(input: {
+    explicit?: string;
+    subjectContext?: RuntimeOptions['subjectContext'];
+}): Promise<string | undefined>;
+type RuntimeAiRequestLike = {
+    routePolicy?: RoutePolicy;
+    connectorId?: string;
+    head?: {
+        routePolicy?: RoutePolicy;
+        connectorId?: string;
+    };
+};
+type RuntimeAiMetadataLike = Pick<RuntimeMetadata, 'keySource' | 'providerType' | 'providerEndpoint' | 'providerApiKey'> | JsonObject | undefined;
+export declare function runtimeAiRequestRequiresSubject(input: {
+    request: RuntimeAiRequestLike;
+    metadata?: RuntimeAiMetadataLike;
+}): boolean;
+export {};
+//# sourceMappingURL=runtime-guards.d.ts.map

package/dist/runtime/runtime-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-guards.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime-guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,SAAS,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAM/E,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAElE,wBAAgB,gCAAgC,CAAC,KAAK,EAAE;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;IACzD,SAAS,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACtC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,0BAA0B,KAAK,IAAI,CAAC;CAC1D,GAAG,0BAA0B,CA0D7B;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACtC,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC,GAAG,IAAI,CAwCP;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE;IACxC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACzB,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB,GAAG,aAAa,CAAC,CAAC,CAAC,CAoBnB;AAED,wBAAsB,2BAA2B,CAAC,KAAK,EAAE;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAC;CACnD,GAAG,OAAO,CAAC,MAAM,CAAC,CAYlB;AAED,wBAAsB,mCAAmC,CAAC,KAAK,EAAE;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAC;CACnD,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAoB9B;AAED,KAAK,oBAAoB,GAAG;IAC1B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE;QACL,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH,CAAC;AAEF,KAAK,qBAAqB,GACtB,IAAI,CAAC,eAAe,EAAE,WAAW,GAAG,cAAc,GAAG,kBAAkB,GAAG,gBAAgB,CAAC,GAC3F,UAAU,GACV,SAAS,CAAC;AAkBd,wBAAgB,+BAA+B,CAAC,KAAK,EAAE;IACrD,OAAO,EAAE,oBAAoB,CAAC;IAC9B,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC,GAAG,OAAO,CAqBV"}