@nimiplatform/sdk 0.5.14

package/dist/mod/model-options/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mod/model-options/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,8BAA8B,GAC/B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,iBAAiB,GAClB,MAAM,SAAS,CAAC"}

package/dist/mod/model-options/index.js

@@ -0,0 +1,5 @@
+export { OPENROUTER_AUDIO_CHAT_MODELS, OPENROUTER_TTS_MODELS, } from './presets.js';
+export { classifyModelType, } from './classify.js';
+export { filterModelOptions, filterModelsForScenario, filterModelsForSpeechSynthesis, } from './scenario-filter.js';
+export { groupModelOptions, } from './group.js';
+//# sourceMappingURL=index.js.map

package/dist/mod/model-options/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mod/model-options/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,8BAA8B,GAC/B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,iBAAiB,GAClB,MAAM,SAAS,CAAC"}

package/dist/mod/model-options/presets.d.ts

@@ -0,0 +1,15 @@
+import type { RuntimeModality } from '../types/llm.js';
+export type ModelTypeCategory = 'chat' | 'reasoning' | 'vision' | 'audio' | 'coding';
+export type GroupedModelOptions = Array<{
+    key: ModelTypeCategory;
+    label: string;
+    options: string[];
+}>;
+export type ModelScenario = RuntimeModality;
+export declare const OPENROUTER_AUDIO_CHAT_MODELS: readonly ["openai/gpt-audio-mini", "openai/gpt-audio", "openai/gpt-4o-audio-preview"];
+export declare const OPENROUTER_TTS_MODELS: readonly ["openai/gpt-4o-mini-tts", "openai/tts-1", "openai/tts-1-hd"];
+export declare const IMAGE_MODEL_HINTS: readonly ["image", "vision", "flux", "sdxl", "stable-diffusion", "dall-e", "recraft", "midjourney", "imagen"];
+export declare const VIDEO_MODEL_HINTS: readonly ["video", "sora", "veo", "kling", "runway", "hunyuan-video", "minimax-video", "luma", "wan"];
+export declare const MODEL_TYPE_LABELS: Record<ModelTypeCategory, string>;
+export declare const MODEL_TYPE_ORDER: ModelTypeCategory[];
+//# sourceMappingURL=presets.d.ts.map

package/dist/mod/model-options/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../src/mod/model-options/presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErF,MAAM,MAAM,mBAAmB,GAAG,KAAK,CAAC;IACtC,GAAG,EAAE,iBAAiB,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,eAAe,CAAC;AAE5C,eAAO,MAAM,4BAA4B,uFAI/B,CAAC;AAEX,eAAO,MAAM,qBAAqB,wEAIxB,CAAC;AAEX,eAAO,MAAM,iBAAiB,+GAUpB,CAAC;AAEX,eAAO,MAAM,iBAAiB,uGAUpB,CAAC;AAEX,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAM/D,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,iBAAiB,EAAuD,CAAC"}

package/dist/mod/model-options/presets.js

@@ -0,0 +1,41 @@
+export const OPENROUTER_AUDIO_CHAT_MODELS = [
+    'openai/gpt-audio-mini',
+    'openai/gpt-audio',
+    'openai/gpt-4o-audio-preview',
+];
+export const OPENROUTER_TTS_MODELS = [
+    'openai/gpt-4o-mini-tts',
+    'openai/tts-1',
+    'openai/tts-1-hd',
+];
+export const IMAGE_MODEL_HINTS = [
+    'image',
+    'vision',
+    'flux',
+    'sdxl',
+    'stable-diffusion',
+    'dall-e',
+    'recraft',
+    'midjourney',
+    'imagen',
+];
+export const VIDEO_MODEL_HINTS = [
+    'video',
+    'sora',
+    'veo',
+    'kling',
+    'runway',
+    'hunyuan-video',
+    'minimax-video',
+    'luma',
+    'wan',
+];
+export const MODEL_TYPE_LABELS = {
+    chat: 'General Chat',
+    reasoning: 'Reasoning',
+    vision: 'Vision / Multimodal',
+    audio: 'Audio / Voice',
+    coding: 'Coding',
+};
+export const MODEL_TYPE_ORDER = ['chat', 'reasoning', 'vision', 'audio', 'coding'];
+//# sourceMappingURL=presets.js.map

