@ace-sdk/core 1.0.0

package/dist/config/context.js

@@ -0,0 +1,147 @@
+/**
+ * Context Creation and Resolution
+ * @package @ace-sdk/core
+ */
+import { isatty } from 'tty';
+import { DEFAULT_RUNTIME_SETTINGS } from '../types/config.js';
+import { loadConfig } from './loader.js';
+import { getTokenForOrg } from './helpers.js';
+/**
+ * Checks if running in an interactive terminal
+ */
+function isInteractive() {
+    return isatty(process.stdout.fd) && isatty(process.stdin.fd);
+}
+/**
+ * Resolves org and project context using 3-tier precedence:
+ *
+ * 1. CLI flags (--org, --project) - HIGHEST PRIORITY
+ * 2. Environment variables (ACE_ORG_ID, ACE_PROJECT_ID)
+ * 3. Error - NO CONTEXT FOUND
+ *
+ * Note: .claude/settings.json is NOT read by this function. That's Claude Code's job.
+ * Claude Code reads .claude/settings.json and sets ACE_ORG_ID/ACE_PROJECT_ID as ENV vars.
+ *
+ * @param options - CLI flags and working directory
+ * @returns Resolved org and project IDs with source
+ * @throws Error if no context can be resolved
+ */
+export function resolveContext(options = {}) {
+    // Tier 1: CLI flags (highest priority)
+    if (options.org && options.project) {
+        return {
+            orgId: options.org,
+            projectId: options.project,
+            source: 'flags'
+        };
+    }
+    // Partial flags - need to combine with other sources
+    let orgId = options.org;
+    let projectId = options.project;
+    let source = 'flags';
+    // Tier 2: Environment variables (set by Claude Code from .claude/settings.json)
+    if (!orgId && process.env.ACE_ORG_ID) {
+        orgId = process.env.ACE_ORG_ID;
+        source = 'env';
+    }
+    if (!projectId && process.env.ACE_PROJECT_ID) {
+        projectId = process.env.ACE_PROJECT_ID;
+        if (!orgId)
+            source = 'env'; // Only change source if no flags used
+    }
+    // Final check: do we have both?
+    if (orgId && projectId) {
+        return { orgId, projectId, source };
+    }
+    // Tier 3: Error - no context found
+    const interactive = isInteractive();
+    const missing = [];
+    if (!orgId)
+        missing.push('organization ID');
+    if (!projectId)
+        missing.push('project ID');
+    let errorMessage = `Could not resolve ${missing.join(' and ')}.\n\n`;
+    if (interactive) {
+        errorMessage += `Please use one of the following methods:\n\n`;
+        errorMessage += `1. Use CLI flags:\n`;
+        errorMessage += `   ce-ace <command> --org org_xxx --project prj_xxx\n\n`;
+        errorMessage += `2. Set environment variables:\n`;
+        errorMessage += `   export ACE_ORG_ID=org_xxx\n`;
+        errorMessage += `   export ACE_PROJECT_ID=prj_xxx\n\n`;
+        errorMessage += `3. Run configuration wizard:\n`;
+        errorMessage += `   ce-ace config\n`;
+        errorMessage += `   (This helps set up ~/.config/ace/config.json with org tokens)\n\n`;
+        errorMessage += `Note: If using Claude Code, set ACE_ORG_ID and ACE_PROJECT_ID in .claude/settings.json:\n`;
+        errorMessage += `   {\n`;
+        errorMessage += `     "env": {\n`;
+        errorMessage += `       "ACE_ORG_ID": "org_xxx",\n`;
+        errorMessage += `       "ACE_PROJECT_ID": "prj_xxx"\n`;
+        errorMessage += `     }\n`;
+        errorMessage += `   }\n`;
+    }
+    else {
+        // Non-interactive (hooks, CI)
+        errorMessage += `Running in non-interactive mode (hook or CI).\n\n`;
+        errorMessage += `Set ACE_ORG_ID and ACE_PROJECT_ID environment variables, or use --org and --project flags.\n`;
+    }
+    throw new Error(errorMessage);
+}
+/**
+ * Validates that an org ID matches the expected format
+ */
+export function isValidOrgId(orgId) {
+    return /^org_[a-zA-Z0-9_-]+$/.test(orgId);
+}
+/**
+ * Validates that a project ID matches the expected format
+ */
+export function isValidProjectId(projectId) {
+    return /^prj_[a-f0-9]+$/.test(projectId);
+}
+/**
+ * Create AceContext from CLI flags, environment, and config files
+ *
+ * This function implements the complete context resolution flow:
+ * 1. Resolve org/project using 4-tier precedence (flags > env > .claude/settings.json > error)
+ * 2. Load global config to get server URL and tokens
+ * 3. Get the correct token for the resolved organization
+ * 4. Merge with server-derived runtime settings
+ *
+ * @param options - CLI flags for org/project override
+ * @param serverConfig - Optional server configuration (fetched via ACEServerClient.getConfig())
+ * @param configOverrides - Optional config overrides
+ * @param logger - Optional logger
+ * @returns Complete runtime context with merged settings
+ * @throws Error if context cannot be resolved
+ */
+export async function createContext(options = {}, serverConfig, configOverrides, logger) {
+    // Step 1: Resolve org and project IDs using precedence chain
+    const resolved = resolveContext(options);
+    const { orgId, projectId } = resolved;
+    // Step 2: Load global config
+    const globalConfig = loadConfig(configOverrides, logger);
+    // Step 3: Get the correct API token for this organization
+    const apiToken = getTokenForOrg(globalConfig, orgId);
+    // Step 4: Merge server runtime settings with defaults
+    const runtimeSettings = {
+        ...DEFAULT_RUNTIME_SETTINGS,
+        ...(serverConfig?.runtime_settings || {})
+    };
+    // Step 5: Override with environment variables if present
+    if (process.env.ACE_SEARCH_THRESHOLD) {
+        runtimeSettings.searchThreshold = parseFloat(process.env.ACE_SEARCH_THRESHOLD);
+    }
+    if (process.env.ACE_LEARNING_ENABLED) {
+        runtimeSettings.learningEnabled = process.env.ACE_LEARNING_ENABLED === 'true';
+    }
+    // Step 6: Return complete context
+    return {
+        serverUrl: globalConfig.serverUrl,
+        apiToken,
+        projectId,
+        orgId,
+        cacheTtlMinutes: globalConfig.cacheTtlMinutes,
+        runtimeSettings
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/config/context.js.map

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

package/dist/config/helpers.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Configuration Helper Functions
+ * @package @ace-sdk/core
+ */
+import { AceConfig } from '../types/config.js';
+/**
+ * Gets the API token for a specific organization
+ *
+ * In multi-org mode: Looks up token by org ID in config.orgs
+ * In single-org mode: Returns root-level apiToken
+ *
+ * @param config - ACE configuration
+ * @param orgId - Organization ID (e.g., org_34fYIl...)
+ * @returns API token for the organization
+ * @throws Error if no token found for the specified org
+ */
+export declare function getTokenForOrg(config: AceConfig, orgId: string): string;
+/**
+ * Gets the organization name for display purposes
+ *
+ * @param config - ACE configuration
+ * @param orgId - Organization ID
+ * @returns Organization name or the org ID if name not found
+ */
+export declare function getOrgName(config: AceConfig, orgId: string): string;
+/**
+ * Lists all configured organizations
+ *
+ * @param config - ACE configuration
+ * @returns Array of { orgId, orgName, projectCount }
+ */
+export declare function listOrganizations(config: AceConfig): Array<{
+    orgId: string;
+    orgName: string;
+    projectCount: number;
+}>;
+/**
+ * Checks if a project belongs to a specific organization
+ *
+ * @param config - ACE configuration
+ * @param orgId - Organization ID
+ * @param projectId - Project ID
+ * @returns true if the project belongs to the org, false otherwise
+ */
+export declare function projectBelongsToOrg(config: AceConfig, orgId: string, projectId: string): boolean;
+/**
+ * Extracts organization ID from an API token
+ *
+ * ACE tokens have format: ace_{orgId8chars}{random}
+ * Example: ace_34fYIlitYk4nyFuTvtsAzA6uUJF
+ *          → org_34fYIlit
+ *
+ * @param token - API token
+ * @returns Organization ID or null if can't extract
+ */
+export declare function extractOrgIdFromToken(token: string): string | null;
+/**
+ * Gets all projects for a specific organization
+ *
+ * @param config - ACE configuration
+ * @param orgId - Organization ID
+ * @returns Array of project IDs
+ */
+export declare function getProjectsForOrg(config: AceConfig, orgId: string): string[];
+/**
+ * Checks if the configuration is in multi-org mode
+ *
+ * @param config - ACE configuration
+ * @returns true if multi-org mode is active
+ */
+export declare function isMultiOrgMode(config: AceConfig): boolean;
+/**
+ * Validates configuration completeness
+ *
+ * @param config - ACE configuration
+ * @returns Array of validation error messages (empty if valid)
+ */
+export declare function validateConfig(config: AceConfig): string[];
+//# sourceMappingURL=helpers.d.ts.map

package/dist/config/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/config/helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA4BvE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKnE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,KAAK,CAAC;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CAuBD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,OAAO,CAQT;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAalE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAK5E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,EAAE,CA6B1D"}

package/dist/config/helpers.js

@@ -0,0 +1,173 @@
+/**
+ * Configuration Helper Functions
+ * @package @ace-sdk/core
+ */
+/**
+ * Gets the API token for a specific organization
+ *
+ * In multi-org mode: Looks up token by org ID in config.orgs
+ * In single-org mode: Returns root-level apiToken
+ *
+ * @param config - ACE configuration
+ * @param orgId - Organization ID (e.g., org_34fYIl...)
+ * @returns API token for the organization
+ * @throws Error if no token found for the specified org
+ */
+export function getTokenForOrg(config, orgId) {
+    // Multi-org mode: Look up token by org ID
+    if (config.orgs && config.orgs[orgId]) {
+        return config.orgs[orgId].apiToken;
+    }
+    // Single-org mode: Fall back to root-level token
+    if (config.apiToken) {
+        return config.apiToken;
+    }
+    // No token found
+    throw new Error(`No API token found for organization ${orgId}.\n\n` +
+        `This organization is not configured in ~/.config/ace/config.json.\n\n` +
+        `To fix this:\n` +
+        `1. Run: ce-ace config\n` +
+        `2. Or add the organization manually to ~/.config/ace/config.json:\n\n` +
+        `{\n` +
+        `  "orgs": {\n` +
+        `    "${orgId}": {\n` +
+        `      "orgName": "Your Org Name",\n` +
+        `      "apiToken": "ace_xxx...",\n` +
+        `      "projects": ["prj_xxx..."]\n` +
+        `    }\n` +
+        `  }\n` +
+        `}\n`);
+}
+/**
+ * Gets the organization name for display purposes
+ *
+ * @param config - ACE configuration
+ * @param orgId - Organization ID
+ * @returns Organization name or the org ID if name not found
+ */
+export function getOrgName(config, orgId) {
+    if (config.orgs && config.orgs[orgId]) {
+        return config.orgs[orgId].orgName || orgId;
+    }
+    return orgId;
+}
+/**
+ * Lists all configured organizations
+ *
+ * @param config - ACE configuration
+ * @returns Array of { orgId, orgName, projectCount }
+ */
+export function listOrganizations(config) {
+    const orgs = [];
+    if (config.orgs) {
+        // Multi-org mode
+        for (const [orgId, orgConfig] of Object.entries(config.orgs)) {
+            orgs.push({
+                orgId,
+                orgName: orgConfig.orgName || orgId,
+                projectCount: orgConfig.projects?.length || 0
+            });
+        }
+    }
+    else if (config.apiToken) {
+        // Single-org mode - try to extract org ID from token
+        const orgId = extractOrgIdFromToken(config.apiToken);
+        orgs.push({
+            orgId: orgId || 'default',
+            orgName: 'Default Organization',
+            projectCount: 0
+        });
+    }
+    return orgs;
+}
+/**
+ * Checks if a project belongs to a specific organization
+ *
+ * @param config - ACE configuration
+ * @param orgId - Organization ID
+ * @param projectId - Project ID
+ * @returns true if the project belongs to the org, false otherwise
+ */
+export function projectBelongsToOrg(config, orgId, projectId) {
+    if (config.orgs && config.orgs[orgId]) {
+        const projects = config.orgs[orgId].projects || [];
+        return projects.includes(projectId);
+    }
+    // In single-org mode, assume any project is valid
+    return true;
+}
+/**
+ * Extracts organization ID from an API token
+ *
+ * ACE tokens have format: ace_{orgId8chars}{random}
+ * Example: ace_34fYIlitYk4nyFuTvtsAzA6uUJF
+ *          → org_34fYIlit
+ *
+ * @param token - API token
+ * @returns Organization ID or null if can't extract
+ */
+export function extractOrgIdFromToken(token) {
+    if (!token.startsWith('ace_')) {
+        return null;
+    }
+    // Extract first 8 chars after 'ace_'
+    const orgIdPart = token.substring(4, 12);
+    if (orgIdPart.length === 8) {
+        return `org_${orgIdPart}`;
+    }
+    return null;
+}
+/**
+ * Gets all projects for a specific organization
+ *
+ * @param config - ACE configuration
+ * @param orgId - Organization ID
+ * @returns Array of project IDs
+ */
+export function getProjectsForOrg(config, orgId) {
+    if (config.orgs && config.orgs[orgId]) {
+        return config.orgs[orgId].projects || [];
+    }
+    return [];
+}
+/**
+ * Checks if the configuration is in multi-org mode
+ *
+ * @param config - ACE configuration
+ * @returns true if multi-org mode is active
+ */
+export function isMultiOrgMode(config) {
+    return !!(config.orgs && Object.keys(config.orgs).length > 0);
+}
+/**
+ * Validates configuration completeness
+ *
+ * @param config - ACE configuration
+ * @returns Array of validation error messages (empty if valid)
+ */
+export function validateConfig(config) {
+    const errors = [];
+    // Check server URL
+    if (!config.serverUrl) {
+        errors.push('Missing serverUrl in configuration');
+    }
+    // Check authentication
+    const hasMultiOrg = config.orgs && Object.keys(config.orgs).length > 0;
+    const hasSingleOrg = !!config.apiToken;
+    if (!hasMultiOrg && !hasSingleOrg) {
+        errors.push('No API token configured (neither multi-org nor single-org mode)');
+    }
+    // Validate multi-org structure
+    if (hasMultiOrg && config.orgs) {
+        for (const [orgId, orgConfig] of Object.entries(config.orgs)) {
+            if (!orgConfig.apiToken) {
+                errors.push(`Organization ${orgId} is missing apiToken`);
+            }
+            if (!orgId.startsWith('org_')) {
+                errors.push(`Invalid organization ID format: ${orgId} (should start with 'org_')`);
+            }
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/config/helpers.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Config exports for @ace-sdk/core
+ */
+export { loadConfig, getConfigPath, isConfigured } from './loader.js';
+export type { ConfigOverrides, LoadConfigResult } from './loader.js';
+export { expandPath, autodiscoverConfigPath, getLegacyConfigPath, getXdgConfigPath, autoMigrateConfig, ensureConfigDirectory, setSecurePermissions } from './xdg.js';
+export { migrateConfig, checkAndMigrate, autoMigrate } from './migration.js';
+export { getTokenForOrg, getOrgName, listOrganizations, projectBelongsToOrg, extractOrgIdFromToken, getProjectsForOrg, isMultiOrgMode, validateConfig } from './helpers.js';
+export { resolveContext, isValidOrgId, isValidProjectId, createContext } from './context.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACtE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAErE,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACrK,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5K,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,9 @@
+/**
+ * Config exports for @ace-sdk/core
+ */
+export { loadConfig, getConfigPath, isConfigured } from './loader.js';
+export { expandPath, autodiscoverConfigPath, getLegacyConfigPath, getXdgConfigPath, autoMigrateConfig, ensureConfigDirectory, setSecurePermissions } from './xdg.js';
+export { migrateConfig, checkAndMigrate, autoMigrate } from './migration.js';
+export { getTokenForOrg, getOrgName, listOrganizations, projectBelongsToOrg, extractOrgIdFromToken, getProjectsForOrg, isMultiOrgMode, validateConfig } from './helpers.js';
+export { resolveContext, isValidOrgId, isValidProjectId, createContext } from './context.js';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGtE,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACrK,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5K,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/config/loader.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Configuration Loader - Core Logic
+ *
+ * Loads ACE configuration from multiple sources with priority order:
+ * 1. Override options (passed by caller, e.g., from CLI args)
+ * 2. Environment variables: ACE_CONFIG_PATH, ACE_PROJECT_ID
+ * 3. Config file (autodiscovered or specified)
+ * 4. Default values (lowest)
+ *
+ * XDG Base Directory Specification:
+ * - Default: ~/.config/ace/config.json
+ * - Legacy: ~/.ace/config.json (auto-migrated with backup)
+ *
+ * @package @ace-sdk/core
+ */
+import type { AceConfig } from '../types/config.js';
+import type { ILogger } from '../logger/index.js';
+/**
+ * Options to override configuration values
+ * Typically populated from CLI arguments
+ */
+export interface ConfigOverrides {
+    configPath?: string;
+    serverUrl?: string;
+    apiToken?: string;
+    projectId?: string;
+    orgId?: string;
+    cacheTtlMinutes?: number;
+}
+/**
+ * Extended result that includes resolved org info
+ */
+export interface LoadConfigResult {
+    config: AceConfig;
+    resolvedOrgId?: string;
+    resolvedOrgName?: string;
+}
+/**
+ * Load configuration with priority:
+ * 1. Override options (from caller)
+ * 2. Environment variables: ACE_CONFIG_PATH, ACE_PROJECT_ID
+ * 3. Config file (autodiscovered via XDG or specified)
+ * 4. Default values (lowest)
+ *
+ * @param overrides - Optional configuration overrides (typically from CLI args)
+ * @param logger - Optional logger for output
+ * @returns Loaded configuration
+ */
+export declare function loadConfig(overrides?: ConfigOverrides, logger?: ILogger): AceConfig;
+/**
+ * Get config file path
+ */
+export declare function getConfigPath(): string;
+/**
+ * Check if configuration is complete
+ */
+export declare function isConfigured(overrides?: ConfigOverrides, logger?: ILogger): boolean;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGlD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,SAAS,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAiED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,SAAS,GAAE,eAAoB,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAmLvF;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,GAAE,eAAoB,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAGvF"}