beercan 0.1.0

package/dist/core/job-queue.js

@@ -0,0 +1,123 @@
+import { v4 as uuid } from "uuid";
+import { getLogger } from "./logger.js";
+export class JobQueue {
+    running = new Map();
+    maxConcurrent;
+    db;
+    executor = null;
+    constructor(db, maxConcurrent) {
+        this.db = db;
+        this.maxConcurrent = maxConcurrent;
+    }
+    /** Set the bloop executor (called after engine is fully initialized) */
+    setExecutor(fn) {
+        this.executor = fn;
+    }
+    /** Enqueue a new job. Returns job ID. */
+    enqueue(opts) {
+        const log = getLogger();
+        const id = uuid();
+        const now = new Date().toISOString();
+        this.db.createJob({
+            id,
+            projectSlug: opts.projectSlug,
+            goal: opts.goal,
+            team: opts.team ?? "auto",
+            priority: opts.priority ?? 0,
+            status: "pending",
+            source: opts.source ?? "manual",
+            sourceId: opts.sourceId ?? null,
+            extraContext: opts.extraContext ?? null,
+            bloopId: null,
+            error: null,
+            createdAt: now,
+            startedAt: null,
+            completedAt: null,
+        });
+        log.info("queue", `Job enqueued: ${opts.goal.slice(0, 60)}`, {
+            jobId: id, projectSlug: opts.projectSlug, source: opts.source ?? "manual", priority: opts.priority ?? 0,
+        });
+        // Try to process immediately
+        this.processNext();
+        return id;
+    }
+    /** Process the next pending job if under concurrency limit. */
+    processNext() {
+        if (!this.executor)
+            return;
+        if (this.running.size >= this.maxConcurrent)
+            return;
+        const job = this.db.claimNextJob();
+        if (!job)
+            return;
+        const log = getLogger();
+        log.info("queue", `Job started: ${job.goal.slice(0, 60)}`, { jobId: job.id, running: this.running.size + 1 });
+        const promise = this.executeJob(job);
+        this.running.set(job.id, promise);
+        promise.finally(() => {
+            this.running.delete(job.id);
+            // Try to process next after completion
+            this.processNext();
+        });
+        // Try to fill more slots
+        if (this.running.size < this.maxConcurrent) {
+            this.processNext();
+        }
+    }
+    async executeJob(job) {
+        const log = getLogger();
+        try {
+            const result = await this.executor({
+                projectSlug: job.projectSlug,
+                goal: job.goal,
+                team: job.team,
+                extraContext: job.extraContext ?? undefined,
+            });
+            this.db.updateJob(job.id, {
+                status: "completed",
+                bloopId: result.id,
+                completedAt: new Date().toISOString(),
+            });
+            log.info("queue", `Job completed: ${job.goal.slice(0, 60)}`, {
+                jobId: job.id, bloopId: result.id, bloopStatus: result.status,
+            });
+        }
+        catch (err) {
+            this.db.updateJob(job.id, {
+                status: "failed",
+                error: err.message,
+                completedAt: new Date().toISOString(),
+            });
+            log.error("queue", `Job failed: ${err.message}`, { jobId: job.id });
+        }
+    }
+    /** Get queue statistics. */
+    getStats() {
+        return this.db.getJobStats();
+    }
+    /** List jobs, optionally filtered by status. */
+    listJobs(status, limit = 20) {
+        return this.db.listJobs(status, limit);
+    }
+    /** Wait for all running AND pending jobs to complete. */
+    async drain() {
+        const log = getLogger();
+        while (true) {
+            if (this.running.size > 0) {
+                log.info("queue", `Draining ${this.running.size} running jobs...`);
+                await Promise.allSettled(Array.from(this.running.values()));
+                continue; // Check again — processNext may have started new jobs
+            }
+            // Check if there are still pending jobs
+            const stats = this.getStats();
+            if (stats.pending > 0 && this.executor) {
+                // Kick processing and wait a tick
+                this.processNext();
+                await new Promise((r) => setTimeout(r, 10));
+                continue;
+            }
+            break;
+        }
+    }
+}
+//# sourceMappingURL=job-queue.js.map

package/dist/core/job-queue.js.map

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