package/dist/mod/model-options/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../../src/mod/model-options/presets.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,uBAAuB;IACvB,kBAAkB;IAClB,6BAA6B;CACrB,CAAC;AAEX,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,wBAAwB;IACxB,cAAc;IACd,iBAAiB;CACT,CAAC;AAEX,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO;IACP,QAAQ;IACR,MAAM;IACN,MAAM;IACN,kBAAkB;IAClB,QAAQ;IACR,SAAS;IACT,YAAY;IACZ,QAAQ;CACA,CAAC;AAEX,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO;IACP,MAAM;IACN,KAAK;IACL,OAAO;IACP,QAAQ;IACR,eAAe;IACf,eAAe;IACf,MAAM;IACN,KAAK;CACG,CAAC;AAEX,MAAM,CAAC,MAAM,iBAAiB,GAAsC;IAClE,IAAI,EAAE,cAAc;IACpB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,qBAAqB;IAC7B,KAAK,EAAE,eAAe;IACtB,MAAM,EAAE,QAAQ;CACjB,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAwB,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC"}

package/dist/mod/model-options/scenario-filter.d.ts

@@ -0,0 +1,7 @@
+import { type ModelScenario } from './presets.js';
+export declare function filterModelOptions(models: string[], query: string): string[];
+export declare function filterModelsForScenario(models: string[], scenario: ModelScenario, options?: {
+    vendor?: string;
+}): string[];
+export declare function filterModelsForSpeechSynthesis(models: string[]): string[];
+//# sourceMappingURL=scenario-filter.d.ts.map

package/dist/mod/model-options/scenario-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-filter.d.ts","sourceRoot":"","sources":["../../../src/mod/model-options/scenario-filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAc/C,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAI5E;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5B,MAAM,EAAE,CAkCV;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,MAAM,EAAE,GACf,MAAM,EAAE,CAQV"}

package/dist/mod/model-options/scenario-filter.js

@@ -0,0 +1,50 @@
+import { isLikelyAudioChatModel, isLikelyEmbeddingModel, isLikelyImageModel, isLikelySttModel, isLikelyTtsModel, isLikelyVideoModel, } from './classify.js';
+function dedupeModelIds(models) {
+    return Array.from(new Set(models.map((model) => String(model || '').trim()).filter(Boolean)));
+}
+export function filterModelOptions(models, query) {
+    const normalizedQuery = String(query || '').trim().toLowerCase();
+    if (!normalizedQuery)
+        return models;
+    return models.filter((model) => String(model || '').toLowerCase().includes(normalizedQuery));
+}
+export function filterModelsForScenario(models, scenario, options) {
+    const all = dedupeModelIds(models);
+    if (all.length === 0)
+        return all;
+    if (scenario === 'tts') {
+        const ttsModels = all.filter((model) => isLikelyTtsModel(model));
+        if (ttsModels.length > 0)
+            return ttsModels;
+        return [];
+    }
+    if (scenario === 'stt') {
+        return all.filter((model) => isLikelySttModel(model));
+    }
+    if (scenario === 'embedding') {
+        return all.filter((model) => isLikelyEmbeddingModel(model));
+    }
+    if (scenario === 'image') {
+        return all.filter((model) => isLikelyImageModel(model));
+    }
+    if (scenario === 'video') {
+        return all.filter((model) => isLikelyVideoModel(model));
+    }
+    return all.filter((model) => (!isLikelyImageModel(model)
+        && !isLikelyVideoModel(model)
+        && !isLikelyTtsModel(model)
+        && !isLikelySttModel(model)
+        && !isLikelyEmbeddingModel(model)
+        && !isLikelyAudioChatModel(model)));
+}
+export function filterModelsForSpeechSynthesis(models) {
+    const all = dedupeModelIds(models);
+    if (all.length === 0) {
+        return all;
+    }
+    const ttsModels = all.filter((model) => isLikelyTtsModel(model));
+    if (ttsModels.length > 0)
+        return ttsModels;
+    return [];
+}
+//# sourceMappingURL=scenario-filter.js.map

