@nimiplatform/sdk 0.5.14

package/LICENSE

@@ -0,0 +1,2 @@
+SPDX-License-Identifier: Apache-2.0
+See ../../licenses/Apache-2.0.txt

package/README.md

@@ -0,0 +1,30 @@
+# sdk
+
+SDK 已完成单包收敛：
+
+- 物理包仅保留 `sdk`
+- 对外仅发布 `@nimiplatform/sdk`
+- 根入口 `@nimiplatform/sdk` 作为 app 级组合面
+- 能力通过稳定子路径暴露：`@nimiplatform/sdk/*`
+
+## Public Subpaths
+
+- `@nimiplatform/sdk` — app-level composition entry (`createPlatformClient`)
+- `@nimiplatform/sdk/realm` — Realm cloud state integration
+- `@nimiplatform/sdk/runtime` — Runtime core (Node/gRPC transport)
+- `@nimiplatform/sdk/runtime/browser` — Runtime browser transport (Tauri IPC / HTTP)
+- `@nimiplatform/sdk/types` — Shared type definitions
+- `@nimiplatform/sdk/scope` — Scope and capability management
+- `@nimiplatform/sdk/ai-provider` — Vercel AI SDK provider adapter
+- `@nimiplatform/sdk/mod` — Mod system entry
+- `@nimiplatform/sdk/mod/shell` — Mod shell utilities
+- `@nimiplatform/sdk/mod/lifecycle` — Mod lifecycle hooks
+- `@nimiplatform/sdk/mod/storage` — Mod storage system
+
+## Guardrails
+
+- 禁止 legacy 包导入（`sdk-realm/sdk-runtime/sdk-types/mod-sdk/ai-provider`）
+- 禁止 `@nimiplatform/sdk/realm/core|models|services|generated` 深层导入
+- 第一方 app/docs/examples 默认使用 `createPlatformClient()`，子路径仅在 low-level escape hatch 或 domain-specific 语境下直接使用
+- `reasonCode` 必须使用 `ReasonCode` 常量
+- TypeScript 统一 `strict + noImplicitAny`

package/dist/ai-provider/helpers-scenario.d.ts

@@ -0,0 +1,23 @@
+import { type RuntimeAiSubmitScenarioJobRequestInput } from '../runtime/browser.js';
+import { type AiRoutePolicy } from '../types/index.js';
+import { type NimiArtifact, type RuntimeDefaults, type RuntimeForAiProvider } from './types.js';
+import { type ScenarioArtifact, type ScenarioOutput } from '../runtime/generated/runtime/v1/ai.js';
+type ScenarioJobExecution = {
+    artifacts: NimiArtifact[];
+    traceId: string;
+    routeDecision: AiRoutePolicy;
+    modelResolved: string;
+    output?: ScenarioOutput;
+};
+export declare function executeScenarioJob(runtime: RuntimeForAiProvider, defaults: RuntimeDefaults, request: RuntimeAiSubmitScenarioJobRequestInput, timeoutMs: number, signal?: AbortSignal): Promise<ScenarioJobExecution>;
+export declare function collectArtifacts(stream: AsyncIterable<unknown>): Promise<NimiArtifact[]>;
+export declare function toEmbeddingVectors(vectors: unknown): number[][];
+export declare function toEmbeddingVectorsFromScenarioOutput(output: ScenarioOutput | undefined): number[][];
+export declare function toSpeechTranscriptionFromScenarioOutput(output: ScenarioOutput | undefined): {
+    text: string;
+    artifacts: ScenarioArtifact[];
+};
+export declare function toSpeechSynthesisArtifactsFromScenarioOutput(output: ScenarioOutput | undefined): ScenarioArtifact[];
+export declare function normalizeProviderError(error: unknown): import("../index.js").NimiError;
+export {};
+//# sourceMappingURL=helpers-scenario.d.ts.map

