agentfootprint 1.0.0

package/dist/lib/loop/buildAgentLoop.js

@@ -0,0 +1,405 @@
+"use strict";
+/**
+ * Loop assembler — builds the full agent ReAct loop flowchart.
+ *
+ * Mounts the three API slots as subflows, then wires CallLLM → ParseResponse →
+ * RouteResponse (decider) with branches for tool execution and finalization.
+ *
+ * Supports two loop patterns (AgentPattern enum):
+ *
+ * Regular ReAct (default): loopTo('call-llm')
+ *   Seed → [sf-system-prompt] → [sf-messages] → [sf-tools]
+ *     → AssemblePrompt → CallLLM → ParseResponse
+ *     → RouteResponse(decider) → [CommitMemory?] → loopTo('call-llm')
+ *   Slots resolve ONCE before the loop.
+ *
+ * Dynamic ReAct: loopTo('sf-instructions-to-llm' or 'sf-system-prompt')
+ *   Same flowchart, but loop jumps back to InstructionsToLLM (when configured)
+ *   or SystemPrompt. All slots re-evaluate each iteration.
+ *   Uses arrayMerge: ArrayMergeMode.Replace on Messages/Tools outputMappers
+ *   so arrays are overwritten (not concatenated) on each iteration.
+ *
+ * Design choices:
+ *   - Seed stage initializes loopCount + maxIterations + messages
+ *   - Slot subflows use arrayMerge: Replace to avoid stale array accumulation
+ *   - Each slot is ALWAYS a subflow — zero overhead, free drill-down + narrative
+ *   - RouteResponse is a proper decider — visible in flowchart as diamond with branches
+ *   - Tool execution is a subflow — enables drill-down in BTS
+ *   - Chart is self-contained — no wrapping needed
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAgentLoop = exports.SUBFLOW_MESSAGE_KEY = void 0;
+const footprintjs_1 = require("footprintjs");
+const advanced_1 = require("footprintjs/advanced");
+const messages_1 = require("../../types/messages");
+const system_prompt_1 = require("../slots/system-prompt");
+const messages_2 = require("../slots/messages");
+const tools_1 = require("../slots/tools");
+const callLLMStage_1 = require("../call/callLLMStage");
+const streamingCallLLMStage_1 = require("../call/streamingCallLLMStage");
+const parseResponseStage_1 = require("../call/parseResponseStage");
+const toolExecutionSubflow_1 = require("../call/toolExecutionSubflow");
+const commitMemory_1 = require("../../stages/commitMemory");
+const content_1 = require("../../types/content");
+const memory_1 = require("../../memory");
+const types_1 = require("./types");
+const instructions_1 = require("../instructions");
+// ── Default Agent Routing ─────────────────────────────────────────────────────
+/**
+ * Default routing for the Agent loop: tool-calls | final.
+ *
+ * Expressed as a RoutingConfig so buildAgentLoop has ONE code path
+ * for both Agent and Swarm routing.
+ */
+function defaultAgentRouting(toolExecutionSubflow, useCommitFlag) {
+    return {
+        deciderName: 'RouteResponse',
+        deciderId: 'route-response',
+        deciderDescription: 'Route to tool execution or finalization based on LLM response',
+        decider: (scope) => {
+            const parsed = scope.parsedResponse;
+            if (parsed?.hasToolCalls)
+                return 'tool-calls';
+            return 'final';
+        },
+        branches: [
+            {
+                id: 'tool-calls',
+                kind: 'subflow',
+                chart: toolExecutionSubflow,
+                name: 'ExecuteTools',
+                mount: {
+                    inputMapper: (parent) => ({
+                        parsedResponse: parent.parsedResponse,
+                        currentMessages: parent.messages,
+                        currentLoopCount: parent.loopCount,
+                        maxIterations: parent.maxIterations,
+                        ...(parent.decision ? { currentDecision: parent.decision } : {}),
+                    }),
+                    outputMapper: (sfOutput) => ({
+                        messages: sfOutput.toolResultMessages,
+                        loopCount: sfOutput.updatedLoopCount,
+                        ...(sfOutput.updatedDecision ? { decision: sfOutput.updatedDecision } : {}),
+                    }),
+                },
+            },
+            {
+                id: 'final',
+                kind: 'fn',
+                fn: createFinalizeStage({ useCommitFlag }),
+                description: 'Extract final answer and stop the loop',
+                name: 'Finalize',
+            },
+        ],
+        defaultBranch: 'final',
+    };
+}
+/**
+ * Well-known scope key for the user message in subflow mode.
+ * Parent charts must set this key in their inputMapper:
+ * `inputMapper: (p) => ({ message: p.userMessage })`
+ */
+exports.SUBFLOW_MESSAGE_KEY = 'message';
+function buildAgentLoop(config, seed, options) {
+    validateConfig(config);
+    const maxIterations = config.maxIterations ?? 10;
+    const seedMessages = seed?.messages ?? [];
+    const existingMessages = seed?.existingMessages ?? [];
+    const subflowMode = seed?.subflowMode ?? false;
+    // Auto-enable useCommitFlag when commitMemory is provided
+    const useCommitFlag = config.useCommitFlag || !!config.commitMemory;
+    // Build slot subflows
+    const systemPromptSubflow = (0, system_prompt_1.buildSystemPromptSubflow)(config.systemPrompt);
+    const messagesSubflow = (0, messages_2.buildMessagesSubflow)(config.messages);
+    const toolsSubflow = (0, tools_1.buildToolsSubflow)(config.tools);
+    // Build instruction config from registry — collect tools that have instructions
+    // Apply agent-level overrides if provided
+    const instructionsByToolId = new Map();
+    for (const tool of config.registry.all()) {
+        const instructed = tool;
+        if (instructed.instructions?.length) {
+            const override = config.instructionOverrides?.get(tool.id);
+            if (override) {
+                instructionsByToolId.set(tool.id, (0, instructions_1.applyInstructionOverrides)(instructed.instructions, override));
+            }
+            else {
+                instructionsByToolId.set(tool.id, instructed.instructions);
+            }
+        }
+    }
+    // Instruction tool registration is done by AgentRunner constructor (not here).
+    // decideFunctions are pre-computed and passed via config.decideFunctions.
+    const hasAgentInstructions = config.agentInstructions && config.agentInstructions.length > 0;
+    // Build a fresh local map: start from pre-computed agent-level functions, add per-tool ones.
+    // Uses a local copy — never mutates the cached config.decideFunctions.
+    const decideFunctions = new Map(config.decideFunctions ?? []);
+    for (const [, instructions] of instructionsByToolId) {
+        for (const instr of instructions) {
+            if (instr.decide && !decideFunctions.has(instr.id)) {
+                decideFunctions.set(instr.id, instr.decide);
+            }
+        }
+    }
+    // Capture strict follow-ups that fire during tool execution.
+    // Stored in a closure variable — AgentRunner reads it after run() completes.
+    let lastStrictFollowUp;
+    let lastStrictSourceToolId;
+    const onInstructionsFired = (toolId, fired) => {
+        // Find the first strict follow-up that fired (highest priority wins)
+        if (!lastStrictFollowUp) {
+            for (const instr of fired) {
+                if (instr.resolvedFollowUp?.strict) {
+                    lastStrictFollowUp = instr.resolvedFollowUp;
+                    lastStrictSourceToolId = toolId;
+                    break;
+                }
+            }
+        }
+        // Forward to external callback (InstructionRecorder)
+        config.onInstructionsFired?.(toolId, fired);
+    };
+    // Build call stages — pass onStreamEvent + responseFormat for llm_start/llm_end events
+    const callLLM = config.streaming
+        ? (0, streamingCallLLMStage_1.createStreamingCallLLMStage)(config.provider, {
+            onStreamEvent: config.onStreamEvent,
+            responseFormat: config.responseFormat,
+        })
+        : (0, callLLMStage_1.createCallLLMStage)(config.provider, {
+            onStreamEvent: config.onStreamEvent,
+            responseFormat: config.responseFormat,
+        });
+    const toolExecutionSubflow = (0, toolExecutionSubflow_1.buildToolExecutionSubflow)({
+        registry: config.registry,
+        toolProvider: config.toolProvider,
+        // Always pass instruction config — even without build-time instructions,
+        // tool handlers can return runtime instructions/followUps.
+        instructionConfig: {
+            instructionsByToolId,
+            onInstructionsFired,
+            decideFunctions: decideFunctions.size > 0 ? decideFunctions : undefined,
+            agentResponseRules: hasAgentInstructions
+                ? config.agentInstructions.flatMap((i) => i.onToolResult ?? [])
+                : undefined,
+            onStreamEvent: config.onStreamEvent,
+        },
+    });
+    // Two distinct Seed stage implementations — no runtime boolean.
+    // The flowchart is built differently for standalone vs subflow composition.
+    const initialDecision = config.initialDecision ?? {};
+    const seedStandalone = (scope) => {
+        scope.messages = [...existingMessages, ...seedMessages];
+        scope.loopCount = 0;
+        scope.maxIterations = maxIterations;
+        if (hasAgentInstructions) {
+            scope.decision = { ...initialDecision };
+        }
+    };
+    const seedSubflow = (scope) => {
+        const msg = scope.message ?? '';
+        scope.messages = msg ? [(0, messages_1.userMessage)(msg)] : [];
+        scope.loopCount = 0;
+        scope.maxIterations = maxIterations;
+        if (hasAgentInstructions) {
+            scope.decision = { ...initialDecision };
+        }
+    };
+    const seedStage = subflowMode ? seedSubflow : seedStandalone;
+    let builder = (0, footprintjs_1.flowChart)('Seed', seedStage, 'seed', undefined, 'Initialize agent loop state');
+    // Mount InstructionsToLLM subflow BEFORE the 3 API slots (only when instructions registered)
+    if (hasAgentInstructions) {
+        const instructionsSubflow = (0, instructions_1.buildInstructionsToLLMSubflow)(config.agentInstructions);
+        builder = builder.addSubFlowChartNext('sf-instructions-to-llm', instructionsSubflow, 'InstructionsToLLM', {
+            inputMapper: (parent) => ({
+                decision: parent.decision,
+            }),
+            outputMapper: (sf) => ({
+                promptInjections: sf.promptInjections,
+                toolInjections: sf.toolInjections,
+                responseRules: sf.responseRules,
+                matchedInstructions: sf.matchedInstructions,
+            }),
+        });
+    }
+    // Mount SystemPrompt subflow
+    builder = builder.addSubFlowChartNext('sf-system-prompt', systemPromptSubflow, 'SystemPrompt', {
+        inputMapper: (parent) => ({
+            messages: parent.messages,
+            loopCount: parent.loopCount,
+            ...(parent.promptInjections ? { promptInjections: parent.promptInjections } : {}),
+        }),
+        outputMapper: (sfOutput) => ({
+            systemPrompt: sfOutput.systemPrompt,
+        }),
+    });
+    // Mount Messages subflow
+    // Mount Messages subflow — arrayMerge: 'replace' so messages are overwritten
+    // (not concatenated) on each Dynamic ReAct iteration.
+    builder = builder.addSubFlowChartNext('sf-messages', messagesSubflow, 'Messages', {
+        inputMapper: (parent) => ({
+            currentMessages: parent.messages ?? [],
+            loopCount: parent.loopCount ?? 0,
+        }),
+        outputMapper: (sfOutput) => ({
+            messages: sfOutput.memory_preparedMessages,
+            memory_preparedMessages: sfOutput.memory_preparedMessages,
+            memory_storedHistory: sfOutput.memory_storedHistory,
+        }),
+        arrayMerge: advanced_1.ArrayMergeMode.Replace,
+    });
+    // Mount Tools subflow — arrayMerge: 'replace' so toolDescriptions is overwritten
+    // each iteration (not concatenated). Essential for Dynamic mode where tools change.
+    builder = builder.addSubFlowChartNext('sf-tools', toolsSubflow, 'Tools', {
+        inputMapper: (parent) => ({
+            messages: parent.messages,
+            loopCount: parent.loopCount,
+            ...(parent.toolInjections ? { toolInjections: parent.toolInjections } : {}),
+        }),
+        outputMapper: (sfOutput) => ({
+            toolDescriptions: sfOutput.toolDescriptions,
+        }),
+        arrayMerge: advanced_1.ArrayMergeMode.Replace,
+    });
+    const assemblePromptStage = (scope) => {
+        const messages = scope.messages ?? [];
+        const sysPrompt = scope.systemPrompt;
+        if (sysPrompt) {
+            // Replace existing system message (if any) with current system prompt.
+            // In Dynamic mode, the system prompt changes each iteration (instruction injections).
+            const nonSystem = messages.filter((m) => m.role !== 'system');
+            scope.messages = [(0, messages_1.systemMessage)(sysPrompt), ...nonSystem];
+        }
+    };
+    // AssemblePrompt: prepend system message if not already present
+    builder = builder.addFunction('AssemblePrompt', assemblePromptStage, 'assemble-prompt', 'Prepend system prompt to messages before LLM call');
+    // CallLLM → ParseResponse → Routing(decider)
+    //   Routing is pluggable via config.routing (RoutingConfig).
+    //   Default: RouteResponse → {tool-calls | final}
+    //   Swarm:   RouteSpecialist → {specialist-A | ... | swarm-tools | final}
+    //
+    // Add CallLLM — streaming or non-streaming
+    if (config.streaming) {
+        builder = builder.addStreamingFunction('CallLLM', callLLM, 'call-llm', 'llm-stream', 'Send messages + tools to LLM provider (streaming)');
+    }
+    else {
+        builder = builder.addFunction('CallLLM', callLLM, 'call-llm', 'Send messages + tools to LLM provider');
+    }
+    builder = builder
+        .addFunction('ParseResponse', parseResponseStage_1.parseResponseStage, 'parse-response', 'Parse LLM response into structured result');
+    // ── Routing — one code path for both Agent and Swarm ──
+    const routing = config.routing ?? defaultAgentRouting(toolExecutionSubflow, useCommitFlag);
+    // Validate branches
+    if (routing.branches.length === 0) {
+        throw new Error('RoutingConfig must have at least one branch.');
+    }
+    const branchIds = new Set(routing.branches.map((b) => b.id));
+    if (branchIds.size !== routing.branches.length) {
+        throw new Error('RoutingConfig has duplicate branch IDs.');
+    }
+    if (!branchIds.has(routing.defaultBranch)) {
+        throw new Error(`RoutingConfig.defaultBranch '${routing.defaultBranch}' does not match any branch ID: [${[...branchIds].join(', ')}]`);
+    }
+    // Wrap decider with structural maxIterations guard — no custom routing can bypass this.
+    // If loopCount >= maxIterations, force-route to defaultBranch.
+    // The defaultBranch MUST call $break() or breakFn() — validated below.
+    const safeDecider = (scope, breakFn, streamCb) => {
+        const loopCount = scope.loopCount ?? 0;
+        const maxIter = scope.maxIterations ?? 10;
+        if (loopCount >= maxIter)
+            return routing.defaultBranch;
+        return routing.decider(scope, breakFn, streamCb);
+    };
+    let decider = builder.addDeciderFunction(routing.deciderName, safeDecider, routing.deciderId, routing.deciderDescription);
+    for (const branch of routing.branches) {
+        switch (branch.kind) {
+            case 'subflow':
+                decider = decider.addSubFlowChartBranch(branch.id, branch.chart, branch.name ?? branch.id, branch.mount);
+                break;
+            case 'lazy-subflow':
+                decider = decider.addLazySubFlowChartBranch(branch.id, branch.factory, branch.name ?? branch.id, branch.mount);
+                break;
+            case 'fn':
+                decider = decider.addFunctionBranch(branch.id, branch.name ?? branch.id, branch.fn, branch.description);
+                break;
+        }
+    }
+    builder = decider.setDefault(routing.defaultBranch).end();
+    // Mount CommitMemory when persistent memory is configured.
+    // CommitMemory saves full history to store (fire-and-forget) and calls $break().
+    if (config.commitMemory) {
+        const commitMemory = (0, commitMemory_1.createCommitMemoryStage)(config.commitMemory);
+        builder = builder.addFunction('CommitMemory', commitMemory, 'commit-memory', 'Persist conversation history to store');
+    }
+    // Loop target depends on pattern:
+    //   Regular (default): loop to CallLLM — slots resolve once
+    //   Dynamic: loop to InstructionsToLLM (if mounted) or SystemPrompt
+    //     — instructions + all slots re-evaluate each iteration
+    const dynamicTarget = hasAgentInstructions ? 'sf-instructions-to-llm' : 'sf-system-prompt';
+    const loopTarget = config.pattern === types_1.AgentPattern.Dynamic
+        ? dynamicTarget
+        : 'call-llm';
+    builder = builder.loopTo(loopTarget);
+    /** Get strict follow-up that fired during the last execution (if any). */
+    const getStrictFollowUp = () => lastStrictFollowUp
+        ? { followUp: lastStrictFollowUp, sourceToolId: lastStrictSourceToolId }
+        : undefined;
+    if (options?.captureSpec) {
+        const spec = builder.toSpec();
+        return { chart: builder.build(), spec, getStrictFollowUp };
+    }
+    return { chart: builder.build(), getStrictFollowUp };
+}
+exports.buildAgentLoop = buildAgentLoop;
+/**
+ * Create the Finalize stage function (decider 'final' branch).
+ *
+ * Extracts the final answer text from the last assistant message and stops
+ * the loop. When useCommitFlag is set, writes memory_shouldCommit instead
+ * of calling $break() directly — the downstream CommitMemory stage will break.
+ */
+function createFinalizeStage(options) {
+    const { useCommitFlag } = options;
+    return (scope) => {
+        const messages = scope.messages ?? [];
+        const lastAsst = (0, memory_1.lastAssistantMessage)(messages);
+        scope.result = lastAsst ? (0, content_1.getTextContent)(lastAsst.content) : '';
+        if (useCommitFlag) {
+            scope.memory_shouldCommit = true;
+        }
+        else {
+            scope.$break();
+        }
+    };
+}
+/**
+ * Validate the AgentLoopConfig at build time.
+ */
+const isDevMode = () => typeof process !== 'undefined' && process.env?.['NODE_ENV'] !== 'production';
+function validateConfig(config) {
+    if (!config.provider) {
+        throw new Error('AgentLoopConfig: provider is required');
+    }
+    if (!config.systemPrompt) {
+        throw new Error('AgentLoopConfig: systemPrompt config is required');
+    }
+    if (!config.messages) {
+        throw new Error('AgentLoopConfig: messages config is required');
+    }
+    if (!config.tools) {
+        throw new Error('AgentLoopConfig: tools config is required');
+    }
+    if (!config.registry) {
+        throw new Error('AgentLoopConfig: registry is required');
+    }
+    if (config.maxIterations !== undefined && config.maxIterations < 0) {
+        throw new Error('AgentLoopConfig: maxIterations must be non-negative');
+    }
+    // Dev-mode warning: agentInstructions with activeWhen predicates but no initialDecision
+    if (isDevMode() && config.agentInstructions?.length && !config.initialDecision) {
+        const hasConditional = config.agentInstructions.some((i) => i.activeWhen);
+        if (hasConditional) {
+            console.warn('[agentfootprint] agentInstructions with activeWhen predicates provided but no initialDecision. ' +
+                'Decision scope will be {}, so conditional instructions may never fire.');
+        }
+    }
+}
+//# sourceMappingURL=buildAgentLoop.js.map