package/dist/mod/model-options/scenario-filter.js.map

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

package/dist/mod/runtime/ai-config-diff.d.ts

@@ -0,0 +1,14 @@
+import type { AIConfig, AIConfigDiff, AIConfigEvidence } from './ai-config.js';
+export declare function snapshotAIConfig(config: AIConfig): AIConfig;
+export declare function createAIConfigEvidence(config: AIConfig): AIConfigEvidence;
+/**
+ * Compute the canonical content hash / version token of an AIConfig.
+ * Used as the `baseVersion` for `AIProfilePreviewResult` CAS freshness checks.
+ */
+export declare function computeAIConfigVersion(config: AIConfig): string;
+/**
+ * Compute a typed before→after `AIConfigDiff` for two AIConfig values
+ * (D-AIPC-014). `before` is `null` for a first apply (full creation).
+ */
+export declare function computeAIConfigDiff(before: AIConfig | null, after: AIConfig): AIConfigDiff;
+//# sourceMappingURL=ai-config-diff.d.ts.map

package/dist/mod/runtime/ai-config-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-config-diff.d.ts","sourceRoot":"","sources":["../../../src/mod/runtime/ai-config-diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAEjB,MAAM,gBAAgB,CAAC;AAoCxB,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAE3D;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,QAAQ,GAAG,gBAAgB,CASzE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAG/D;AAyDD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,QAAQ,GAAG,IAAI,EACvB,KAAK,EAAE,QAAQ,GACd,YAAY,CAId"}

package/dist/mod/runtime/ai-config-diff.js

@@ -0,0 +1,107 @@
+function canonicalizeAIConfigJsonValue(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => canonicalizeAIConfigJsonValue(item));
+    }
+    if (value && typeof value === 'object') {
+        const record = value;
+        const canonical = {};
+        for (const key of Object.keys(record).sort()) {
+            const nextValue = record[key];
+            if (nextValue !== undefined) {
+                canonical[key] = canonicalizeAIConfigJsonValue(nextValue);
+            }
+        }
+        return canonical;
+    }
+    return value;
+}
+function hashCanonicalAIConfigJson(value) {
+    let hashA = 0xdeadbeef ^ value.length;
+    let hashB = 0x41c6ce57 ^ value.length;
+    for (let index = 0; index < value.length; index += 1) {
+        const charCode = value.charCodeAt(index);
+        hashA = Math.imul(hashA ^ charCode, 2654435761);
+        hashB = Math.imul(hashB ^ charCode, 1597334677);
+    }
+    hashA = Math.imul(hashA ^ (hashA >>> 16), 2246822507)
+        ^ Math.imul(hashB ^ (hashB >>> 13), 3266489909);
+    hashB = Math.imul(hashB ^ (hashB >>> 16), 2246822507)
+        ^ Math.imul(hashA ^ (hashA >>> 13), 3266489909);
+    const combined = 4294967296 * (2097151 & hashB) + (hashA >>> 0);
+    return `ai-config-v1:${combined.toString(16).padStart(14, '0')}`;
+}
+export function snapshotAIConfig(config) {
+    return canonicalizeAIConfigJsonValue(config);
+}
+export function createAIConfigEvidence(config) {
+    const configSnapshot = snapshotAIConfig(config);
+    const canonicalJson = JSON.stringify(configSnapshot);
+    return {
+        profileOrigin: configSnapshot.profileOrigin,
+        capabilityBindingKeys: Object.keys(configSnapshot.capabilities.selectedBindings).sort(),
+        configSnapshot,
+        configHash: hashCanonicalAIConfigJson(canonicalJson),
+    };
+}
+/**
+ * Compute the canonical content hash / version token of an AIConfig.
+ * Used as the `baseVersion` for `AIProfilePreviewResult` CAS freshness checks.
+ */
+export function computeAIConfigVersion(config) {
+    const canonical = canonicalizeAIConfigJsonValue(config);
+    return hashCanonicalAIConfigJson(JSON.stringify(canonical));
+}
+function diffAIConfigJsonValue(path, before, after, out) {
+    const beforeDefined = before !== undefined;
+    const afterDefined = after !== undefined;
+    if (!beforeDefined && !afterDefined) {
+        return;
+    }
+    const bothObjects = before !== null && after !== null
+        && typeof before === 'object' && typeof after === 'object'
+        && !Array.isArray(before) && !Array.isArray(after);
+    if (bothObjects) {
+        const beforeRecord = before;
+        const afterRecord = after;
+        const keys = Array.from(new Set([...Object.keys(beforeRecord), ...Object.keys(afterRecord)])).sort();
+        for (const key of keys) {
+            diffAIConfigJsonValue(path ? `${path}.${key}` : key, beforeRecord[key], afterRecord[key], out);
+        }
+        return;
+    }
+    const beforeJson = beforeDefined
+        ? JSON.stringify(canonicalizeAIConfigJsonValue(before))
+        : undefined;
+    const afterJson = afterDefined
+        ? JSON.stringify(canonicalizeAIConfigJsonValue(after))
+        : undefined;
+    if (beforeJson === afterJson) {
+        return;
+    }
+    let changeKind;
+    if (!beforeDefined) {
+        changeKind = 'added';
+    }
+    else if (!afterDefined) {
+        changeKind = 'removed';
+    }
+    else {
+        changeKind = 'changed';
+    }
+    out.push({
+        path,
+        changeKind,
+        before: beforeDefined ? before : null,
+        after: afterDefined ? after : null,
+    });
+}
+/**
+ * Compute a typed before→after `AIConfigDiff` for two AIConfig values
+ * (D-AIPC-014). `before` is `null` for a first apply (full creation).
+ */
+export function computeAIConfigDiff(before, after) {
+    const fields = [];
+    diffAIConfigJsonValue('', before ?? {}, after, fields);
+    return { identical: fields.length === 0, fields };
+}
+//# sourceMappingURL=ai-config-diff.js.map