package/dist/core/logger.d.ts

@@ -0,0 +1,22 @@
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    component: string;
+    message: string;
+    data?: Record<string, unknown>;
+}
+export declare class Logger {
+    private level;
+    private fileStream;
+    constructor(level?: LogLevel, logFilePath?: string);
+    private write;
+    debug(component: string, message: string, data?: Record<string, unknown>): void;
+    info(component: string, message: string, data?: Record<string, unknown>): void;
+    warn(component: string, message: string, data?: Record<string, unknown>): void;
+    error(component: string, message: string, data?: Record<string, unknown>): void;
+    close(): void;
+}
+export declare function setGlobalLogger(logger: Logger): void;
+export declare function getLogger(): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAI3D,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,QAAQ,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,UAAU,CAA+B;gBAErC,KAAK,GAAE,QAAiB,EAAE,WAAW,CAAC,EAAE,MAAM;IAU1D,OAAO,CAAC,KAAK;IAwBb,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/E,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9E,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9E,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/E,KAAK,IAAI,IAAI;CAId;AAKD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED,wBAAgB,SAAS,IAAI,MAAM,CAKlC"}

package/dist/core/logger.js

@@ -0,0 +1,65 @@
+import fs from "fs";
+import path from "path";
+const LEVELS = { debug: 0, info: 1, warn: 2, error: 3 };
+export class Logger {
+    level;
+    fileStream = null;
+    constructor(level = "info", logFilePath) {
+        this.level = LEVELS[level];
+        if (logFilePath) {
+            const dir = path.dirname(logFilePath);
+            if (!fs.existsSync(dir))
+                fs.mkdirSync(dir, { recursive: true });
+            this.fileStream = fs.createWriteStream(logFilePath, { flags: "a" });
+        }
+    }
+    write(level, component, message, data) {
+        if (LEVELS[level] < this.level)
+            return;
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            component,
+            message,
+            ...(data && Object.keys(data).length > 0 ? { data } : {}),
+        };
+        const line = JSON.stringify(entry);
+        // Always write to file if available
+        this.fileStream?.write(line + "\n");
+        // Write to stderr for warn/error, stdout for others
+        if (level === "error" || level === "warn") {
+            process.stderr.write(line + "\n");
+        }
+        else if (LEVELS[level] >= this.level) {
+            process.stdout.write(line + "\n");
+        }
+    }
+    debug(component, message, data) {
+        this.write("debug", component, message, data);
+    }
+    info(component, message, data) {
+        this.write("info", component, message, data);
+    }
+    warn(component, message, data) {
+        this.write("warn", component, message, data);
+    }
+    error(component, message, data) {
+        this.write("error", component, message, data);
+    }
+    close() {
+        this.fileStream?.end();
+        this.fileStream = null;
+    }
+}
+/** Global logger instance — set once in BeerCanEngine */
+let _logger = null;
+export function setGlobalLogger(logger) {
+    _logger = logger;
+}
+export function getLogger() {
+    if (!_logger) {
+        _logger = new Logger("info");
+    }
+    return _logger;
+}
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

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

package/dist/core/role-templates.d.ts

@@ -0,0 +1,3 @@
+import type { AgentRole } from "./roles.js";
+export declare const ROLE_TEMPLATES: Record<string, Omit<AgentRole, "id">>;
+//# sourceMappingURL=role-templates.d.ts.map

package/dist/core/role-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-templates.d.ts","sourceRoot":"","sources":["../../src/core/role-templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAO5C,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAqLhE,CAAC"}

package/dist/core/role-templates.js

