@nimiplatform/sdk 0.5.14

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

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

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

@@ -0,0 +1,309 @@
+/**
+ * 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 { createNimiError } from '../../runtime/errors.js';
+import { createNimiUlid } from '../../runtime/ids.js';
+import { ReasonCode } from '../../types/index.js';
+export { computeAIConfigDiff, computeAIConfigVersion, createAIConfigEvidence, snapshotAIConfig, } from './ai-config-diff.js';
+import { createAIConfigEvidence } from './ai-config-diff.js';
+// ---------------------------------------------------------------------------
+// Factory functions
+// ---------------------------------------------------------------------------
+const DEFAULT_SCOPE = { kind: 'app', ownerId: 'desktop', surfaceId: 'chat' };
+const CANONICAL_MOD_SCOPE_SURFACE_ID = 'workspace';
+// ---------------------------------------------------------------------------
+// Built-in first-run chat scopes  (P-AISC-006 / S-AICONF-007)
+// ---------------------------------------------------------------------------
+/** Canonical owner of the two built-in first-run chat feature surfaces. */
+const BUILT_IN_CHAT_FEATURE_OWNER_ID = 'desktop.chat';
+const BUILT_IN_CHAT_SURFACE_IDS = ['nimi', 'agent'];
+function normalizeRequiredId(value, label) {
+    const normalized = String(value || '').trim();
+    if (!normalized) {
+        throw createNimiError({
+            message: `${label} is required`,
+            reasonCode: ReasonCode.ACTION_INPUT_INVALID,
+            actionHint: `provide_${label.replace(/\s+/g, '_')}`,
+            source: 'sdk',
+        });
+    }
+    return normalized;
+}
+/** Create the default app-level scope ref for Phase 1. */
+export function createDefaultAIScopeRef() {
+    return { ...DEFAULT_SCOPE };
+}
+/** Create the canonical Phase 1 mod workspace scope ref. */
+export function createCanonicalModAIScopeRef(modId) {
+    return {
+        kind: 'mod',
+        ownerId: normalizeRequiredId(modId, 'mod id'),
+        surfaceId: CANONICAL_MOD_SCOPE_SURFACE_ID,
+    };
+}
+/** True when the scope matches the canonical Phase 1 mod workspace scope. */
+export function isCanonicalModAIScopeRef(scopeRef, modId) {
+    if (!scopeRef) {
+        return false;
+    }
+    const normalizedModId = String(modId || '').trim();
+    if (!normalizedModId) {
+        return false;
+    }
+    return scopeRef.kind === 'mod'
+        && String(scopeRef.ownerId || '').trim() === normalizedModId
+        && String(scopeRef.surfaceId || '').trim() === CANONICAL_MOD_SCOPE_SURFACE_ID;
+}
+/** Assert that the caller provided the canonical Phase 1 mod workspace scope. */
+export function assertCanonicalModAIScopeRef(scopeRef, modId) {
+    const canonicalScopeRef = createCanonicalModAIScopeRef(modId);
+    if (!scopeRef) {
+        throw createNimiError({
+            message: 'mod AIConfig scopeRef is required',
+            reasonCode: ReasonCode.ACTION_INPUT_INVALID,
+            actionHint: 'provide_explicit_mod_scope_ref',
+            source: 'sdk',
+        });
+    }
+    if (!isCanonicalModAIScopeRef(scopeRef, canonicalScopeRef.ownerId)) {
+        throw createNimiError({
+            message: `mod AIConfig scopeRef must equal ${canonicalScopeRef.kind}:${canonicalScopeRef.ownerId}:${canonicalScopeRef.surfaceId}`,
+            reasonCode: ReasonCode.ACTION_INPUT_INVALID,
+            actionHint: 'use_canonical_mod_workspace_scope_ref',
+            source: 'sdk',
+        });
+    }
+    return canonicalScopeRef;
+}
+/**
+ * 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 function createBuiltInChatAIScopeRef(surfaceId) {
+    const normalized = String(surfaceId || '').trim();
+    if (normalized !== 'nimi' && normalized !== 'agent') {
+        throw createNimiError({
+            message: "built-in chat surface id must be 'nimi' or 'agent'",
+            reasonCode: ReasonCode.ACTION_INPUT_INVALID,
+            actionHint: 'provide_canonical_built_in_chat_surface_id',
+            source: 'sdk',
+        });
+    }
+    return {
+        kind: 'feature',
+        ownerId: BUILT_IN_CHAT_FEATURE_OWNER_ID,
+        surfaceId: normalized,
+    };
+}
+/** True when the scope is exactly one of the two canonical built-in chat scopes. */
+export function isBuiltInChatAIScopeRef(scopeRef) {
+    if (!scopeRef) {
+        return false;
+    }
+    const surfaceId = String(scopeRef.surfaceId || '').trim();
+    return scopeRef.kind === 'feature'
+        && String(scopeRef.ownerId || '').trim() === BUILT_IN_CHAT_FEATURE_OWNER_ID
+        && (surfaceId === 'nimi' || surfaceId === 'agent');
+}
+/**
+ * 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 function assertBuiltInChatAIScopeRef(scopeRef) {
+    if (!scopeRef) {
+        throw createNimiError({
+            message: 'built-in chat AIScopeRef is required and must be provided explicitly',
+            reasonCode: ReasonCode.ACTION_INPUT_INVALID,
+            actionHint: 'provide_explicit_built_in_chat_scope_ref',
+            source: 'sdk',
+        });
+    }
+    if (!isBuiltInChatAIScopeRef(scopeRef)) {
+        throw createNimiError({
+            message: "built-in chat AIScopeRef must equal feature:desktop.chat:nimi or feature:desktop.chat:agent",
+            reasonCode: ReasonCode.ACTION_INPUT_INVALID,
+            actionHint: 'use_canonical_built_in_chat_scope_ref',
+            source: 'sdk',
+        });
+    }
+    return createBuiltInChatAIScopeRef(scopeRef.surfaceId);
+}
+/** The canonical first-run built-in chat scope set, in stable order (P-AISC-006). */
+export function builtInChatAIScopeRefs() {
+    return BUILT_IN_CHAT_SURFACE_IDS.map((surfaceId) => createBuiltInChatAIScopeRef(surfaceId));
+}
+/**
+ * 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 async function applyFirstRunBuiltInChatAIConfig(input) {
+    const boundScopeRef = assertBuiltInChatAIScopeRef(input.scopeRef);
+    const validation = validateAIProfile(input.profile);
+    if (!validation.valid) {
+        throw createNimiError({
+            message: `first-run built-in chat AIProfile is invalid: ${validation.errors.join('; ')}`,
+            reasonCode: ReasonCode.ACTION_INPUT_INVALID,
+            actionHint: 'provide_valid_first_run_built_in_chat_ai_profile',
+            source: 'sdk',
+        });
+    }
+    if (typeof input.applyHostAiConfig !== 'function') {
+        throw createNimiError({
+            message: 'first-run built-in chat AIConfig requires a host AIConfig apply authority',
+            reasonCode: ReasonCode.ACTION_INPUT_INVALID,
+            actionHint: 'provide_host_ai_config_apply_authority',
+            source: 'sdk',
+        });
+    }
+    const ref = String(await input.applyHostAiConfig(boundScopeRef, input.profile) || '').trim();
+    if (!ref) {
+        throw createNimiError({
+            message: 'host AIConfig service did not return a durable built-in AIConfig ref',
+            reasonCode: ReasonCode.ACTION_INPUT_INVALID,
+            actionHint: 'host_ai_config_service_must_return_durable_ref',
+            source: 'sdk',
+        });
+    }
+    return { scopeRef: boundScopeRef, ref };
+}
+/**
+ * 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 async function applyFirstRunBuiltInChatAIConfigs(input) {
+    const builtInAiConfigRefs = [];
+    for (const scopeRef of builtInChatAIScopeRefs()) {
+        builtInAiConfigRefs.push(await applyFirstRunBuiltInChatAIConfig({
+            scopeRef,
+            profile: input.profile,
+            applyHostAiConfig: input.applyHostAiConfig,
+        }));
+    }
+    return { builtInAiConfigRefs };
+}
+/** Create an empty AIConfig for a given scope. */
+export function createEmptyAIConfig(scopeRef) {
+    return {
+        scopeRef: scopeRef || createDefaultAIScopeRef(),
+        capabilities: { selectedBindings: {}, localProfileRefs: {}, selectedParams: {} },
+        profileOrigin: null,
+    };
+}
+/** Create an empty adjacent memory-embedding config for a given scope. */
+export function createEmptyMemoryEmbeddingConfig(scopeRef) {
+    const now = new Date().toISOString();
+    return {
+        scopeRef: scopeRef || createDefaultAIScopeRef(),
+        sourceKind: null,
+        bindingRef: null,
+        revisionToken: now,
+        updatedAt: now,
+    };
+}
+// ---------------------------------------------------------------------------
+// Factory functions
+// ---------------------------------------------------------------------------
+/**
+ * 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 function applyAIProfileToConfig(config, profile) {
+    const selectedBindings = {};
+    const localProfileRefs = {};
+    const selectedParams = {};
+    for (const [capability, intent] of Object.entries(profile.capabilities)) {
+        if (!intent)
+            continue;
+        if (intent.binding !== undefined) {
+            selectedBindings[capability] = intent.binding;
+        }
+        if (intent.localProfileRef !== undefined) {
+            localProfileRefs[capability] = intent.localProfileRef;
+        }
+        if (intent.params !== undefined && intent.params !== null) {
+            selectedParams[capability] = intent.params;
+        }
+    }
+    return {
+        scopeRef: config.scopeRef,
+        capabilities: { selectedBindings, localProfileRefs, selectedParams },
+        profileOrigin: {
+            profileId: profile.profileId,
+            title: profile.title,
+            appliedAt: new Date().toISOString(),
+        },
+    };
+}
+/** Static schema validation for AIProfile (D-AIPC-012 layer 1). */
+export function validateAIProfile(profile) {
+    const errors = [];
+    if (!profile || typeof profile !== 'object' || Array.isArray(profile)) {
+        return { valid: false, errors: ['profile must be a non-null object'] };
+    }
+    const p = profile;
+    if (typeof p.profileId !== 'string' || !p.profileId)
+        errors.push('profileId is required');
+    if (typeof p.title !== 'string' || !p.title)
+        errors.push('title is required');
+    if (typeof p.description !== 'string')
+        errors.push('description must be a string');
+    if (!Array.isArray(p.tags))
+        errors.push('tags must be an array');
+    if (!p.capabilities || typeof p.capabilities !== 'object' || Array.isArray(p.capabilities)) {
+        errors.push('capabilities must be a non-null object');
+    }
+    return { valid: errors.length === 0, errors };
+}
+/** Create a canonical execution ID for AISnapshot records. */
+export function createAISnapshotExecutionId(nowMs = Date.now()) {
+    return createNimiUlid(nowMs);
+}
+/** Create a canonical AISnapshot record using the published SDK schema. */
+export function createAISnapshotRecord(input) {
+    const executionId = String(input.executionId || '').trim() || createAISnapshotExecutionId();
+    const createdAt = String(input.createdAt || '').trim() || new Date().toISOString();
+    return {
+        executionId,
+        scopeRef: input.scopeRef || input.config.scopeRef,
+        configEvidence: createAIConfigEvidence(input.config),
+        conversationCapabilitySlice: {
+            executionId,
+            createdAt,
+            capability: String(input.capability || '').trim(),
+            selectedBinding: input.selectedBinding || null,
+            resolvedBinding: input.resolvedBinding ?? null,
+            health: input.health ?? null,
+            metadata: input.metadata ?? null,
+            agentResolution: input.agentResolution ?? null,
+        },
+        runtimeEvidence: input.runtimeEvidence ?? null,
+        createdAt,
+    };
+}
+//# sourceMappingURL=ai-config.js.map

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

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

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