package/dist/lib/loop/buildAgentLoop.js.map

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

package/dist/lib/loop/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentPattern = exports.SUBFLOW_MESSAGE_KEY = exports.buildAgentLoop = void 0;
+var buildAgentLoop_1 = require("./buildAgentLoop");
+Object.defineProperty(exports, "buildAgentLoop", { enumerable: true, get: function () { return buildAgentLoop_1.buildAgentLoop; } });
+Object.defineProperty(exports, "SUBFLOW_MESSAGE_KEY", { enumerable: true, get: function () { return buildAgentLoop_1.SUBFLOW_MESSAGE_KEY; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "AgentPattern", { enumerable: true, get: function () { return types_1.AgentPattern; } });
+//# sourceMappingURL=index.js.map

package/dist/lib/loop/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/loop/index.ts"],"names":[],"mappings":";;;AAAA,mDAAuE;AAA9D,gHAAA,cAAc,OAAA;AAAE,qHAAA,mBAAmB,OAAA;AAE5C,iCAAuC;AAA9B,qGAAA,YAAY,OAAA"}

package/dist/lib/loop/types.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * Loop assembler types.
+ *
+ * The loop assembler wires the three API slots + call stages into a
+ * looping flowchart: SystemPrompt → Messages → Tools → CallLLM →
+ * ParseResponse → RouteResponse(decider) → {tool-calls | final}
+ * → loopTo('call-llm').
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentPattern = void 0;
+/**
+ * Agent loop patterns — determines which stages re-evaluate between iterations.
+ *
+ * The pattern controls WHERE the loop jumps back to after tool execution:
+ * - `Regular`: loops to CallLLM — slots resolve once before the loop
+ * - `Dynamic`: loops to SystemPrompt — all three API slots re-evaluate each iteration
+ *
+ * @example
+ * ```typescript
+ * import { Agent, AgentPattern } from 'agentfootprint';
+ *
+ * // Standard ReAct — fixed prompt, tools, memory (default)
+ * Agent.create({ provider }).build();
+ *
+ * // Dynamic ReAct — re-evaluate all slots each iteration
+ * Agent.create({ provider })
+ *   .pattern(AgentPattern.Dynamic)
+ *   .build();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Dynamic ReAct use case: progressive tool authorization
+ * // Turn 1: agent calls verify_identity → user is admin
+ * // Turn 2: Tools subflow re-evaluates → admin tools now available
+ * // Turn 3: agent can use admin tools that were hidden before
+ * ```
+ */
+var AgentPattern;
+(function (AgentPattern) {
+    /**
+     * Standard ReAct loop — loops back to CallLLM.
+     *
+     * SystemPrompt, Messages, and Tools subflows resolve ONCE before the loop starts.
+     * Each iteration only re-runs: CallLLM → ParseResponse → RouteResponse → tools.
+     * Best for: most agent use cases with fixed prompt/tools/memory.
+     *
+     * ```
+     * [SystemPrompt] → [Messages] → [Tools] → AssemblePrompt
+     *   → CallLLM → Parse → Route → ExecuteTools → loopTo(CallLLM)
+     *         ↑                                         |
+     *         └─────────────────────────────────────────┘
+     * ```
+     */
+    AgentPattern["Regular"] = "regular";
+    /**
+     * Dynamic ReAct loop — loops back to SystemPrompt.
+     *
+     * All three API slots (SystemPrompt, Messages, Tools) re-evaluate each iteration.
+     * Strategies receive updated context (messages now include tool results, loopCount
+     * incremented) and can return different prompt/tools/memory based on what happened.
+     * Best for: progressive authorization, adaptive prompts, context-dependent tool sets.
+     *
+     * ```
+     * [SystemPrompt] → [Messages] → [Tools] → AssemblePrompt
+     *   → CallLLM → Parse → Route → ExecuteTools → loopTo(SystemPrompt)
+     *  ↑                                                  |
+     *  └──────────────────────────────────────────────────┘
+     * ```
+     */
+    AgentPattern["Dynamic"] = "dynamic";
+})(AgentPattern || (exports.AgentPattern = AgentPattern = {}));
+//# sourceMappingURL=types.js.map

package/dist/lib/loop/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/loop/types.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAiEH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,IAAY,YAiCX;AAjCD,WAAY,YAAY;IACtB;;;;;;;;;;;;;OAaG;IACH,mCAAmB,CAAA;IAEnB;;;;;;;;;;;;;;OAcG;IACH,mCAAmB,CAAA;AACrB,CAAC,EAjCW,YAAY,4BAAZ,YAAY,QAiCvB"}