@@ -0,0 +1,179 @@
+// ── Dynamic Role Templates ──────────────────────────────────
+// Extend beyond the 5 built-in coding-focused roles.
+// Used as defaults by the Gatekeeper when composing dynamic teams.
+// The gatekeeper can override any field.
+export const ROLE_TEMPLATES = {
+    writer: {
+        name: "Writer",
+        description: "Writes prose, documentation, blog posts, reports, and other textual content.",
+        systemPrompt: `You are the Writer agent in the BeerCan system. Your responsibilities:
+
+1. Write clear, engaging, well-structured content based on the plan and research provided.
+2. Follow any style guidelines or tone requirements specified.
+3. Use read_file to reference existing content for consistency.
+4. Save your output using write_file.
+
+Rules:
+- Write in clear, professional prose unless a different tone is specified.
+- Structure content with headings, bullet points, and paragraphs as appropriate.
+- Cite sources and reference specific details from research.
+- If the task is documentation, follow the project's existing doc conventions.
+- Save your work to a file so reviewers can read it.`,
+        allowedTools: ["read_file", "write_file", "list_directory", "memory_search", "memory_store", "memory_scratch"],
+        phase: "primary",
+        maxIterations: 15,
+    },
+    researcher: {
+        name: "Researcher",
+        description: "Gathers information from files, memory, and project context to inform other agents.",
+        systemPrompt: `You are the Researcher agent in the BeerCan system. Your responsibilities:
+
+1. Gather relevant information from the project files, memory, and knowledge graph.
+2. Synthesize findings into a clear, organized research brief.
+3. Identify key facts, patterns, and context that other agents will need.
+4. Store important findings in memory for future reference.
+
+Process:
+1. Read the goal carefully and identify what information is needed.
+2. Search memory for relevant past knowledge.
+3. Browse project files for relevant content.
+4. Produce a structured summary of your findings.
+
+Be thorough but concise. Focus on information that directly supports the goal.`,
+        allowedTools: ["read_file", "list_directory", "exec_command", "memory_search", "memory_query_graph", "memory_store", "memory_link", "memory_scratch"],
+        phase: "plan",
+        maxIterations: 15,
+    },
+    analyst: {
+        name: "Analyst",
+        description: "Analyzes data, code patterns, logs, or metrics and produces structured insights.",
+        systemPrompt: `You are the Analyst agent in the BeerCan system. Your responsibilities:
+
+1. Analyze the data, code, logs, or information provided or accessible in the project.
+2. Identify patterns, anomalies, trends, and actionable insights.
+3. Produce a structured analysis report with clear conclusions.
+4. Store key insights in memory for future loops.
+
+Rules:
+- Use exec_command to run analysis scripts if available.
+- Be data-driven — cite specific numbers, files, and evidence.
+- Distinguish between facts and interpretations.
+- Prioritize actionable findings over exhaustive description.`,
+        allowedTools: ["read_file", "list_directory", "exec_command", "memory_search", "memory_store", "memory_link", "memory_scratch"],
+        phase: "primary",
+        maxIterations: 15,
+    },
+    data_processor: {
+        name: "Data Processor",
+        description: "Transforms, cleans, parses, or migrates data between formats.",
+        systemPrompt: `You are the Data Processor agent in the BeerCan system. Your responsibilities:
+
+1. Read input data from files or command output.
+2. Transform, clean, or convert data as specified by the goal.
+3. Write processed output to the appropriate location.
+4. Verify the output is correct and complete.
+
+Rules:
+- Handle edge cases (empty data, malformed input, encoding issues).
+- Preserve data integrity — never silently drop records.
+- Log processing statistics (records processed, errors, etc.).
+- Use exec_command for batch operations when appropriate.`,
+        allowedTools: ["read_file", "write_file", "list_directory", "exec_command", "memory_search", "memory_scratch"],
+        phase: "primary",
+        maxIterations: 20,
+    },
+    summarizer: {
+        name: "Summarizer",
+        description: "Condenses large amounts of information into clear, concise summaries.",
+        systemPrompt: `You are the Summarizer agent in the BeerCan system. Your responsibilities:
+
+1. Read and comprehend the full body of content provided or accessible.
+2. Produce a concise, accurate summary that captures the essential points.
+3. Organize the summary with clear structure (executive summary, key points, details).
+
+Rules:
+- Preserve critical details — don't over-simplify.
+- Maintain accuracy — never introduce information not in the source.
+- Scale summary length to content complexity.
+- Highlight any areas of uncertainty or incompleteness.`,
+        allowedTools: ["read_file", "list_directory", "memory_search", "memory_query_graph", "memory_scratch"],
+        phase: "summarize",
+        maxIterations: 5,
+    },
+    planner: {
+        name: "Planner",
+        description: "Creates detailed execution plans and task breakdowns without doing the work itself.",
+        systemPrompt: `You are the Planner agent in the BeerCan system. Your responsibilities:
+
+1. Analyze the goal and break it into concrete, actionable sub-tasks.
+2. Identify dependencies between tasks and determine the optimal order.
+3. Specify acceptance criteria for each task.
+4. Estimate complexity and flag potential risks.
+
+Rules:
+- Be specific — "Add validation to the /users endpoint" not "Add validation".
+- Consider edge cases and error handling in your plan.
+- Reference existing code patterns when suggesting implementation approaches.
+- Use memory to check for similar past tasks and their outcomes.`,
+        allowedTools: ["read_file", "list_directory", "memory_search", "memory_query_graph", "memory_scratch"],
+        phase: "plan",
+        maxIterations: 10,
+    },
+    editor: {
+        name: "Editor",
+        description: "Reviews and improves written content for clarity, grammar, style, and consistency.",
+        systemPrompt: `You are the Editor agent in the BeerCan system. Your responsibilities:
+
+1. Review the written content produced by other agents.
+2. Check for: grammar, clarity, consistency, tone, structure, accuracy.
+3. Suggest specific improvements with concrete rewrites.
+
+If the content is publication-ready: respond with <decision>APPROVE</decision>
+If edits are needed: respond with <decision>REVISE</decision> and list specific changes
+If fundamentally off-track: respond with <decision>REJECT</decision> and explain why
+
+Be constructive. Focus on substantive improvements, not minor stylistic preferences.`,
+        allowedTools: ["read_file", "list_directory", "memory_search"],
+        phase: "review",
+        maxIterations: 5,
+    },
+    devops: {
+        name: "DevOps",
+        description: "Handles deployment, infrastructure, CI/CD, and operational tasks.",
+        systemPrompt: `You are the DevOps agent in the BeerCan system. Your responsibilities:
+
+1. Execute deployment, build, and infrastructure operations.
+2. Run and verify CI/CD pipelines and scripts.
+3. Check system health, logs, and configurations.
+4. Troubleshoot operational issues.
+
+Rules:
+- Always verify changes before and after applying them.
+- Check for existing configuration before creating new ones.
+- Use exec_command carefully — prefer read-only checks first.
+- Store operational decisions in memory for future reference.`,
+        allowedTools: ["read_file", "write_file", "list_directory", "exec_command", "memory_search", "memory_store", "memory_scratch"],
+        phase: "primary",
+        maxIterations: 20,
+    },
+    architect: {
+        name: "Architect",
+        description: "Designs system architecture, evaluates trade-offs, and creates technical plans.",
+        systemPrompt: `You are the Architect agent in the BeerCan system. Your responsibilities:
+
+1. Analyze the existing system architecture by reading code and documentation.
+2. Design solutions that fit the existing patterns and conventions.
+3. Evaluate trade-offs (performance, maintainability, complexity).
+4. Produce clear technical plans that coders can follow.
+
+Rules:
+- Read existing code before proposing new patterns.
+- Favor incremental improvement over wholesale redesign.
+- Consider backward compatibility and migration paths.
+- Document architectural decisions in memory.`,
+        allowedTools: ["read_file", "list_directory", "memory_search", "memory_query_graph", "memory_store", "memory_link", "memory_scratch"],
+        phase: "plan",
+        maxIterations: 10,
+    },
+};
+//# sourceMappingURL=role-templates.js.map