package/dist/ai-provider/helpers-scenario.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers-scenario.d.ts","sourceRoot":"","sources":["../../src/ai-provider/helpers-scenario.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,sCAAsC,EAC5C,MAAM,uBAAuB,CAAC;AAK/B,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAC;AASpB,OAAO,EAOL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACpB,MAAM,uCAAuC,CAAC;AAE/C,KAAK,oBAAoB,GAAG;IAC1B,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,aAAa,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB,CAAC;AA2CF,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,oBAAoB,EAC7B,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,sCAAsC,EAC/C,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,oBAAoB,CAAC,CA8G/B;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA4E9F;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,EAAE,CAQ/D;AAED,wBAAgB,oCAAoC,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,GAAG,MAAM,EAAE,EAAE,CAQnG;AAED,wBAAgB,uCAAuC,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,GAAG;IAC3F,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,gBAAgB,EAAE,CAAC;CAC/B,CAcA;AAED,wBAAgB,4CAA4C,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,GAAG,gBAAgB,EAAE,CAQnH;AA0BD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,mCAMpD"}

package/dist/ai-provider/helpers-scenario.js

@@ -0,0 +1,280 @@
+import { asNimiError, createNimiError, } from '../runtime/browser.js';
+import { Struct as ProtoStruct } from '../runtime/generated/google/protobuf/struct.js';
+import { ReasonCode } from '../types/index.js';
+import { asRecord, normalizeText } from '../internal/utils.js';
+import { concatChunks, ensureText, fromRouteDecision, toCallOptions, } from './helpers-shared.js';
+import { ReasonCode as RuntimeReasonCode } from '../runtime/generated/runtime/v1/common.js';
+import { ExecutionMode, ScenarioJobStatus, } from '../runtime/generated/runtime/v1/ai.js';
+function ensureScenarioJobReasonCode(value) {
+    const numeric = Number(value);
+    if (Number.isFinite(numeric)) {
+        const enumName = RuntimeReasonCode[numeric];
+        if (enumName && enumName !== 'REASON_CODE_UNSPECIFIED') {
+            return String(enumName).trim();
+        }
+    }
+    const reasonCode = normalizeText(value);
+    if (reasonCode) {
+        return reasonCode;
+    }
+    throw createNimiError({
+        message: 'scenario job response missing reasonCode',
+        reasonCode: ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED,
+        actionHint: 'regenerate_runtime_proto_and_sdk',
+        source: 'runtime',
+    });
+}
+function sleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+function nextPollDelayMs(attempt) {
+    return Math.min(2_000, 250 * Math.max(1, attempt));
+}
+function scenarioJobReasonDetails(job) {
+    const metadata = job?.reasonMetadata;
+    if (!metadata || typeof metadata !== 'object') {
+        return undefined;
+    }
+    const json = ProtoStruct.toJson(metadata);
+    return json && typeof json === 'object' && !Array.isArray(json)
+        ? json
+        : undefined;
+}
+export async function executeScenarioJob(runtime, defaults, request, timeoutMs, signal) {
+    const submitRequest = {
+        ...request,
+        executionMode: Number(request.executionMode || ExecutionMode.ASYNC_JOB),
+        extensions: Array.isArray(request.extensions) ? request.extensions : [],
+    };
+    const submitResponse = await runtime.ai.submitScenarioJob(submitRequest, toCallOptions(defaults, {
+        timeoutMs,
+        metadata: undefined,
+    }));
+    const initialJob = submitResponse.job;
+    const jobId = ensureText(initialJob?.jobId, 'jobId');
+    const startedAt = Date.now();
+    const maxWaitMs = timeoutMs > 0 ? timeoutMs : 120000;
+    let cancelIssued = false;
+    let pollAttempt = 0;
+    const cancelRemoteJob = async (reason) => {
+        if (cancelIssued) {
+            return;
+        }
+        cancelIssued = true;
+        try {
+            const cancelRequest = {
+                jobId,
+                reason,
+            };
+            await runtime.ai.cancelScenarioJob(cancelRequest, toCallOptions(defaults, { timeoutMs }));
+        }
+        catch {
+            // ignore cancel errors and preserve original failure reason
+        }
+    };
+    while (true) {
+        if (signal?.aborted) {
+            await cancelRemoteJob('aborted_by_abort_signal');
+            throw createNimiError({
+                message: 'scenario job aborted',
+                reasonCode: ReasonCode.OPERATION_ABORTED,
+                actionHint: 'retry_scenario_job_request',
+                source: 'sdk',
+            });
+        }
+        const jobRequest = { jobId };
+        const jobResponse = await runtime.ai.getScenarioJob(jobRequest, toCallOptions(defaults, { timeoutMs }));
+        const job = jobResponse.job;
+        const status = Number(job?.status || 0);
+        if (status === ScenarioJobStatus.COMPLETED) {
+            const artifactsRequest = { jobId };
+            const artifactsResponse = await runtime.ai.getScenarioArtifacts(artifactsRequest, toCallOptions(defaults, { timeoutMs }));
+            const artifacts = Array.isArray(artifactsResponse.artifacts)
+                ? artifactsResponse.artifacts
+                : [];
+            const traceId = normalizeText(artifactsResponse.traceId) || normalizeText(job?.traceId);
+            const routeDecision = fromRouteDecision(job?.routeDecision);
+            const modelResolved = normalizeText(job?.modelResolved) || normalizeText(request.head?.modelId);
+            return {
+                artifacts: artifacts.map((item) => {
+                    const bytes = item.bytes instanceof Uint8Array
+                        ? item.bytes
+                        : new Uint8Array(0);
+                    return {
+                        artifactId: normalizeText(item.artifactId),
+                        mimeType: normalizeText(item.mimeType),
+                        bytes,
+                        traceId,
+                        routeDecision,
+                        modelResolved,
+                    };
+                }),
+                traceId,
+                routeDecision,
+                modelResolved,
+                output: artifactsResponse.output,
+            };
+        }
+        if (status === ScenarioJobStatus.FAILED
+            || status === ScenarioJobStatus.CANCELED
+            || status === ScenarioJobStatus.TIMEOUT) {
+            const reasonCode = ensureScenarioJobReasonCode(job?.reasonCode);
+            throw createNimiError({
+                message: normalizeText(job?.reasonDetail) || `scenario job failed: ${reasonCode}`,
+                reasonCode,
+                actionHint: 'retry_scenario_job_request',
+                traceId: normalizeText(job?.traceId),
+                source: 'runtime',
+                details: scenarioJobReasonDetails(job),
+            });
+        }
+        if ((Date.now() - startedAt) > maxWaitMs) {
+            await cancelRemoteJob('aborted_by_sdk_timeout');
+            throw createNimiError({
+                message: 'scenario job timeout',
+                reasonCode: ReasonCode.AI_PROVIDER_TIMEOUT,
+                actionHint: 'retry_scenario_job_request',
+                source: 'runtime',
+            });
+        }
+        pollAttempt += 1;
+        await sleep(nextPollDelayMs(pollAttempt));
+    }
+}
+export async function collectArtifacts(stream) {
+    const order = [];
+    const states = new Map();
+    for await (const item of stream) {
+        const chunk = asRecord(item);
+        const artifactId = normalizeText(chunk.artifactId) || `artifact-${order.length + 1}`;
+        const state = states.get(artifactId) || {
+            artifactId,
+            mimeType: '',
+            chunks: [],
+            traceId: '',
+            routeDecision: 'local',
+            modelResolved: '',
+        };
+        if (!states.has(artifactId)) {
+            states.set(artifactId, state);
+            order.push(artifactId);
+        }
+        const mimeType = normalizeText(chunk.mimeType);
+        if (mimeType) {
+            state.mimeType = mimeType;
+        }
+        const traceId = normalizeText(chunk.traceId);
+        if (traceId) {
+            state.traceId = traceId;
+        }
+        const modelResolved = normalizeText(chunk.modelResolved);
+        if (modelResolved) {
+            state.modelResolved = modelResolved;
+        }
+        state.routeDecision = fromRouteDecision(chunk.routeDecision);
+        const bytes = chunk.chunk;
+        if (bytes instanceof Uint8Array) {
+            state.chunks.push(bytes);
+        }
+        else if (bytes instanceof ArrayBuffer) {
+            state.chunks.push(new Uint8Array(bytes));
+        }
+        else if (Array.isArray(bytes)) {
+            state.chunks.push(Uint8Array.from(bytes.map((value) => Number(value) || 0)));
+        }
+    }
+    return order.map((artifactId) => {
+        const state = states.get(artifactId);
+        if (!state) {
+            return {
+                artifactId,
+                mimeType: '',
+                bytes: new Uint8Array(0),
+                traceId: '',
+                routeDecision: 'local',
+                modelResolved: '',
+            };
+        }
+        return {
+            artifactId: state.artifactId,
+            mimeType: state.mimeType,
+            bytes: concatChunks(state.chunks),
+            traceId: state.traceId,
+            routeDecision: state.routeDecision,
+            modelResolved: state.modelResolved,
+        };
+    });
+}
+export function toEmbeddingVectors(vectors) {
+    const list = Array.isArray(vectors) ? vectors : [];
+    return list.map((entry) => {
+        const values = readLooseListValues(entry);
+        return values
+            .map((value) => readNumberValue(value))
+            .filter((value) => typeof value === 'number');
+    });
+}
+export function toEmbeddingVectorsFromScenarioOutput(output) {
+    const variant = output?.output;
+    if (variant?.oneofKind !== 'textEmbed') {
+        return [];
+    }
+    return variant.textEmbed.vectors.map((row) => row.values
+        .map((item) => Number(item))
+        .filter((item) => Number.isFinite(item)));
+}
+export function toSpeechTranscriptionFromScenarioOutput(output) {
+    const variant = output?.output;
+    if (variant?.oneofKind !== 'speechTranscribe') {
+        return {
+            text: '',
+            artifacts: [],
+        };
+    }
+    return {
+        text: normalizeText(variant.speechTranscribe.text),
+        artifacts: Array.isArray(variant.speechTranscribe.artifacts)
+            ? variant.speechTranscribe.artifacts
+            : [],
+    };
+}
+export function toSpeechSynthesisArtifactsFromScenarioOutput(output) {
+    const variant = output?.output;
+    if (variant?.oneofKind !== 'speechSynthesize') {
+        return [];
+    }
+    return Array.isArray(variant.speechSynthesize.artifacts)
+        ? variant.speechSynthesize.artifacts
+        : [];
+}
+function readLooseListValues(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return [];
+    }
+    const values = value.values;
+    return Array.isArray(values) ? values.filter(isProtoNumberValue) : [];
+}
+function isProtoNumberValue(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return false;
+    }
+    const kind = asRecord(value.kind);
+    return kind.oneofKind === 'numberValue';
+}
+function readNumberValue(value) {
+    if (value?.kind.oneofKind !== 'numberValue') {
+        return undefined;
+    }
+    const parsed = Number(value.kind.numberValue);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+export function normalizeProviderError(error) {
+    return asNimiError(error, {
+        reasonCode: ReasonCode.AI_PROVIDER_UNAVAILABLE,
+        actionHint: 'check_runtime_and_route_policy',
+        source: 'runtime',
+    });
+}
+//# sourceMappingURL=helpers-scenario.js.map

package/dist/ai-provider/helpers-scenario.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers-scenario.js","sourceRoot":"","sources":["../../src/ai-provider/helpers-scenario.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,eAAe,GAEhB,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,gDAAgD,CAAC;AACvF,OAAO,EAAE,UAAU,EAAsB,MAAM,mBAAmB,CAAC;AAMnE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EACL,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,UAAU,IAAI,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAC5F,OAAO,EAEL,aAAa,EAIb,iBAAiB,GAGlB,MAAM,uCAAuC,CAAC;AAU/C,SAAS,2BAA2B,CAAC,KAAc;IACjD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAI,iBAAuD,CAAC,OAAO,CAAC,CAAC;QACnF,IAAI,QAAQ,IAAI,QAAQ,KAAK,yBAAyB,EAAE,CAAC;YACvD,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACjC,CAAC;IACH,CAAC;IACD,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,MAAM,eAAe,CAAC;QACpB,OAAO,EAAE,0CAA0C;QACnD,UAAU,EAAE,UAAU,CAAC,kCAAkC;QACzD,UAAU,EAAE,kCAAkC;QAC9C,MAAM,EAAE,SAAS;KAClB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,OAAe;IACtC,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,wBAAwB,CAAC,GAAmC;IACnE,MAAM,QAAQ,GAAG,GAAG,EAAE,cAAc,CAAC;IACrC,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9C,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,QAAoD,CAAC,CAAC;IACtF,OAAO,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAC7D,CAAC,CAAC,IAA+B;QACjC,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAA6B,EAC7B,QAAyB,EACzB,OAA+C,EAC/C,SAAiB,EACjB,MAAoB;IAEpB,MAAM,aAAa,GAAG;QACpB,GAAG,OAAO;QACV,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,aAAa,IAAI,aAAa,CAAC,SAAS,CAAC;QACvE,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE;KACxE,CAAC;IACF,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,EAAE,CAAC,iBAAiB,CACvD,aAAa,EACb,aAAa,CAAC,QAAQ,EAAE;QACtB,SAAS;QACT,QAAQ,EAAE,SAAS;KACpB,CAAC,CACH,CAAC;IACF,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,CAAC;IACtC,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,SAAS,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;IACrD,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,MAAM,eAAe,GAAG,KAAK,EAAE,MAAc,EAAE,EAAE;QAC/C,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QACD,YAAY,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,aAAa,GAA6B;gBAC9C,KAAK;gBACL,MAAM;aACP,CAAC;YACF,MAAM,OAAO,CAAC,EAAE,CAAC,iBAAiB,CAChC,aAAa,EACb,aAAa,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,CACvC,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,4DAA4D;QAC9D,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,eAAe,CAAC,yBAAyB,CAAC,CAAC;YACjD,MAAM,eAAe,CAAC;gBACpB,OAAO,EAAE,sBAAsB;gBAC/B,UAAU,EAAE,UAAU,CAAC,iBAAiB;gBACxC,UAAU,EAAE,4BAA4B;gBACxC,MAAM,EAAE,KAAK;aACd,CAAC,CAAC;QACL,CAAC;QAED,MAAM,UAAU,GAA0B,EAAE,KAAK,EAAE,CAAC;QACpD,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,EAAE,CAAC,cAAc,CAAC,UAAU,EAAE,aAAa,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QACxG,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC;QAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;QACxC,IAAI,MAAM,KAAK,iBAAiB,CAAC,SAAS,EAAE,CAAC;YAC3C,MAAM,gBAAgB,GAAgC,EAAE,KAAK,EAAE,CAAC;YAChE,MAAM,iBAAiB,GAAG,MAAM,OAAO,CAAC,EAAE,CAAC,oBAAoB,CAAC,gBAAgB,EAAE,aAAa,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;YAC1H,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,SAAS,CAAC;gBAC1D,CAAC,CAAC,iBAAiB,CAAC,SAAS;gBAC7B,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,OAAO,GAAG,aAAa,CAAC,iBAAiB,CAAC,OAAO,CAAC,IAAI,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YACxF,MAAM,aAAa,GAAG,iBAAiB,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;YAC5D,MAAM,aAAa,GAAG,aAAa,CAAC,GAAG,EAAE,aAAa,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAEhG,OAAO;gBACL,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,IAAsB,EAAE,EAAE;oBAClD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,YAAY,UAAU;wBAC5C,CAAC,CAAC,IAAI,CAAC,KAAK;wBACZ,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;oBACtB,OAAO;wBACL,UAAU,EAAE,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC;wBAC1C,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC;wBACtC,KAAK;wBACL,OAAO;wBACP,aAAa;wBACb,aAAa;qBACd,CAAC;gBACJ,CAAC,CAAC;gBACF,OAAO;gBACP,aAAa;gBACb,aAAa;gBACb,MAAM,EAAE,iBAAiB,CAAC,MAAM;aACjC,CAAC;QACJ,CAAC;QACD,IACE,MAAM,KAAK,iBAAiB,CAAC,MAAM;eAChC,MAAM,KAAK,iBAAiB,CAAC,QAAQ;eACrC,MAAM,KAAK,iBAAiB,CAAC,OAAO,EACvC,CAAC;YACD,MAAM,UAAU,GAAG,2BAA2B,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;YAChE,MAAM,eAAe,CAAC;gBACpB,OAAO,EAAE,aAAa,CAAC,GAAG,EAAE,YAAY,CAAC,IAAI,wBAAwB,UAAU,EAAE;gBACjF,UAAU;gBACV,UAAU,EAAE,4BAA4B;gBACxC,OAAO,EAAE,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC;gBACpC,MAAM,EAAE,SAAS;gBACjB,OAAO,EAAE,wBAAwB,CAAC,GAAG,CAAC;aACvC,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,SAAS,EAAE,CAAC;YACzC,MAAM,eAAe,CAAC,wBAAwB,CAAC,CAAC;YAChD,MAAM,eAAe,CAAC;gBACpB,OAAO,EAAE,sBAAsB;gBAC/B,UAAU,EAAE,UAAU,CAAC,mBAAmB;gBAC1C,UAAU,EAAE,4BAA4B;gBACxC,MAAM,EAAE,SAAS;aAClB,CAAC,CAAC;QACL,CAAC;QACD,WAAW,IAAI,CAAC,CAAC;QACjB,MAAM,KAAK,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAA8B;IACnE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,IAAI,GAAG,EAOlB,CAAC;IAEL,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,YAAY,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrF,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI;YACtC,UAAU;YACV,QAAQ,EAAE,EAAE;YACZ,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,EAAE;YACX,aAAa,EAAE,OAAgB;YAC/B,aAAa,EAAE,EAAE;SAClB,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzB,CAAC;QAED,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC5B,CAAC;QAED,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;QAC1B,CAAC;QAED,MAAM,aAAa,GAAG,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACzD,IAAI,aAAa,EAAE,CAAC;YAClB,KAAK,CAAC,aAAa,GAAG,aAAa,CAAC;QACtC,CAAC;QAED,KAAK,CAAC,aAAa,GAAG,iBAAiB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAE7D,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC1B,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;YAChC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;aAAM,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;YACxC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;QAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;gBACL,UAAU;gBACV,QAAQ,EAAE,EAAE;gBACZ,KAAK,EAAE,IAAI,UAAU,CAAC,CAAC,CAAC;gBACxB,OAAO,EAAE,EAAE;gBACX,aAAa,EAAE,OAAgB;gBAC/B,aAAa,EAAE,EAAE;aAClB,CAAC;QACJ,CAAC;QACD,OAAO;YACL,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC;YACjC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,aAAa,EAAE,KAAK,CAAC,aAAa;SACnC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACnD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAC1C,OAAO,MAAM;aACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;aACtC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oCAAoC,CAAC,MAAkC;IACrF,MAAM,OAAO,GAAG,MAAM,EAAE,MAAM,CAAC;IAC/B,IAAI,OAAO,EAAE,SAAS,KAAK,WAAW,EAAE,CAAC;QACvC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM;SACrD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;SAC3B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,uCAAuC,CAAC,MAAkC;IAIxF,MAAM,OAAO,GAAG,MAAM,EAAE,MAAM,CAAC;IAC/B,IAAI,OAAO,EAAE,SAAS,KAAK,kBAAkB,EAAE,CAAC;QAC9C,OAAO;YACL,IAAI,EAAE,EAAE;YACR,SAAS,EAAE,EAAE;SACd,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC;QAClD,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,SAAS,CAAC;YAC1D,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,SAAS;YACpC,CAAC,CAAC,EAAE;KACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4CAA4C,CAAC,MAAkC;IAC7F,MAAM,OAAO,GAAG,MAAM,EAAE,MAAM,CAAC;IAC/B,IAAI,OAAO,EAAE,SAAS,KAAK,kBAAkB,EAAE,CAAC;QAC9C,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,SAAS,CAAC;QACtD,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,SAAS;QACpC,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,MAAM,GAAI,KAA8B,CAAC,MAAM,CAAC;IACtD,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACxE,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ,CAAE,KAA4B,CAAC,IAAI,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,SAAS,KAAK,aAAa,CAAC;AAC1C,CAAC;AAED,SAAS,eAAe,CAAC,KAA6B;IACpD,IAAI,KAAK,EAAE,IAAI,CAAC,SAAS,KAAK,aAAa,EAAE,CAAC;QAC5C,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,OAAO,WAAW,CAAC,KAAK,EAAE;QACxB,UAAU,EAAE,UAAU,CAAC,uBAAuB;QAC9C,UAAU,EAAE,gCAAgC;QAC5C,MAAM,EAAE,SAAS;KAClB,CAAC,CAAC;AACL,CAAC"}

package/dist/ai-provider/helpers-shared.d.ts

@@ -0,0 +1,12 @@
+import { type RuntimeCallOptions } from '../runtime/browser.js';
+import { type AiRoutePolicy } from '../types/index.js';
+import { type RuntimeDefaults } from './types.js';
+export declare function ensureText(value: unknown, fieldName: string): string;
+export declare function fromRouteDecision(value: unknown): AiRoutePolicy;
+export declare function concatChunks(chunks: Uint8Array[]): Uint8Array;
+export declare function toCallOptions(defaults: RuntimeDefaults, input: {
+    timeoutMs?: number;
+    metadata?: RuntimeCallOptions['metadata'];
+}): RuntimeCallOptions;
+export declare function ensureSafeExternalMediaUrl(value: unknown, fieldName: string): string;
+//# sourceMappingURL=helpers-shared.d.ts.map

package/dist/ai-provider/helpers-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers-shared.d.ts","sourceRoot":"","sources":["../../src/ai-provider/helpers-shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEnE,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAEtE,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAWpE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAE/D;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAS7D;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE;IACL,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;CAC3C,GACA,kBAAkB,CAapB;AAiFD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAUpF"}

package/dist/ai-provider/helpers-shared.js

@@ -0,0 +1,127 @@
+import { createNimiError } from '../runtime/browser.js';
+import { ReasonCode } from '../types/index.js';
+import { normalizeText } from '../internal/utils.js';
+import { ROUTE_POLICY_CLOUD } from './types.js';
+export function ensureText(value, fieldName) {
+    const normalized = normalizeText(value);
+    if (!normalized) {
+        throw createNimiError({
+            message: `${fieldName} is required`,
+            reasonCode: ReasonCode.SDK_AI_PROVIDER_CONFIG_INVALID,
+            actionHint: `set_${fieldName}`,
+            source: 'sdk',
+        });
+    }
+    return normalized;
+}
+export function fromRouteDecision(value) {
+    return Number(value) === ROUTE_POLICY_CLOUD ? 'cloud' : 'local';
+}
+export function concatChunks(chunks) {
+    const total = chunks.reduce((size, chunk) => size + chunk.length, 0);
+    const merged = new Uint8Array(total);
+    let offset = 0;
+    for (const chunk of chunks) {
+        merged.set(chunk, offset);
+        offset += chunk.length;
+    }
+    return merged;
+}
+export function toCallOptions(defaults, input) {
+    const timeoutMs = typeof input.timeoutMs === 'number'
+        ? input.timeoutMs
+        : defaults.timeoutMs;
+    const metadata = {
+        ...(defaults.metadata || {}),
+        ...(input.metadata || {}),
+    };
+    return {
+        timeoutMs,
+        metadata: Object.keys(metadata).length > 0 ? metadata : undefined,
+    };
+}
+function createUnsafeExternalUrlError(fieldName, reason) {
+    return createNimiError({
+        message: `${fieldName} must be a public https URL (${reason})`,
+        reasonCode: ReasonCode.AI_INPUT_INVALID,
+        actionHint: `set_safe_${fieldName}`,
+        source: 'sdk',
+    });
+}
+function isIPv4(hostname) {
+    return /^\d{1,3}(?:\.\d{1,3}){3}$/.test(hostname);
+}
+function isPrivateIPv4(hostname) {
+    const octets = hostname.split('.').map((segment) => Number(segment));
+    if (octets.length !== 4 || octets.some((value) => !Number.isInteger(value) || value < 0 || value > 255)) {
+        return false;
+    }
+    const a = octets[0];
+    const b = octets[1];
+    if (a === undefined || b === undefined) {
+        return false;
+    }
+    return a === 0
+        || a === 10
+        || a === 127
+        || (a === 100 && b >= 64 && b <= 127)
+        || (a === 169 && b === 254)
+        || (a === 172 && b >= 16 && b <= 31)
+        || (a === 192 && b === 168)
+        || (a === 198 && (b === 18 || b === 19))
+        || a >= 224;
+}
+function isLocalIPv6(hostname) {
+    const normalized = hostname.toLowerCase();
+    if (normalized === '::'
+        || normalized === '::1'
+        || normalized.startsWith('fe80:')
+        || normalized.startsWith('fc')
+        || normalized.startsWith('fd')) {
+        return true;
+    }
+    const mappedV4 = normalized.match(/^::ffff:(\d+\.\d+\.\d+\.\d+)$/);
+    const mappedHost = mappedV4?.[1];
+    return mappedHost ? isPrivateIPv4(mappedHost) : false;
+}
+function isPublicHttpsUrl(raw) {
+    let parsed;
+    try {
+        parsed = new URL(raw);
+    }
+    catch {
+        return { ok: false, reason: 'invalid URL' };
+    }
+    if (parsed.protocol !== 'https:') {
+        return { ok: false, reason: 'https is required' };
+    }
+    if (parsed.username || parsed.password) {
+        return { ok: false, reason: 'credentials are not allowed' };
+    }
+    const hostname = parsed.hostname.trim().toLowerCase();
+    if (!hostname) {
+        return { ok: false, reason: 'host is required' };
+    }
+    if (hostname === 'localhost' || hostname.endsWith('.localhost')) {
+        return { ok: false, reason: 'loopback hosts are not allowed' };
+    }
+    if (isIPv4(hostname) && isPrivateIPv4(hostname)) {
+        return { ok: false, reason: 'private IPv4 ranges are not allowed' };
+    }
+    if (hostname.includes(':') && isLocalIPv6(hostname)) {
+        return { ok: false, reason: 'local IPv6 ranges are not allowed' };
+    }
+    return { ok: true, url: parsed.toString() };
+}
+export function ensureSafeExternalMediaUrl(value, fieldName) {
+    const normalized = normalizeText(value);
+    if (!normalized) {
+        throw createUnsafeExternalUrlError(fieldName, 'value is missing');
+    }
+    const result = isPublicHttpsUrl(normalized);
+    if (!result.ok) {
+        throw createUnsafeExternalUrlError(fieldName, result.reason);
+    }
+    return result.url;
+}
+//# sourceMappingURL=helpers-shared.js.map

package/dist/ai-provider/helpers-shared.js.map

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

package/dist/ai-provider/helpers.d.ts

@@ -0,0 +1,49 @@
+import type { LanguageModelV3FinishReason, LanguageModelV3Prompt, LanguageModelV3Usage, SharedV3ProviderMetadata } from '@ai-sdk/provider';
+import { type RuntimeCallOptions, type RuntimeStreamCallOptions } from '../runtime/browser.js';
+import { Struct } from '../runtime/generated/google/protobuf/struct.js';
+import { type ChatContentPart } from '../runtime/generated/runtime/v1/ai.js';
+import { type AiRoutePolicy } from '../types/index.js';
+import { extractGenerateText as extractGenerateTextShared } from '../internal/scenario-output.js';
+import { type NimiAiProviderConfig, type RuntimeDefaults, type RuntimeForAiProvider } from './types.js';
+import { asRecord, normalizeText } from '../internal/utils.js';
+import { ensureSafeExternalMediaUrl, ensureText, fromRouteDecision, toCallOptions } from './helpers-shared.js';
+export { ensureSafeExternalMediaUrl, ensureText, fromRouteDecision, toCallOptions };
+export { collectArtifacts, executeScenarioJob, normalizeProviderError, toEmbeddingVectors, toEmbeddingVectorsFromScenarioOutput, toSpeechSynthesisArtifactsFromScenarioOutput, toSpeechTranscriptionFromScenarioOutput, } from './helpers-scenario.js';
+export { asRecord, normalizeText };
+export declare const extractGenerateText: typeof extractGenerateTextShared;
+export declare function parseCount(value: unknown): number | undefined;
+export declare function resolveRoutePolicy(value: AiRoutePolicy | undefined): number;
+export declare function toProviderMetadata(input: {
+    traceId?: string;
+    routeDecision?: unknown;
+    modelResolved?: string;
+}): SharedV3ProviderMetadata;
+export declare function toUsage(value: unknown): LanguageModelV3Usage;
+export declare function toFinishReason(value: unknown): LanguageModelV3FinishReason;
+export declare function extractTextValue(part: unknown): string;
+export declare function toRuntimePrompt(prompt: LanguageModelV3Prompt): {
+    systemPrompt: string;
+    hasNonSystemInput: boolean;
+    input: Array<{
+        role: string;
+        content: string;
+        name: string;
+        parts: ChatContentPart[];
+    }>;
+};
+export declare function toBase64(value: Uint8Array): string;
+export declare function toImageFileSource(value: unknown): string;
+export declare function toImageFileSources(value: unknown): string[];
+export declare function toUtf8(value: Uint8Array): string;
+export declare function toProtoStruct(input: Record<string, unknown> | undefined): Struct | undefined;
+export declare function toLabels(input: unknown): Record<string, string> | undefined;
+export declare function ensureRuntime(config: NimiAiProviderConfig): {
+    runtime: RuntimeForAiProvider;
+    defaults: RuntimeDefaults;
+};
+export declare function toStreamOptions(defaults: RuntimeDefaults, input: {
+    timeoutMs?: number;
+    metadata?: RuntimeCallOptions['metadata'];
+    signal?: AbortSignal;
+}): RuntimeStreamCallOptions;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/ai-provider/helpers.d.ts.map

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