@@ -0,0 +1,177 @@
+/**
+ * Per-app first-launch AIConfig initialization (S-AICONF-009).
+ *
+ * Spec authority:
+ *   P-AISC-007    App-launch AIConfig scope identity
+ *   S-AICONF-009  Per-app first-launch AIConfig initialization
+ *   P-AIPS-009    First-party app AIProfile hint
+ *   P-AIPS-013    Account Default Profile local library evidence
+ *   D-AIPC-005    AIProfile atomic overwrite apply
+ *
+ * Responsibility split: `ai-config.ts` owns the canonical `AIScopeRef` /
+ * `AIProfile` / `AIConfig` types and the generic profile-apply machinery.
+ * This file owns ONLY the app-launch scope factory and the first-launch
+ * initialization decision logic. It is host-agnostic: every external
+ * dependency (existing-config lookup, recommended/default profile resolution,
+ * host apply authority, manifest validation) is injected by the caller so the
+ * SDK never reaches a renderer cache, file path, or string-keyed scope.
+ *
+ * Fail-closed posture:
+ *   - The init scope must be the canonical P-AISC-007 `app` shape; an inferred
+ *     or generic-default scope is rejected.
+ *   - When neither a satisfied recommended profile nor a resolvable Account
+ *     Default Profile is available, initialization fails closed with a typed
+ *     error — never a synthesized/empty/placeholder AIConfig.
+ *   - An app scope that already has an AIConfig is NEVER re-initialized; a
+ *     changed Default Profile or recommended-profile ref cannot overwrite it.
+ *   - Unmet manifest requirements produce a typed setup/repair plan, never a
+ *     silent partial config or a mutated profile/template.
+ */
+import { type AIConfig, type AIProfile, type AIScopeRef } from './ai-config.js';
+/**
+ * Create the canonical app-launch `AIScopeRef` (P-AISC-007).
+ *
+ * `ownerId` must be the admitted Nimi App `app_id` (dot-separated namespace
+ * app identity, e.g. `nimi.avatar`). `surfaceId` is optional and may only be
+ * an app-manifest-declared stable AI feature surface id; omitting it denotes
+ * the app's single canonical app-level AI scope.
+ *
+ * The caller must pass an explicit `app_id`. There is no omitted-scope
+ * inference and the result is never the generic chat default scope.
+ */
+export declare function createAppAIScopeRef(appId: string, surfaceId?: string): AIScopeRef;
+/**
+ * True when the scope is a well-formed P-AISC-007 app-launch scope: `app`
+ * kind, a non-empty `ownerId`, and either no `surfaceId` or a non-empty one.
+ */
+export declare function isAppAIScopeRef(scopeRef: AIScopeRef | null | undefined): boolean;
+/**
+ * Assert that the caller provided a canonical P-AISC-007 app-launch scope and
+ * return its normalized form. Rejects an omitted/null scope, a non-`app`
+ * kind, an empty `ownerId`, and a blank `surfaceId`. The SDK never infers the
+ * scope from active selection or a consumer-default app scope.
+ */
+export declare function assertAppAIScopeRef(scopeRef: AIScopeRef | null | undefined): AIScopeRef;
+/** Which profile source materialized the app's first-launch AIConfig. */
+export type AppFirstLaunchProfileSource = 'recommended-profile' | 'account-default-profile';
+/**
+ * One unmet manifest requirement detected after the materialized AIConfig was
+ * validated against the app's manifest (S-AICONF-009). The plan never mutates
+ * the profile, scope config, or factory template to force a pass.
+ */
+export type AppManifestRequirementGap = {
+    /** Stable typed requirement identifier from the app manifest. */
+    requirementId: string;
+    /** Human-readable detail of what is missing / unsatisfied. */
+    detail: string;
+};
+/**
+ * Typed setup/repair plan returned when the app validates the materialized
+ * AIConfig against its manifest and finds requirements unmet. The app scope
+ * AIConfig has still been atomically written (initialization is complete);
+ * the plan describes follow-up setup the user must perform.
+ */
+export type AppAIConfigSetupRepairPlan = {
+    /** Unmet manifest requirements, in stable order. */
+    unmetRequirements: AppManifestRequirementGap[];
+};
+/**
+ * Result of `ensureAppFirstLaunchAIConfig`.
+ *
+ * - `initialized` — first launch; the scope's AIConfig was materialized from
+ *   `profileSource` via the typed apply path. `setupRepairPlan` is non-null
+ *   when the materialized config does not yet meet the app's manifest reqs.
+ * - `already-initialized` — the scope already had an AIConfig; nothing was
+ *   written and the existing config is returned unchanged.
+ */
+export type AppFirstLaunchAIConfigResult = {
+    outcome: 'initialized';
+    scopeRef: AIScopeRef;
+    config: AIConfig;
+    profileSource: AppFirstLaunchProfileSource;
+    profileId: string;
+    setupRepairPlan: AppAIConfigSetupRepairPlan | null;
+} | {
+    outcome: 'already-initialized';
+    scopeRef: AIScopeRef;
+    config: AIConfig;
+};
+/**
+ * A resolved recommended factory `AIProfile` for an app, plus whether the app
+ * validates its manifest requirements as satisfied by that profile.
+ *
+ * The caller resolves the app's registry-row `ai_profile_selection_ref`
+ * (`P-NAPP-002` / `P-NAPP-003`) to a factory `AIProfile`; `manifestSatisfied`
+ * reflects the app's own validation of that profile against its manifest. A
+ * `null` resolution means the recommended profile is undeclared or does not
+ * resolve to an admitted factory profile.
+ */
+export type ResolvedRecommendedProfile = {
+    profile: AIProfile;
+    manifestSatisfied: boolean;
+};
+/**
+ * Dependencies for `ensureAppFirstLaunchAIConfig`. Every external authority is
+ * injected so the SDK helper stays host-agnostic and testable.
+ */
+export type EnsureAppFirstLaunchAIConfigDeps = {
+    /**
+     * The canonical P-AISC-007 app-launch scope to initialize. Required and
+     * explicit — the helper never infers it.
+     */
+    scopeRef: AIScopeRef;
+    /**
+     * Read the scope's existing persisted AIConfig, or `null` when the scope
+     * has never been initialized. Resolving to a config short-circuits the
+     * helper to `already-initialized` with no write.
+     */
+    getExistingAppAIConfig: (scopeRef: AIScopeRef) => Promise<AIConfig | null> | AIConfig | null;
+    /**
+     * Resolve the app's recommended factory `AIProfile` from its registry-row
+     * `ai_profile_selection_ref` (`P-NAPP-002` / `P-NAPP-003`, `P-AIPS-009`).
+     * Returns `null` when the ref is undeclared or unresolvable. The returned
+     * `manifestSatisfied` flag is the app's own validation of the profile
+     * against its manifest.
+     */
+    resolveRecommendedProfile: (scopeRef: AIScopeRef) => Promise<ResolvedRecommendedProfile | null> | ResolvedRecommendedProfile | null;
+    /**
+     * Resolve the Account Default Profile (`accountDefaultProfileRef`,
+     * `P-AIPS-013`) as a portable `AIProfile`. Returns `null` when the durable
+     * record is missing/stale/unresolvable.
+     */
+    resolveAccountDefaultProfile: () => Promise<AIProfile | null> | AIProfile | null;
+    /**
+     * Host AIConfig apply authority: atomically overwrite the scope's AIConfig
+     * from the materialized config (D-AIPC-005, `aiProfile.apply` path) and
+     * return the committed config. The host owns durable persistence.
+     */
+    applyHostAiConfig: (scopeRef: AIScopeRef, config: AIConfig) => Promise<AIConfig> | AIConfig;
+    /**
+     * Optionally validate the materialized AIConfig against the app's manifest
+     * requirements. Returns the unmet requirement gaps (empty when satisfied).
+     * When omitted, no manifest validation is performed.
+     */
+    validateManifestRequirements?: (scopeRef: AIScopeRef, config: AIConfig) => Promise<AppManifestRequirementGap[]> | AppManifestRequirementGap[];
+};
+/**
+ * Initialize a Nimi App's per-app AIConfig on first launch (S-AICONF-009).
+ *
+ * Decision order:
+ *  1. If the app scope already has an AIConfig → `already-initialized`, no
+ *     write. A changed Default Profile or `ai_profile_selection_ref` can
+ *     never re-initialize an existing scope.
+ *  2. Else resolve the app's recommended profile. Use it ONLY when it is
+ *     declared, resolves to an admitted factory `AIProfile`, AND the app
+ *     validates its manifest requirements as satisfied.
+ *  3. Else initialize from the Account Default Profile (`P-AIPS-013`).
+ *  4. If neither resolves → fail closed with a typed error. No synthesized,
+ *     empty, or placeholder AIConfig; the app does not launch.
+ *
+ * The chosen profile is materialized via the D-AIPC-005 atomic-overwrite path
+ * (`applyAIProfileToConfig`) into a full AIConfig and committed through the
+ * host apply authority. When manifest validation finds remaining unmet
+ * requirements, the result carries a typed setup/repair plan — the helper
+ * never mutates the profile, scope config, or template to force a pass.
+ */
+export declare function ensureAppFirstLaunchAIConfig(deps: EnsureAppFirstLaunchAIConfigDeps): Promise<AppFirstLaunchAIConfigResult>;
+//# sourceMappingURL=app-ai-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app-ai-config.d.ts","sourceRoot":"","sources":["../../../src/mod/runtime/app-ai-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAIH,OAAO,EAIL,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,UAAU,EAChB,MAAM,gBAAgB,CAAC;AAMxB;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU,CAwBjF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAQhF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,CAmBvF;AAMD,yEAAyE;AACzE,MAAM,MAAM,2BAA2B,GAAG,qBAAqB,GAAG,yBAAyB,CAAC;AAE5F;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,iEAAiE;IACjE,aAAa,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,oDAAoD;IACpD,iBAAiB,EAAE,yBAAyB,EAAE,CAAC;CAChD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,4BAA4B,GACpC;IACE,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,UAAU,CAAC;IACrB,MAAM,EAAE,QAAQ,CAAC;IACjB,aAAa,EAAE,2BAA2B,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,0BAA0B,GAAG,IAAI,CAAC;CACpD,GACD;IACE,OAAO,EAAE,qBAAqB,CAAC;IAC/B,QAAQ,EAAE,UAAU,CAAC;IACrB,MAAM,EAAE,QAAQ,CAAC;CAClB,CAAC;AAEN;;;;;;;;;GASG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,EAAE,SAAS,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gCAAgC,GAAG;IAC7C;;;OAGG;IACH,QAAQ,EAAE,UAAU,CAAC;IACrB;;;;OAIG;IACH,sBAAsB,EAAE,CAAC,QAAQ,EAAE,UAAU,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC7F;;;;;;OAMG;IACH,yBAAyB,EAAE,CACzB,QAAQ,EAAE,UAAU,KACjB,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,GAAG,0BAA0B,GAAG,IAAI,CAAC;IACpF;;;;OAIG;IACH,4BAA4B,EAAE,MAAM,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC;IACjF;;;;OAIG;IACH,iBAAiB,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;IAC5F;;;;OAIG;IACH,4BAA4B,CAAC,EAAE,CAC7B,QAAQ,EAAE,UAAU,EACpB,MAAM,EAAE,QAAQ,KACb,OAAO,CAAC,yBAAyB,EAAE,CAAC,GAAG,yBAAyB,EAAE,CAAC;CACzE,CAAC;AAkBF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,gCAAgC,GACrC,OAAO,CAAC,4BAA4B,CAAC,CAyGvC"}