package/dist/core/role-templates.js.map

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

package/dist/core/roles.d.ts

@@ -0,0 +1,94 @@
+import { z } from "zod";
+export declare const AgentRoleSchema: z.ZodObject<{
+    /** Unique role identifier, e.g. "coder", "reviewer", "manager" */
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    /** System prompt injected when this agent is active */
+    systemPrompt: z.ZodString;
+    /** Which tools this role is allowed to use. ["*"] = all project tools */
+    allowedTools: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Model override — some roles need heavier reasoning */
+    model: z.ZodOptional<z.ZodString>;
+    /** Temperature override */
+    temperature: z.ZodOptional<z.ZodNumber>;
+    /**
+     * When does this agent get invoked in a bloop?
+     * - "primary"   → runs the main bloop cycle
+     * - "review"    → called after primary produces output
+     * - "validate"  → called after review to verify / run tests
+     * - "plan"      → called at the start to break down the goal
+     * - "summarize" → called at the end to produce final output
+     */
+    phase: z.ZodDefault<z.ZodEnum<["plan", "primary", "review", "validate", "summarize"]>>;
+    /** Max iterations this specific agent can run within its phase */
+    maxIterations: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    systemPrompt: string;
+    maxIterations: number;
+    name: string;
+    description: string;
+    allowedTools: string[];
+    phase: "plan" | "primary" | "review" | "validate" | "summarize";
+    model?: string | undefined;
+    temperature?: number | undefined;
+}, {
+    id: string;
+    systemPrompt: string;
+    name: string;
+    description: string;
+    maxIterations?: number | undefined;
+    allowedTools?: string[] | undefined;
+    model?: string | undefined;
+    temperature?: number | undefined;
+    phase?: "plan" | "primary" | "review" | "validate" | "summarize" | undefined;
+}>;
+export type AgentRole = z.infer<typeof AgentRoleSchema>;
+export declare const BloopTeamSchema: z.ZodObject<{
+    /**
+     * Pipeline defines execution order.
+     * Each stage runs its assigned agent(s) before moving to the next.
+     * A stage can have multiple agents (they see each other's output).
+     */
+    pipeline: z.ZodArray<z.ZodObject<{
+        phase: z.ZodEnum<["plan", "primary", "review", "validate", "summarize"]>;
+        roleId: z.ZodString;
+        /** If true, this phase can send work back to a previous phase */
+        canReject: z.ZodOptional<z.ZodBoolean>;
+        /** Phase to return to on rejection */
+        rejectTo: z.ZodOptional<z.ZodEnum<["plan", "primary", "review", "validate", "summarize"]>>;
+    }, "strip", z.ZodTypeAny, {
+        phase: "plan" | "primary" | "review" | "validate" | "summarize";
+        roleId: string;
+        canReject?: boolean | undefined;
+        rejectTo?: "plan" | "primary" | "review" | "validate" | "summarize" | undefined;
+    }, {
+        phase: "plan" | "primary" | "review" | "validate" | "summarize";
+        roleId: string;
+        canReject?: boolean | undefined;
+        rejectTo?: "plan" | "primary" | "review" | "validate" | "summarize" | undefined;
+    }>, "many">;
+    /** Max full pipeline cycles (plan→primary→review→validate) before forced completion */
+    maxCycles: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    pipeline: {
+        phase: "plan" | "primary" | "review" | "validate" | "summarize";
+        roleId: string;
+        canReject?: boolean | undefined;
+        rejectTo?: "plan" | "primary" | "review" | "validate" | "summarize" | undefined;
+    }[];
+    maxCycles: number;
+}, {
+    pipeline: {
+        phase: "plan" | "primary" | "review" | "validate" | "summarize";
+        roleId: string;
+        canReject?: boolean | undefined;
+        rejectTo?: "plan" | "primary" | "review" | "validate" | "summarize" | undefined;
+    }[];
+    maxCycles?: number | undefined;
+}>;
+export type BloopTeam = z.infer<typeof BloopTeamSchema>;
+export declare const BUILTIN_ROLES: Record<string, AgentRole>;
+export declare const PRESET_TEAMS: Record<string, BloopTeam>;
+//# sourceMappingURL=roles.d.ts.map

package/dist/core/roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.d.ts","sourceRoot":"","sources":["../../src/core/roles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,eAAe;IAC1B,kEAAkE;;;;IAIlE,uDAAuD;;IAEvD,yEAAyE;;IAEzE,yDAAyD;;IAEzD,2BAA2B;;IAE3B;;;;;;;OAOG;;IAEH,kEAAkE;;;;;;;;;;;;;;;;;;;;;;EAElE,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAKxD,eAAO,MAAM,eAAe;IAC1B;;;;OAIG;;;;QAKC,iEAAiE;;QAEjE,sCAAsC;;;;;;;;;;;;;IAI1C,uFAAuF;;;;;;;;;;;;;;;;;;EAEvF,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIxD,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CA4HnD,CAAC;AAIF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAsClD,CAAC"}