longer-agent 0.1.0

package/dist/show-context.js

@@ -0,0 +1,320 @@
+/**
+ * show_context tool implementation.
+ *
+ * Generates two outputs:
+ * 1. Context Map — compact index for the tool_result (all groups, total tokens, types)
+ * 2. Injection annotations — detailed per-entry descriptions for each §{id}§ injection point
+ *
+ * Uses a shared GPT tokenizer estimator for relative size hints.
+ */
+import { encode as gptEncode } from "gpt-tokenizer/model/gpt-5";
+// ------------------------------------------------------------------
+// Token display helpers
+// ------------------------------------------------------------------
+function formatTokens(tokens) {
+    if (tokens < 1000)
+        return "<1k";
+    return `${Math.round(tokens / 1000)}k`;
+}
+// ------------------------------------------------------------------
+// Entry content serialization for token estimation
+// ------------------------------------------------------------------
+function estimateEntryTokens(entry) {
+    let text;
+    switch (entry.type) {
+        case "user_message":
+        case "assistant_text":
+        case "no_reply":
+        case "compact_context":
+        case "summary":
+            text = serializeContent(entry.content);
+            break;
+        case "reasoning":
+            text = serializeContent(entry.content);
+            break;
+        case "tool_call":
+            text = JSON.stringify(entry.content ?? {});
+            break;
+        case "tool_result": {
+            const rc = entry.content;
+            text = rc?.content ?? JSON.stringify(entry.content ?? {});
+            break;
+        }
+        default:
+            text = serializeContent(entry.content);
+            break;
+    }
+    return gptEncode(text).length;
+}
+function serializeContent(content) {
+    if (typeof content === "string")
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .map((block) => {
+            if (block?.type === "text")
+                return String(block.text ?? "");
+            if (block?.type === "image" || block?.type === "image_ref")
+                return "[image]";
+            return JSON.stringify(block);
+        })
+            .join("\n");
+    }
+    if (content === null || content === undefined)
+        return "";
+    return JSON.stringify(content);
+}
+// ------------------------------------------------------------------
+// Entry description generation
+// ------------------------------------------------------------------
+function truncateText(text, maxLen = 50) {
+    const clean = text.replace(/\n/g, " ").trim();
+    if (clean.length <= maxLen)
+        return `"${clean}"`;
+    return `"${clean.slice(0, maxLen)}..."`;
+}
+function describeEntry(entry) {
+    switch (entry.type) {
+        case "user_message": {
+            const text = serializeContent(entry.content);
+            const hasImage = Array.isArray(entry.content) &&
+                entry.content.some((b) => b?.type === "image" || b?.type === "image_ref");
+            const prefix = hasImage ? "[image] " : "";
+            return { label: "user", description: `${prefix}${truncateText(text)}` };
+        }
+        case "assistant_text":
+            return { label: "assistant", description: truncateText(String(entry.content ?? "")) };
+        case "reasoning":
+            return { label: "thinking", description: "[internal reasoning]" };
+        case "tool_call": {
+            const tc = entry.content;
+            const name = tc?.name ?? entry.meta["toolName"] ?? "unknown";
+            const args = tc?.arguments ?? {};
+            const brief = formatToolCallArgs(String(name), args);
+            return { label: "call", description: `${name}(${brief})` };
+        }
+        case "tool_result": {
+            const toolName = String(entry.meta["toolName"] ?? "unknown");
+            const isError = entry.meta["isError"] === true;
+            const rc = entry.content;
+            const resultStr = rc?.content ?? "";
+            const brief = isError
+                ? `ERROR: ${resultStr.slice(0, 60).replace(/\n/g, " ")}`
+                : formatToolResultBrief(toolName, resultStr, entry.meta);
+            return { label: "result", description: `${toolName} → ${brief}` };
+        }
+        case "no_reply":
+            return { label: "no-reply", description: "" };
+        case "summary": {
+            const depth = entry.meta["summaryDepth"] ?? 1;
+            return { label: "summary", description: `(depth ${depth}) ${truncateText(String(entry.content ?? ""))}` };
+        }
+        case "compact_context":
+            return { label: "compact", description: "Auto-compact summary" };
+        default:
+            return { label: entry.type, description: truncateText(serializeContent(entry.content)) };
+    }
+}
+function formatToolCallArgs(toolName, args) {
+    // Known tools: show the most important arg
+    switch (toolName) {
+        case "read_file": {
+            const path = String(args["path"] ?? args["file"] ?? "");
+            const parts = [path ? `"${path}"` : ""];
+            if (args["start_line"] !== undefined)
+                parts.push(`${args["start_line"]}–${args["end_line"] ?? "end"}`);
+            return parts.filter(Boolean).join(", ");
+        }
+        case "edit_file":
+        case "write_file":
+            return `"${String(args["path"] ?? args["file"] ?? "")}", ...`;
+        case "bash":
+        case "bash_background":
+            return truncateText(String(args["command"] ?? ""), 40).slice(1, -1); // remove quotes from truncateText
+        case "grep":
+            return `"${String(args["pattern"] ?? "")}", path="${String(args["path"] ?? "")}"`;
+        case "glob":
+            return `"${String(args["pattern"] ?? "")}"`;
+        case "spawn_agent":
+            return `"${String(args["file"] ?? "")}"`;
+        case "ask": {
+            const qs = args["questions"];
+            if (qs?.length)
+                return truncateText(String(qs[0]?.question ?? ""), 30).slice(1, -1);
+            return "...";
+        }
+        case "summarize_context": {
+            const ops = args["operations"];
+            return `${ops?.length ?? 0} operations`;
+        }
+        default:
+            // Generic fallback
+            if (Object.keys(args).length === 0)
+                return "";
+            return "...";
+    }
+}
+function formatToolResultBrief(toolName, resultStr, meta) {
+    switch (toolName) {
+        case "read_file":
+            return `${resultStr.length} chars`;
+        case "edit_file":
+            return resultStr.includes("applied") || resultStr.includes("OK") ? "applied" : `${resultStr.length} chars`;
+        case "write_file":
+            return "created";
+        case "bash":
+        case "bash_background": {
+            // Try to extract exit code
+            const exitMatch = resultStr.match(/exit (?:code |status )?(\d+)/i);
+            const exitCode = exitMatch ? exitMatch[1] : null;
+            const size = formatTokens(gptEncode(resultStr).length);
+            return exitCode !== null ? `exit ${exitCode}, ${size} output` : `${size} output`;
+        }
+        case "grep": {
+            const lineCount = resultStr.split("\n").filter(Boolean).length;
+            return `${lineCount} matches`;
+        }
+        case "ask": {
+            const brief = resultStr.replace(/\n/g, " ").trim();
+            return brief.length > 40 ? `${brief.slice(0, 40)}...` : brief;
+        }
+        default:
+            // Generic fallback
+            return `${formatTokens(gptEncode(resultStr).length)} output`;
+    }
+}
+// ------------------------------------------------------------------
+// Context group builder
+// ------------------------------------------------------------------
+function getLogContextId(entry) {
+    if (entry.discarded || entry.summarized)
+        return null;
+    if (entry.type === "compact_context") {
+        const ctxId = entry.meta["contextId"];
+        return ctxId ? String(ctxId) : null;
+    }
+    const ctxId = entry.meta["contextId"];
+    if (ctxId === undefined || ctxId === null)
+        return null;
+    return String(ctxId);
+}
+/**
+ * Build context groups from log entries in the active window.
+ * Returns groups in spatial (appearance) order.
+ */
+export function buildContextGroups(entries) {
+    // Find active window start (after last compact_marker)
+    let windowStartIdx = 0;
+    for (let i = entries.length - 1; i >= 0; i--) {
+        if (entries[i].type === "compact_marker" && !entries[i].discarded) {
+            windowStartIdx = i + 1;
+            break;
+        }
+    }
+    // Build ordered groups
+    const groupMap = new Map();
+    const groupOrder = [];
+    for (let i = windowStartIdx; i < entries.length; i++) {
+        const entry = entries[i];
+        const ctxId = getLogContextId(entry);
+        if (!ctxId)
+            continue;
+        let group = groupMap.get(ctxId);
+        if (!group) {
+            group = { contextId: ctxId, entries: [], totalTokens: 0, entryTokens: [] };
+            groupMap.set(ctxId, group);
+            groupOrder.push(ctxId);
+        }
+        const tokens = estimateEntryTokens(entry);
+        group.entries.push({ entry, index: i });
+        group.entryTokens.push(tokens);
+        group.totalTokens += tokens;
+    }
+    return groupOrder.map((id) => groupMap.get(id));
+}
+// ------------------------------------------------------------------
+// Context Map generation (compact, for tool_result)
+// ------------------------------------------------------------------
+function entryTypeLabel(entry) {
+    switch (entry.type) {
+        case "user_message": return "user";
+        case "assistant_text": return "assistant";
+        case "reasoning": return "thinking";
+        case "tool_call": return "call";
+        case "tool_result": return "result";
+        case "no_reply": return "no-reply";
+        case "summary": return "summary";
+        case "compact_context": return "compact";
+        default: return entry.type;
+    }
+}
+function buildTypeList(group) {
+    const counts = new Map();
+    for (const { entry } of group.entries) {
+        const label = entryTypeLabel(entry);
+        counts.set(label, (counts.get(label) ?? 0) + 1);
+    }
+    const parts = [];
+    for (const [label, count] of counts) {
+        parts.push(count > 1 ? `${count}× ${label}` : label);
+    }
+    return parts.join(", ");
+}
+function groupHeaderAnnotation(group) {
+    const isSummary = group.entries.some((e) => e.entry.type === "summary");
+    const isCompact = group.entries.some((e) => e.entry.type === "compact_context");
+    if (isSummary) {
+        const depth = group.entries
+            .filter((e) => e.entry.type === "summary")
+            .map((e) => e.entry.meta["summaryDepth"] ?? 1)[0];
+        return ` — summary, depth ${depth}`;
+    }
+    if (isCompact)
+        return " — auto-compact";
+    return "";
+}
+export function generateContextMap(groups, lastInputTokens, budget) {
+    const lines = [];
+    lines.push(`Context Map (${groups.length} groups)`);
+    lines.push(`Total: ${formatTokens(lastInputTokens)} | Budget: ${formatTokens(budget)}`);
+    lines.push("");
+    for (const group of groups) {
+        const tokStr = formatTokens(group.totalTokens).padStart(4);
+        const types = buildTypeList(group);
+        const annotation = groupHeaderAnnotation(group);
+        lines.push(`[${group.contextId}] ${tokStr}  ${types}${annotation}`);
+    }
+    return lines.join("\n");
+}
+// ------------------------------------------------------------------
+// Injection annotation generation (detailed, for §{id}§ locations)
+// ------------------------------------------------------------------
+export function generateAnnotations(groups) {
+    const annotations = new Map();
+    for (const group of groups) {
+        const lines = [];
+        const header = `§{${group.contextId}}§ ${formatTokens(group.totalTokens)}${groupHeaderAnnotation(group)}`;
+        lines.push(header);
+        for (let j = 0; j < group.entries.length; j++) {
+            const { entry } = group.entries[j];
+            const tokens = group.entryTokens[j];
+            const { label, description } = describeEntry(entry);
+            const tokStr = formatTokens(tokens).padStart(4);
+            const paddedLabel = label.padEnd(10);
+            lines.push(`  ${paddedLabel} ${description.padEnd(50)} ${tokStr}`);
+        }
+        annotations.set(group.contextId, lines.join("\n"));
+    }
+    return annotations;
+}
+// ------------------------------------------------------------------
+// Combined entry point
+// ------------------------------------------------------------------
+export function generateShowContext(entries, lastInputTokens, budget) {
+    const groups = buildContextGroups(entries);
+    return {
+        contextMap: generateContextMap(groups, lastInputTokens, budget),
+        annotations: generateAnnotations(groups),
+    };
+}
+//# sourceMappingURL=show-context.js.map

