@shuyhere/takotako 0.0.1

package/dist/core/context.js

@@ -0,0 +1,65 @@
+/**
+ * Context manager — assembles and manages the context window.
+ *
+ * Tracks token usage, decides when to compact, and ensures
+ * the context fits within the model's limits.
+ */
+import { SessionPruner } from './pruning.js';
+const DEFAULT_CONTEXT_CONFIG = {
+    maxTokens: 200_000,
+    reservedForResponse: 8_192,
+    compactionThreshold: 0.80, // lowered from 0.70 — pruning handles 60-80%
+};
+export class ContextManager {
+    config;
+    pruner;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONTEXT_CONFIG, ...config };
+        this.pruner = new SessionPruner(this.config.pruning);
+    }
+    /**
+     * Estimate token count for a message array.
+     * Uses rough heuristic: ~4 chars per token.
+     */
+    estimateTokens(messages) {
+        // TODO: Use a proper tokenizer (tiktoken or similar)
+        let chars = 0;
+        for (const msg of messages) {
+            if (typeof msg.content === 'string') {
+                chars += msg.content.length;
+            }
+            else {
+                for (const part of msg.content) {
+                    if (part.type === 'text')
+                        chars += part.text.length;
+                }
+            }
+        }
+        return Math.ceil(chars / 4);
+    }
+    /**
+     * Check if the context needs compaction.
+     * Runs pruning first — only triggers compaction if pruning wasn't enough.
+     */
+    needsCompaction(messages) {
+        const tokens = this.estimateTokens(messages);
+        const threshold = this.config.maxTokens * this.config.compactionThreshold;
+        return tokens > threshold;
+    }
+    /**
+     * Prune messages before compaction check.
+     * Returns pruned messages and estimated token savings.
+     */
+    pruneMessages(messages) {
+        const contextUsage = this.estimateTokens(messages) / this.config.maxTokens;
+        const pruned = this.pruner.prune(messages, contextUsage);
+        const tokensSaved = this.pruner.estimateSavings(messages, pruned);
+        return { messages: pruned, tokensSaved };
+    }
+    /** Available tokens for the response. */
+    availableTokens(messages) {
+        const used = this.estimateTokens(messages);
+        return Math.max(0, this.config.maxTokens - used - this.config.reservedForResponse);
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/core/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,aAAa,EAAsB,MAAM,cAAc,CAAC;AAajE,MAAM,sBAAsB,GAAkB;IAC5C,SAAS,EAAE,OAAO;IAClB,mBAAmB,EAAE,KAAK;IAC1B,mBAAmB,EAAE,IAAI,EAAE,6CAA6C;CACzE,CAAC;AAEF,MAAM,OAAO,cAAc;IACjB,MAAM,CAAgB;IACtB,MAAM,CAAgB;IAE9B,YAAY,MAA+B;QACzC,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,sBAAsB,EAAE,GAAG,MAAM,EAAE,CAAC;QACvD,IAAI,CAAC,MAAM,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvD,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,QAAuB;QACpC,qDAAqD;QACrD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACpC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACN,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;oBAC/B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;wBAAE,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;gBACtD,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,QAAuB;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC;QAC1E,OAAO,MAAM,GAAG,SAAS,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,QAAuB;QACnC,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;QAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QACzD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAC3C,CAAC;IAED,yCAAyC;IACzC,eAAe,CAAC,QAAuB;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACrF,CAAC;CACF"}

package/dist/core/cron.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Minimal cron scheduler for Tako.
+ *
+ * Design: thin JSON file + setInterval evaluator.
+ * No dependencies beyond Node stdlib.
+ *
+ * Jobs persist at ~/.tako/cron/jobs.json.
+ * Each tick checks which jobs are due and runs them.
+ *
+ * Two execution modes:
+ *   - "system-event": inject text into the main session (processed on next agent turn)
+ *   - "agent-turn":   run a dedicated agent turn in an isolated session
+ *
+ * Three schedule types:
+ *   - "at":    one-shot at ISO timestamp
+ *   - "every": recurring interval (ms)
+ *   - "cron":  cron expression (minute hour dom month dow)
+ */
+export interface CronJob {
+    id: string;
+    name: string;
+    enabled: boolean;
+    schedule: CronSchedule;
+    payload: CronPayload;
+    delivery?: CronDelivery;
+    createdAt: string;
+    lastRunAt?: string;
+    runCount: number;
+    /** Delete after successful run (for one-shot jobs). */
+    deleteAfterRun?: boolean;
+}
+export type CronSchedule = {
+    kind: 'at';
+    at: string;
+} | {
+    kind: 'every';
+    everyMs: number;
+} | {
+    kind: 'cron';
+    expr: string;
+    tz?: string;
+};
+export type CronPayload = {
+    kind: 'system-event';
+    text: string;
+} | {
+    kind: 'agent-turn';
+    message: string;
+    model?: string;
+};
+export interface CronDelivery {
+    mode: 'none' | 'announce';
+    channel?: string;
+    to?: string;
+}
+export interface CronRunResult {
+    jobId: string;
+    jobName: string;
+    startedAt: string;
+    finishedAt: string;
+    response: string;
+    delivered: boolean;
+}
+export type AgentTurnRunner = (message: string, model?: string) => Promise<string>;
+export type SystemEventHandler = (text: string) => void;
+export type DeliveryHandler = (result: CronRunResult, delivery: CronDelivery) => void;
+export declare class CronScheduler {
+    private jobs;
+    private timer;
+    private jobsPath;
+    private runLogPath;
+    private agentTurnRunner;
+    private systemEventHandler;
+    private deliveryHandler;
+    private tickIntervalMs;
+    constructor(dir?: string);
+    /** Wire handlers. */
+    setHandlers(opts: {
+        agentTurn?: AgentTurnRunner;
+        systemEvent?: SystemEventHandler;
+        delivery?: DeliveryHandler;
+    }): void;
+    /** Load jobs from disk and start the tick loop. */
+    start(): Promise<void>;
+    /** Stop the tick loop. */
+    stop(): void;
+    /** Add a new job. Returns the job. */
+    add(opts: Omit<CronJob, 'id' | 'createdAt' | 'runCount'>): Promise<CronJob>;
+    /** Remove a job by ID. */
+    remove(id: string): Promise<boolean>;
+    /** Update a job. */
+    update(id: string, patch: Partial<CronJob>): Promise<CronJob | null>;
+    /** List all jobs. */
+    list(includeDisabled?: boolean): CronJob[];
+    /** Get a specific job. */
+    get(id: string): CronJob | null;
+    /** Run a job immediately (bypass schedule). */
+    run(id: string): Promise<CronRunResult | null>;
+    private tick;
+    /** Check if a job is due to run. */
+    private isDue;
+    /** Execute a job. */
+    private executeJob;
+    /** Get run history for a specific job or all jobs. */
+    getRunHistory(jobId?: string, limit?: number): Promise<CronRunResult[]>;
+    /** Save a run result to disk. */
+    private saveRunResult;
+    private load;
+    private save;
+}
+//# sourceMappingURL=cron.d.ts.map

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

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

package/dist/core/cron.js

@@ -0,0 +1,284 @@
+/**
+ * Minimal cron scheduler for Tako.
+ *
+ * Design: thin JSON file + setInterval evaluator.
+ * No dependencies beyond Node stdlib.
+ *
+ * Jobs persist at ~/.tako/cron/jobs.json.
+ * Each tick checks which jobs are due and runs them.
+ *
+ * Two execution modes:
+ *   - "system-event": inject text into the main session (processed on next agent turn)
+ *   - "agent-turn":   run a dedicated agent turn in an isolated session
+ *
+ * Three schedule types:
+ *   - "at":    one-shot at ISO timestamp
+ *   - "every": recurring interval (ms)
+ *   - "cron":  cron expression (minute hour dom month dow)
+ */
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { randomUUID } from 'node:crypto';
+// ─── Cron expression matcher ────────────────────────────────────────
+/** Match a cron expression (min hour dom month dow) against a Date. */
+function matchesCron(expr, date, tz) {
+    const d = tz ? new Date(date.toLocaleString('en-US', { timeZone: tz })) : date;
+    const parts = expr.trim().split(/\s+/);
+    if (parts.length !== 5)
+        return false;
+    const fields = [d.getMinutes(), d.getHours(), d.getDate(), d.getMonth() + 1, d.getDay()];
+    return parts.every((part, i) => matchField(part, fields[i]));
+}
+function matchField(pattern, value) {
+    if (pattern === '*')
+        return true;
+    for (const segment of pattern.split(',')) {
+        // Range: 1-5
+        if (segment.includes('-')) {
+            const [lo, hi] = segment.split('-').map(Number);
+            if (value >= lo && value <= hi)
+                return true;
+            continue;
+        }
+        // Step: */5
+        if (segment.includes('/')) {
+            const [base, step] = segment.split('/');
+            const s = Number(step);
+            if (base === '*' && value % s === 0)
+                return true;
+            continue;
+        }
+        // Exact
+        if (Number(segment) === value)
+            return true;
+    }
+    return false;
+}
+export class CronScheduler {
+    jobs = [];
+    timer = null;
+    jobsPath;
+    runLogPath;
+    agentTurnRunner = null;
+    systemEventHandler = null;
+    deliveryHandler = null;
+    tickIntervalMs = 60_000; // check every minute
+    constructor(dir) {
+        const base = dir ?? join(homedir(), '.tako', 'cron');
+        this.jobsPath = join(base, 'jobs.json');
+        this.runLogPath = join(base, 'runs');
+    }
+    /** Wire handlers. */
+    setHandlers(opts) {
+        if (opts.agentTurn)
+            this.agentTurnRunner = opts.agentTurn;
+        if (opts.systemEvent)
+            this.systemEventHandler = opts.systemEvent;
+        if (opts.delivery)
+            this.deliveryHandler = opts.delivery;
+    }
+    /** Load jobs from disk and start the tick loop. */
+    async start() {
+        await this.load();
+        this.timer = setInterval(() => this.tick(), this.tickIntervalMs);
+        const active = this.jobs.filter((j) => j.enabled).length;
+        if (active > 0) {
+            console.log(`[cron] Started — ${active} active job${active !== 1 ? 's' : ''}`);
+        }
+    }
+    /** Stop the tick loop. */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    // ─── CRUD ───────────────────────────────────────────────────────
+    /** Add a new job. Returns the job. */
+    async add(opts) {
+        const job = {
+            ...opts,
+            id: randomUUID().slice(0, 8),
+            createdAt: new Date().toISOString(),
+            runCount: 0,
+        };
+        this.jobs.push(job);
+        await this.save();
+        return job;
+    }
+    /** Remove a job by ID. */
+    async remove(id) {
+        const before = this.jobs.length;
+        this.jobs = this.jobs.filter((j) => j.id !== id);
+        if (this.jobs.length < before) {
+            await this.save();
+            return true;
+        }
+        return false;
+    }
+    /** Update a job. */
+    async update(id, patch) {
+        const job = this.jobs.find((j) => j.id === id);
+        if (!job)
+            return null;
+        Object.assign(job, patch, { id: job.id }); // never overwrite id
+        await this.save();
+        return job;
+    }
+    /** List all jobs. */
+    list(includeDisabled = false) {
+        return includeDisabled ? [...this.jobs] : this.jobs.filter((j) => j.enabled);
+    }
+    /** Get a specific job. */
+    get(id) {
+        return this.jobs.find((j) => j.id === id) ?? null;
+    }
+    /** Run a job immediately (bypass schedule). */
+    async run(id) {
+        const job = this.jobs.find((j) => j.id === id);
+        if (!job)
+            return null;
+        return this.executeJob(job);
+    }
+    // ─── Tick ───────────────────────────────────────────────────────
+    async tick() {
+        const now = new Date();
+        for (const job of this.jobs) {
+            if (!job.enabled)
+                continue;
+            if (!this.isDue(job, now))
+                continue;
+            try {
+                await this.executeJob(job);
+            }
+            catch (err) {
+                console.error(`[cron] Job ${job.id} (${job.name}) failed:`, err instanceof Error ? err.message : err);
+            }
+        }
+    }
+    /** Check if a job is due to run. */
+    isDue(job, now) {
+        const sched = job.schedule;
+        switch (sched.kind) {
+            case 'at': {
+                const target = new Date(sched.at);
+                // Due if target is in the past and hasn't run yet
+                return now >= target && job.runCount === 0;
+            }
+            case 'every': {
+                if (!job.lastRunAt)
+                    return true;
+                const elapsed = now.getTime() - new Date(job.lastRunAt).getTime();
+                return elapsed >= sched.everyMs;
+            }
+            case 'cron': {
+                // Only match on the current minute (avoid double-fire)
+                if (job.lastRunAt) {
+                    const lastRun = new Date(job.lastRunAt);
+                    const sameMinute = lastRun.getFullYear() === now.getFullYear() &&
+                        lastRun.getMonth() === now.getMonth() &&
+                        lastRun.getDate() === now.getDate() &&
+                        lastRun.getHours() === now.getHours() &&
+                        lastRun.getMinutes() === now.getMinutes();
+                    if (sameMinute)
+                        return false;
+                }
+                return matchesCron(sched.expr, now, sched.tz);
+            }
+        }
+    }
+    /** Execute a job. */
+    async executeJob(job) {
+        const startedAt = new Date().toISOString();
+        let response = '';
+        if (job.payload.kind === 'system-event') {
+            this.systemEventHandler?.(job.payload.text);
+            response = '[system event injected]';
+        }
+        else if (job.payload.kind === 'agent-turn') {
+            if (this.agentTurnRunner) {
+                response = await this.agentTurnRunner(job.payload.message, job.payload.model);
+            }
+            else {
+                response = '[no agent runner configured]';
+            }
+        }
+        const result = {
+            jobId: job.id,
+            jobName: job.name,
+            startedAt,
+            finishedAt: new Date().toISOString(),
+            response,
+            delivered: false,
+        };
+        // Update job state
+        job.lastRunAt = result.finishedAt;
+        job.runCount++;
+        // Deliver
+        if (job.delivery && job.delivery.mode !== 'none' && this.deliveryHandler) {
+            this.deliveryHandler(result, job.delivery);
+            result.delivered = true;
+        }
+        // Persist run result to disk
+        await this.saveRunResult(result);
+        // One-shot cleanup
+        if (job.deleteAfterRun) {
+            this.jobs = this.jobs.filter((j) => j.id !== job.id);
+        }
+        await this.save();
+        return result;
+    }
+    /** Get run history for a specific job or all jobs. */
+    async getRunHistory(jobId, limit = 50) {
+        const { readdir } = await import('node:fs/promises');
+        const results = [];
+        try {
+            await mkdir(this.runLogPath, { recursive: true });
+            const files = await readdir(this.runLogPath);
+            const jsonFiles = files.filter((f) => f.endsWith('.json')).sort().slice(-limit * 2);
+            for (const file of jsonFiles) {
+                try {
+                    const raw = await readFile(join(this.runLogPath, file), 'utf-8');
+                    const run = JSON.parse(raw);
+                    if (!jobId || run.jobId === jobId) {
+                        results.push(run);
+                    }
+                }
+                catch {
+                    // skip corrupt files
+                }
+            }
+        }
+        catch {
+            // runs dir doesn't exist yet
+        }
+        return results.slice(-limit);
+    }
+    // ─── Persistence ────────────────────────────────────────────────
+    /** Save a run result to disk. */
+    async saveRunResult(result) {
+        try {
+            await mkdir(this.runLogPath, { recursive: true });
+            const filename = `${result.startedAt.replace(/[:.]/g, '-')}_${result.jobId}.json`;
+            await writeFile(join(this.runLogPath, filename), JSON.stringify(result, null, 2), 'utf-8');
+        }
+        catch (err) {
+            console.error(`[cron] Failed to save run result: ${err}`);
+        }
+    }
+    async load() {
+        try {
+            const data = await readFile(this.jobsPath, 'utf-8');
+            this.jobs = JSON.parse(data);
+        }
+        catch {
+            this.jobs = [];
+        }
+    }
+    async save() {
+        await mkdir(join(this.jobsPath, '..'), { recursive: true });
+        await writeFile(this.jobsPath, JSON.stringify(this.jobs, null, 2));
+    }
+}
+//# sourceMappingURL=cron.js.map

package/dist/core/cron.js.map

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

package/dist/core/exec-approvals.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Exec approval system — require user confirmation for dangerous commands.
+ *
+ * Classifies commands by risk level and routes high-risk ones through
+ * an approval flow before execution.
+ */
+export interface ApprovalConfig {
+    /** Approval mode: 'off' | 'ask' | 'allowlist' | 'full' */
+    mode: 'off' | 'ask' | 'allowlist' | 'full';
+    /** Commands that always need approval */
+    alwaysAsk: string[];
+    /** Commands that are pre-approved (allowlist mode) */
+    allowed: string[];
+    /** Commands that are always blocked */
+    blocked: string[];
+    /** Timeout for approval request in ms (default: 60000) */
+    timeoutMs: number;
+    /** Auto-approve after N identical approvals in same session */
+    autoApproveAfter?: number;
+}
+export type RiskLevel = 'safe' | 'moderate' | 'dangerous' | 'blocked';
+export interface ApprovalRequest {
+    id: string;
+    command: string;
+    riskLevel: RiskLevel;
+    reason: string;
+    sessionId: string;
+    timestamp: number;
+    status: 'pending' | 'approved' | 'denied' | 'timeout';
+}
+export declare class ExecApprovalManager {
+    private config;
+    private pending;
+    private sessionApprovals;
+    constructor(config?: Partial<ApprovalConfig>);
+    /** Check if a command needs approval. Returns null if auto-approved. */
+    checkCommand(command: string, sessionId: string): ApprovalRequest | null;
+    /** Classify command risk level. */
+    classifyRisk(command: string): {
+        level: RiskLevel;
+        reason: string;
+    };
+    /** Resolve a pending approval. */
+    resolve(requestId: string, decision: 'approved' | 'denied'): void;
+    /** Get pending approval for a session. */
+    getPending(sessionId: string): ApprovalRequest | undefined;
+    /** Format approval request as a user-facing message. */
+    formatRequest(req: ApprovalRequest): string;
+}
+//# sourceMappingURL=exec-approvals.d.ts.map

package/dist/core/exec-approvals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-approvals.d.ts","sourceRoot":"","sources":["../../src/core/exec-approvals.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,WAAW,GAAG,MAAM,CAAC;IAC3C,yCAAyC;IACzC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,sDAAsD;IACtD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,uCAAuC;IACvC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;AAEtE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;CACvD;AA2CD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,gBAAgB,CAAmC;gBAE/C,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAM5C,wEAAwE;IACxE,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAoExE,mCAAmC;IACnC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,SAAS,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAwCnE,kCAAkC;IAClC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,QAAQ,GAAG,IAAI;IAkBjE,0CAA0C;IAC1C,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAS1D,wDAAwD;IACxD,aAAa,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM;CAc5C"}