package/dist/mod/runtime/ai-config-diff.js.map

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

package/dist/mod/runtime/ai-config.d.ts

@@ -0,0 +1,377 @@
+/**
+ * AI Profile / Config / Snapshot canonical types.
+ *
+ * Spec authority:
+ *   P-AISC-001~005  AIScopeRef identity
+ *   D-AIPC-001~012  Three-tier AI configuration
+ *   K-AIEXEC-001~005 Runtime execution contract
+ *   S-AICONF-001~006 SDK surface contract
+ */
+import type { RuntimeRouteBinding } from '../runtime-route.js';
+export type AIScopeKind = 'app' | 'mod' | 'module' | 'feature';
+/** Canonical identity for an AI configuration scope. */
+export type AIScopeRef = {
+    kind: AIScopeKind;
+    ownerId: string;
+    surfaceId?: string;
+};
+export type AIRuntimeLocalProfileRef = {
+    modId: string;
+    profileId: string;
+};
+export type AIProfileCapabilityIntent = {
+    binding?: RuntimeRouteBinding | null;
+    localProfileRef?: AIRuntimeLocalProfileRef | null;
+    params?: Record<string, unknown>;
+};
+/** Portable AI configuration template. Not a live config. */
+export type AIProfile = {
+    profileId: string;
+    title: string;
+    description: string;
+    tags: string[];
+    capabilities: Partial<Record<string, AIProfileCapabilityIntent>>;
+};
+/** Traceability reference to the profile that was last applied to an AIConfig. */
+export type AIProfileRef = {
+    profileId: string;
+    title: string;
+    appliedAt: string;
+};
+export type AIConfigCapabilities = {
+    selectedBindings: Partial<Record<string, RuntimeRouteBinding | null>>;
+    localProfileRefs: Partial<Record<string, AIRuntimeLocalProfileRef | null>>;
+    selectedParams: Partial<Record<string, Record<string, unknown>>>;
+};
+/** Scope-bound live AI configuration. Keyed by AIScopeRef. */
+export type AIConfig = {
+    scopeRef: AIScopeRef;
+    capabilities: AIConfigCapabilities;
+    profileOrigin: AIProfileRef | null;
+};
+export { computeAIConfigDiff, computeAIConfigVersion, createAIConfigEvidence, snapshotAIConfig, } from './ai-config-diff.js';
+export type MemoryEmbeddingSourceKind = 'cloud' | 'local';
+export type MemoryEmbeddingCloudBindingRef = {
+    kind: 'cloud';
+    connectorId: string;
+    modelId: string;
+};
+export type MemoryEmbeddingLocalBindingRef = {
+    kind: 'local';
+    targetId: string;
+};
+export type MemoryEmbeddingBindingRef = MemoryEmbeddingCloudBindingRef | MemoryEmbeddingLocalBindingRef;
+export type MemoryEmbeddingConfig = {
+    scopeRef: AIScopeRef;
+    sourceKind: MemoryEmbeddingSourceKind | null;
+    bindingRef: MemoryEmbeddingBindingRef | null;
+    revisionToken: string;
+    updatedAt: string;
+};
+export type MemoryEmbeddingResolutionState = 'missing' | 'resolved' | 'unresolved' | 'unavailable';
+export type MemoryEmbeddingCanonicalBankStatus = 'unbound' | 'bound_equivalent' | 'bound_profile_mismatch' | 'rebuild_pending' | 'cutover_ready';
+export type MemoryEmbeddingRuntimeState = {
+    bindingIntentPresent: boolean;
+    bindingSourceKind: MemoryEmbeddingSourceKind | null;
+    resolutionState: MemoryEmbeddingResolutionState;
+    resolvedProfileIdentity: string | null;
+    canonicalBankStatus: MemoryEmbeddingCanonicalBankStatus;
+    blockedReasonCode: string | null;
+    operationReadiness: {
+        bindAllowed: boolean;
+        cutoverAllowed: boolean;
+    };
+    traceId?: string;
+};
+export type MemoryEmbeddingRuntimeTargetRef = {
+    kind: 'agent-core';
+    agentId: string;
+};
+export type MemoryEmbeddingRuntimeInput = {
+    scopeRef: AIScopeRef;
+    targetRef: MemoryEmbeddingRuntimeTargetRef;
+};
+export type MemoryEmbeddingBindOutcome = 'bound' | 'already_bound' | 'staged_rebuild' | 'rejected';
+export type MemoryEmbeddingBindResult = {
+    outcome: MemoryEmbeddingBindOutcome;
+    blockedReasonCode: string | null;
+    canonicalBankStatusAfter: MemoryEmbeddingCanonicalBankStatus;
+    pendingCutover: boolean;
+    traceId?: string;
+};
+export type MemoryEmbeddingCutoverOutcome = 'cutover_committed' | 'already_current' | 'not_ready' | 'rejected';
+export type MemoryEmbeddingCutoverResult = {
+    outcome: MemoryEmbeddingCutoverOutcome;
+    blockedReasonCode: string | null;
+    canonicalBankStatusAfter: MemoryEmbeddingCanonicalBankStatus;
+    traceId?: string;
+};
+/** Evidence of config state at execution start time. */
+export type AIConfigEvidence = {
+    profileOrigin: AIProfileRef | null;
+    capabilityBindingKeys: string[];
+    configSnapshot: AIConfig;
+    configHash: string;
+};
+/** Minimal conversation execution slice for AISnapshot embedding. */
+export type AIConversationExecutionSlice = {
+    executionId: string;
+    createdAt: string;
+    capability: string;
+    selectedBinding: RuntimeRouteBinding | null;
+    resolvedBinding: unknown;
+    health: unknown;
+    metadata: unknown;
+    agentResolution: unknown;
+};
+/** Execution-time snapshot. Immutable after creation. */
+export type AISnapshot = {
+    executionId: string;
+    scopeRef: AIScopeRef;
+    configEvidence: AIConfigEvidence;
+    conversationCapabilitySlice: AIConversationExecutionSlice;
+    runtimeEvidence: AIRuntimeEvidence | null;
+    createdAt: string;
+};
+/** Runtime-side execution evidence container. */
+export type AIRuntimeEvidence = {
+    schedulingJudgement: AISchedulingJudgement | null;
+};
+/** K-SCHED-001: Six-value scheduling judgement state. */
+export type AISchedulingState = 'runnable' | 'queue_required' | 'preemption_risk' | 'slowdown_risk' | 'denied' | 'unknown';
+/** K-SCHED-003: Occupancy snapshot at peek time. */
+export type AISchedulingOccupancy = {
+    globalUsed: number;
+    globalCap: number;
+    appUsed: number;
+    appCap: number;
+};
+/** K-SCHED-007: Target-scoped resource hint. */
+export type AISchedulingResourceHint = {
+    estimatedVramBytes?: number | null;
+    estimatedRamBytes?: number | null;
+    estimatedDiskBytes?: number | null;
+    engine?: string | null;
+};
+/** K-SCHED-002: Atomic scheduling evaluation target. */
+export type AISchedulingEvaluationTarget = {
+    capability: string;
+    modId?: string | null;
+    profileId?: string | null;
+    resourceHint?: AISchedulingResourceHint | null;
+};
+/** K-SCHED-002: Scheduling preflight judgement result. */
+export type AISchedulingJudgement = {
+    state: AISchedulingState;
+    detail: string | null;
+    occupancy: AISchedulingOccupancy | null;
+    resourceWarnings: string[];
+};
+/** The two canonical built-in first-run chat surface ids (P-AISC-006). */
+export type BuiltInChatSurfaceId = 'nimi' | 'agent';
+/** Create the default app-level scope ref for Phase 1. */
+export declare function createDefaultAIScopeRef(): AIScopeRef;
+/** Create the canonical Phase 1 mod workspace scope ref. */
+export declare function createCanonicalModAIScopeRef(modId: string): AIScopeRef;
+/** True when the scope matches the canonical Phase 1 mod workspace scope. */
+export declare function isCanonicalModAIScopeRef(scopeRef: AIScopeRef | null | undefined, modId: string): boolean;
+/** Assert that the caller provided the canonical Phase 1 mod workspace scope. */
+export declare function assertCanonicalModAIScopeRef(scopeRef: AIScopeRef | null | undefined, modId: string): AIScopeRef;
+/**
+ * Create a canonical built-in first-run chat AIScopeRef (P-AISC-006).
+ *
+ * Produces the `feature` shape owned by `desktop.chat`:
+ *   - `nimi`  -> { kind: 'feature', ownerId: 'desktop.chat', surfaceId: 'nimi' }
+ *   - `agent` -> { kind: 'feature', ownerId: 'desktop.chat', surfaceId: 'agent' }
+ *
+ * The caller must pass an explicit surface id. There is no omitted-scope
+ * inference and the result is never the generic `DEFAULT_SCOPE`.
+ */
+export declare function createBuiltInChatAIScopeRef(surfaceId: BuiltInChatSurfaceId): AIScopeRef;
+/** True when the scope is exactly one of the two canonical built-in chat scopes. */
+export declare function isBuiltInChatAIScopeRef(scopeRef: AIScopeRef | null | undefined): boolean;
+/**
+ * Assert that the caller provided an exact canonical built-in chat scope.
+ *
+ * Rejects: omitted/null scope, generic `app:desktop:chat`, the retired
+ * `app:desktop.chat.nimi|agent` shape, a merged `desktop.chat` scope with no
+ * `surfaceId`, and any other non-canonical key. SDK never infers the scope.
+ */
+export declare function assertBuiltInChatAIScopeRef(scopeRef: AIScopeRef | null | undefined): AIScopeRef;
+/** The canonical first-run built-in chat scope set, in stable order (P-AISC-006). */
+export declare function builtInChatAIScopeRefs(): AIScopeRef[];
+/**
+ * One backend-issued durable built-in AIConfig evidence ref.
+ *
+ * The SDK keeps `ref` opaque: it does not mint, parse, or string-validate it.
+ * Verification belongs to the Desktop host AIConfig service (D-AIPC-013).
+ */
+export type BuiltInAiConfigEvidenceRef = {
+    scopeRef: AIScopeRef;
+    ref: string;
+};
+/** Result of a first-run built-in AIConfig finalization apply (S-AICONF-007). */
+export type FirstRunBuiltInAiConfigResult = {
+    builtInAiConfigRefs: BuiltInAiConfigEvidenceRef[];
+};
+/**
+ * Apply the selected first-run baseline AIProfile to a single explicit
+ * canonical built-in chat scope, delegating durable evidence minting to the
+ * host AIConfig service (S-AICONF-007).
+ *
+ * The `applyHostAiConfig` callback is the Desktop host AIConfig authority seam:
+ * it owns atomic apply (D-AIPC-005) and returns the host/backend-issued durable
+ * evidence ref. The SDK never mints the ref, never accepts a caller-provided
+ * string as evidence, and never infers the scope from an omitted argument.
+ */
+export declare function applyFirstRunBuiltInChatAIConfig(input: {
+    scopeRef: AIScopeRef;
+    profile: AIProfile;
+    applyHostAiConfig: (boundScopeRef: AIScopeRef, profile: AIProfile) => Promise<string>;
+}): Promise<BuiltInAiConfigEvidenceRef>;
+/**
+ * Apply the selected first-run baseline AIProfile to BOTH canonical built-in
+ * chat scopes (`desktop.chat.nimi` and `desktop.chat.agent`) and collect the
+ * host-issued durable evidence refs (S-AICONF-007 / D-AIPC-013).
+ *
+ * Fails closed if either scope's apply fails — no partial built-in set is
+ * returned. The generic `DEFAULT_SCOPE` is never reachable from this path.
+ */
+export declare function applyFirstRunBuiltInChatAIConfigs(input: {
+    profile: AIProfile;
+    applyHostAiConfig: (boundScopeRef: AIScopeRef, profile: AIProfile) => Promise<string>;
+}): Promise<FirstRunBuiltInAiConfigResult>;
+/** Create an empty AIConfig for a given scope. */
+export declare function createEmptyAIConfig(scopeRef?: AIScopeRef): AIConfig;
+/** Create an empty adjacent memory-embedding config for a given scope. */
+export declare function createEmptyMemoryEmbeddingConfig(scopeRef?: AIScopeRef): MemoryEmbeddingConfig;
+export type AIProbeStatus = 'available' | 'unavailable' | 'degraded' | 'unknown';
+export type AIConfigProbeResult = {
+    status: AIProbeStatus;
+    capabilityStatuses: Partial<Record<string, AIProbeStatus>>;
+    schedulingJudgement?: AISchedulingJudgement | null;
+};
+export type AIProfileApplyResult = {
+    success: boolean;
+    config: AIConfig | null;
+    failureReason: string | null;
+    probeWarnings: string[];
+};
+export type AIProfileValidationResult = {
+    valid: boolean;
+    errors: string[];
+};
+/** One field-level before→after change inside an AIConfig diff. */
+export type AIConfigFieldDiff = {
+    /** Dot-path of the changed materialized field, e.g. `capabilities.selectedBindings.text.generate`. */
+    path: string;
+    changeKind: 'added' | 'removed' | 'changed';
+    before: unknown;
+    after: unknown;
+};
+/**
+ * Typed before→after diff of a `D-AIPC-005` apply (D-AIPC-014).
+ *
+ * Covers the full materialized `AIConfig` shape (`capabilities`,
+ * `profileOrigin`, and any other materialized fields) — never a free-form
+ * summary or a partial field subset.
+ */
+export type AIConfigDiff = {
+    /** True when `before` and `after` are byte-equivalent (no-op apply). */
+    identical: boolean;
+    fields: AIConfigFieldDiff[];
+};
+/**
+ * Result of a non-committing profile apply preview (D-AIPC-014 / S-AICONF-008).
+ *
+ * `previewApply` returns this without mutating live config, notifying
+ * subscribers, or recording a snapshot. The caller still commits via
+ * `aiProfile.apply`.
+ */
+export type AIProfilePreviewResult = {
+    /** Current AIConfig for the scope, or `null` on first apply (full creation). */
+    before: AIConfig | null;
+    /** Full-materialization overwrite result that `D-AIPC-005` apply would write. */
+    after: AIConfig;
+    /** Typed before→after diff covering all materialized AIConfig fields. */
+    diff: AIConfigDiff;
+    /**
+     * Content hash / version of `before` (or of an empty config when `before`
+     * is null) so the caller can detect a stale preview before commit.
+     */
+    baseVersion: string;
+    /** Typed availability / feasibility warnings; advisory, never block the diff. */
+    probeWarnings: string[];
+};
+/** Profile catalog and apply operations. */
+export type AIProfileSurface = {
+    list(): Promise<AIProfile[]>;
+    get(profileId: string): Promise<AIProfile | null>;
+    validate(profile: AIProfile): AIProfileValidationResult;
+    /**
+     * Compute (without committing) the typed before→after `AIConfig` diff that a
+     * `D-AIPC-005` apply would produce for `scopeRef` + `profileId`
+     * (D-AIPC-014 / S-AICONF-008). Does not mutate live config, notify
+     * subscribers, or record a snapshot. Fails closed on schema-invalid input.
+     */
+    previewApply(scopeRef: AIScopeRef, profileId: string): Promise<AIProfilePreviewResult>;
+    apply(scopeRef: AIScopeRef, profileId: string): Promise<AIProfileApplyResult>;
+    resolveLocalDependencies(profileId: string): Promise<unknown[]>;
+};
+/** Scope-bound config read/write operations. */
+export type AIConfigSurface = {
+    get(scopeRef: AIScopeRef): AIConfig;
+    update(scopeRef: AIScopeRef, config: AIConfig): void;
+    listScopes(): AIScopeRef[];
+    probe(scopeRef: AIScopeRef): Promise<AIConfigProbeResult>;
+    probeFeasibility(scopeRef: AIScopeRef): Promise<AIConfigProbeResult>;
+    probeSchedulingTarget(scopeRef: AIScopeRef, target: AISchedulingEvaluationTarget): Promise<AISchedulingJudgement | null>;
+    subscribe(scopeRef: AIScopeRef, callback: (config: AIConfig) => void): () => void;
+};
+/** Execution snapshot record/read operations. */
+export type AISnapshotSurface = {
+    record(scopeRef: AIScopeRef, snapshot: AISnapshot): void;
+    get(executionId: string): AISnapshot | null;
+    getLatest(scopeRef: AIScopeRef): AISnapshot | null;
+};
+export type MemoryEmbeddingConfigSurface = {
+    get(scopeRef: AIScopeRef): MemoryEmbeddingConfig;
+    update(scopeRef: AIScopeRef, config: MemoryEmbeddingConfig): void;
+    subscribe(scopeRef: AIScopeRef, callback: (config: MemoryEmbeddingConfig) => void): () => void;
+};
+export type MemoryEmbeddingRuntimeSurface = {
+    inspect(input: MemoryEmbeddingRuntimeInput): Promise<MemoryEmbeddingRuntimeState>;
+    requestBind(input: MemoryEmbeddingRuntimeInput): Promise<MemoryEmbeddingBindResult>;
+    requestCutover(input: MemoryEmbeddingRuntimeInput): Promise<MemoryEmbeddingCutoverResult>;
+};
+/** Aggregate SDK AI config surface (S-AICONF-001~006). */
+export type AIConfigSDKSurface = {
+    aiProfile: AIProfileSurface;
+    aiConfig: AIConfigSurface;
+    aiSnapshot: AISnapshotSurface;
+};
+/**
+ * Apply an AIProfile to an AIConfig via atomic overwrite (D-AIPC-005).
+ * Returns a new AIConfig with the profile's capability intents materialized.
+ * The original config's scopeRef is preserved.
+ */
+export declare function applyAIProfileToConfig(config: AIConfig, profile: AIProfile): AIConfig;
+/** Static schema validation for AIProfile (D-AIPC-012 layer 1). */
+export declare function validateAIProfile(profile: unknown): AIProfileValidationResult;
+/** Create a canonical execution ID for AISnapshot records. */
+export declare function createAISnapshotExecutionId(nowMs?: number): string;
+/** Create a canonical AISnapshot record using the published SDK schema. */
+export declare function createAISnapshotRecord(input: {
+    scopeRef?: AIScopeRef;
+    config: AIConfig;
+    capability: string;
+    selectedBinding: RuntimeRouteBinding | null;
+    resolvedBinding?: unknown;
+    health?: unknown;
+    metadata?: unknown;
+    agentResolution?: unknown;
+    runtimeEvidence?: AIRuntimeEvidence | null;
+    executionId?: string;
+    createdAt?: string;
+}): AISnapshot;
+//# sourceMappingURL=ai-config.d.ts.map