package/dist/show-context.js.map

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

package/dist/skills/loader.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Skill discovery and loading.
+ *
+ * Skills are reusable prompt expansions defined as SKILL.md files
+ * with YAML frontmatter + markdown instructions. Aligned with the
+ * Agent Skills open standard (https://agentskills.io).
+ *
+ * Directory layout:
+ *
+ *   skills/
+ *   +-- explain-code/
+ *   |   +-- SKILL.md          # required
+ *   |   +-- scripts/          # optional helper scripts
+ *   |   +-- references/       # optional docs
+ *   +-- deploy/
+ *       +-- SKILL.md
+ */
+export interface SkillMeta {
+    /** Skill identifier — also becomes the /slash-command name. */
+    name: string;
+    /** Description of when to use this skill. */
+    description: string;
+    /** If true, only the user can invoke via /name (agent cannot call skill tool). */
+    disableModelInvocation: boolean;
+    /** If false, skill is hidden from the / menu (only agent can invoke). */
+    userInvocable: boolean;
+    /** Absolute path to the skill directory. */
+    dir: string;
+    /** SKILL.md body after frontmatter (raw markdown). */
+    contentRaw: string;
+}
+/**
+ * Discover and load all skills from a skills root directory.
+ *
+ * Each subdirectory containing a SKILL.md file is treated as a skill.
+ * Parse errors are warned and skipped.
+ */
+export declare function loadSkills(skillsRoot: string): Map<string, SkillMeta>;
+/**
+ * Resolve a skill's content by substituting `$ARGUMENTS`, `$ARGUMENTS[N]`,
+ * and `$N` placeholders with the provided arguments string.
+ */
+export declare function resolveSkillContent(skill: SkillMeta, args: string): string;
+/**
+ * Load skills from multiple root directories (e.g. bundled + user).
+ * Later roots override earlier ones by skill name.
+ */
+export declare function loadSkillsMulti(roots: string[]): Map<string, SkillMeta>;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAUH,MAAM,WAAW,SAAS;IACxB,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,sBAAsB,EAAE,OAAO,CAAC;IAChC,yEAAyE;IACzE,aAAa,EAAE,OAAO,CAAC;IACvB,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;CACpB;AA0CD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAwErE;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAoB1E;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAUvE"}

package/dist/skills/loader.js

@@ -0,0 +1,166 @@
+/**
+ * Skill discovery and loading.
+ *
+ * Skills are reusable prompt expansions defined as SKILL.md files
+ * with YAML frontmatter + markdown instructions. Aligned with the
+ * Agent Skills open standard (https://agentskills.io).
+ *
+ * Directory layout:
+ *
+ *   skills/
+ *   +-- explain-code/
+ *   |   +-- SKILL.md          # required
+ *   |   +-- scripts/          # optional helper scripts
+ *   |   +-- references/       # optional docs
+ *   +-- deploy/
+ *       +-- SKILL.md
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+import * as yaml from "js-yaml";
+/**
+ * Split a SKILL.md file into YAML frontmatter and markdown body.
+ * Returns null if no valid frontmatter is found.
+ */
+function parseSkillMd(raw) {
+    const trimmed = raw.trimStart();
+    if (!trimmed.startsWith("---"))
+        return null;
+    // Find closing ---
+    const endIdx = trimmed.indexOf("\n---", 3);
+    if (endIdx === -1)
+        return null;
+    const yamlStr = trimmed.slice(3, endIdx).trim();
+    const body = trimmed.slice(endIdx + 4).trim(); // skip past \n---
+    let frontmatter;
+    try {
+        const parsed = yaml.load(yamlStr);
+        if (typeof parsed !== "object" || parsed === null)
+            return null;
+        frontmatter = parsed;
+    }
+    catch {
+        return null;
+    }
+    return { frontmatter, body };
+}
+// ------------------------------------------------------------------
+// Skill loading
+// ------------------------------------------------------------------
+/**
+ * Discover and load all skills from a skills root directory.
+ *
+ * Each subdirectory containing a SKILL.md file is treated as a skill.
+ * Parse errors are warned and skipped.
+ */
+export function loadSkills(skillsRoot) {
+    const skills = new Map();
+    if (!existsSync(skillsRoot) || !statSync(skillsRoot).isDirectory()) {
+        return skills;
+    }
+    for (const entry of readdirSync(skillsRoot)) {
+        if (entry === ".staging")
+            continue;
+        const dirPath = join(skillsRoot, entry);
+        if (!statSync(dirPath).isDirectory())
+            continue;
+        const skillMdPath = join(dirPath, "SKILL.md");
+        if (!existsSync(skillMdPath))
+            continue;
+        try {
+            const raw = readFileSync(skillMdPath, "utf-8");
+            const parsed = parseSkillMd(raw);
+            let name;
+            let description;
+            let disableModelInvocation = false;
+            let userInvocable = true;
+            let body;
+            if (parsed) {
+                const fm = parsed.frontmatter;
+                name = typeof fm["name"] === "string" ? fm["name"] : entry;
+                description = typeof fm["description"] === "string"
+                    ? fm["description"]
+                    : extractFirstParagraph(parsed.body);
+                disableModelInvocation = fm["disable-model-invocation"] === true;
+                userInvocable = fm["user-invocable"] !== false;
+                body = parsed.body;
+            }
+            else {
+                // No frontmatter — use directory name and full content
+                name = entry;
+                description = extractFirstParagraph(raw);
+                body = raw;
+            }
+            // Validate name: lowercase letters, numbers, hyphens only
+            if (!/^[a-z0-9][a-z0-9-]*$/.test(name)) {
+                console.warn(`Skill "${entry}": invalid name "${name}" (must be lowercase alphanumeric + hyphens). Skipping.`);
+                continue;
+            }
+            if (skills.has(name)) {
+                console.warn(`Skill "${entry}": duplicate name "${name}". Skipping.`);
+                continue;
+            }
+            skills.set(name, {
+                name,
+                description,
+                disableModelInvocation,
+                userInvocable,
+                dir: dirPath,
+                contentRaw: body,
+            });
+        }
+        catch (e) {
+            console.warn(`Skill "${entry}": failed to load SKILL.md: ${e instanceof Error ? e.message : e}`);
+        }
+    }
+    return skills;
+}
+// ------------------------------------------------------------------
+// Argument substitution
+// ------------------------------------------------------------------
+/**
+ * Resolve a skill's content by substituting `$ARGUMENTS`, `$ARGUMENTS[N]`,
+ * and `$N` placeholders with the provided arguments string.
+ */
+export function resolveSkillContent(skill, args) {
+    const parts = args.trim() ? args.trim().split(/\s+/) : [];
+    let content = skill.contentRaw;
+    // Replace positional: $ARGUMENTS[N] and $N (longest match first)
+    for (let i = parts.length - 1; i >= 0; i--) {
+        content = content.replace(new RegExp(`\\$ARGUMENTS\\[${i}\\]`, "g"), parts[i]);
+        content = content.replace(new RegExp(`\\$${i}(?![0-9])`, "g"), parts[i]);
+    }
+    // Replace $ARGUMENTS (full string)
+    content = content.replace(/\$ARGUMENTS/g, args.trim());
+    return content;
+}
+// ------------------------------------------------------------------
+// Helpers
+// ------------------------------------------------------------------
+/**
+ * Load skills from multiple root directories (e.g. bundled + user).
+ * Later roots override earlier ones by skill name.
+ */
+export function loadSkillsMulti(roots) {
+    const merged = new Map();
+    for (const root of roots) {
+        if (!existsSync(root) || !statSync(root).isDirectory())
+            continue;
+        const found = loadSkills(root);
+        for (const [name, skill] of found) {
+            merged.set(name, skill); // later roots override earlier (user > bundled)
+        }
+    }
+    return merged;
+}
+/** Extract the first non-empty paragraph from markdown text. */
+function extractFirstParagraph(text) {
+    for (const line of text.split("\n")) {
+        const trimmed = line.trim();
+        if (trimmed && !trimmed.startsWith("#")) {
+            return trimmed.length > 120 ? trimmed.slice(0, 117) + "..." : trimmed;
+        }
+    }
+    return "(no description)";
+}
+//# sourceMappingURL=loader.js.map

package/dist/skills/loader.js.map

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

package/dist/summarize-context.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Log-native summarize_context implementation.
+ *
+ * The session log is the single source of truth. summarize_context works
+ * directly on LogEntry[] and inserts summary entries into the active window.
+ */
+import { type LogEntry } from "./log-entry.js";
+export interface SummarizeOperation {
+    context_ids: string[];
+    summary: string;
+    reason?: string;
+}
+export interface OperationResult {
+    success: boolean;
+    contextIds: string[];
+    newContextId?: string;
+    error?: string;
+}
+export interface LogSummarizeExecutionResult {
+    output: string;
+    results: OperationResult[];
+}
+/**
+ * Truncate long summary text in projected tool arguments.
+ * The tool result still keeps the full summary; this only shrinks provider input.
+ */
+export declare function truncateSummaryText(summary: string, newContextId?: string | number): string;
+export declare function execSummarizeContextOnLog(args: Record<string, unknown>, entries: LogEntry[], contextIdAllocator: () => string, logIdAllocator: () => string, turnIndex: number): LogSummarizeExecutionResult;
+//# sourceMappingURL=summarize-context.d.ts.map

package/dist/summarize-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize-context.d.ts","sourceRoot":"","sources":["../src/summarize-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAYD,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AA4MD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAc3F;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,QAAQ,EAAE,EACnB,kBAAkB,EAAE,MAAM,MAAM,EAChC,cAAc,EAAE,MAAM,MAAM,EAC5B,SAAS,EAAE,MAAM,GAChB,2BAA2B,CAoE7B"}