From 3f2a6ec9ce86b3ec7621d0f3de204fc820f2df83 Mon Sep 17 00:00:00 2001
From: Ben <62250174+benfrank241@users.noreply.github.com>
Date: Wed, 4 Mar 2026 15:02:58 -0500
Subject: [PATCH] doc: add MCP blog post (#492)
* doc: add MCP agent memory blog post
---
.../blog/2026-03-04-mcp-agent-memory.md | 266 ++++++
hindsight-docs/docusaurus.config.ts | 763 +++++++++---------
.../static/img/blog/mcp-agent-memory.png | Bin 0 -> 387693 bytes
3 files changed, 652 insertions(+), 377 deletions(-)
create mode 100644 hindsight-docs/blog/2026-03-04-mcp-agent-memory.md
create mode 100644 hindsight-docs/static/img/blog/mcp-agent-memory.png
diff --git a/hindsight-docs/blog/2026-03-04-mcp-agent-memory.md b/hindsight-docs/blog/2026-03-04-mcp-agent-memory.md
new file mode 100644
index 00000000..ca877ba6
--- /dev/null
+++ b/hindsight-docs/blog/2026-03-04-mcp-agent-memory.md
@@ -0,0 +1,266 @@
+---
+title: "The Open-Source MCP Memory Server Your AI Agent Is Missing"
+authors: [hindsight]
+date: 2026-03-04
+tags: [mcp, memory, agents, docker, tutorial]
+image: /img/blog/mcp-agent-memory.png
+hide_table_of_contents: true
+---
+
+AI agents forget everything between sessions. Hindsight gives them persistent, structured memory via MCP. One Docker command to run the full stack locally. Connect any MCP-compatible client. Three core operations: `retain` (store), `recall` (search), `reflect` (reason) — plus mental models that auto-update as memories grow.
+
+
+
+---
+
+## TL;DR
+
+- AI agents forget everything between sessions. Hindsight gives them persistent, structured memory via MCP.
+- One Docker command to run the full stack locally. Connect any MCP-compatible client.
+- Three core operations: `retain` (store), `recall` (search), `reflect` (reason). Plus mental models — living documents that auto-update as memories grow.
+- Hindsight isn't a vector database. It extracts structured facts, resolves entities, builds a knowledge graph, and uses cross-encoder reranking to surface what actually matters.
+- Open source: [github.com/vectorize-io/hindsight](https://github.com/vectorize-io/hindsight).
+
+---
+
+## The Problem
+
+AI agents are stateless. Every session starts from zero.
+
+You tell your coding assistant your tech stack, your deployment preferences, your team's conventions. Next session — gone. You explain the same architecture decisions, re-establish the same context, re-state the same constraints. Every time.
+
+People work around this by pasting context into system prompts or maintaining notes they copy in manually. That works for a while, but it doesn't scale. It can't capture the kind of nuanced, evolving knowledge that accumulates over weeks of working with an agent — things like "this user prefers functional patterns," "their team uses PostgreSQL 16," or "they tried Redis caching last month and rolled it back."
+
+What you actually want is for your agent to build up memory over time. Store what matters, retrieve it when relevant, and learn from the accumulation.
+
+Hindsight is an open-source memory system designed for exactly this. It connects to any MCP-compatible agent and gives it persistent, structured long-term memory.
+
+---
+
+## The Approach
+
+```
+Your MCP Client ──MCP (HTTP)──> Hindsight API
+(Claude, Cursor, │
+ VS Code, etc.) ├── Memory Engine (retain/recall/reflect)
+ ├── Fact Extraction + Entity Resolution
+ ├── Embeddings + Cross-Encoder Reranking
+ ├── Knowledge Graph Traversal
+ └── PostgreSQL + pgvector
+```
+
+Your agent connects to Hindsight over MCP (Model Context Protocol). MCP is an open standard — any client that speaks it can use Hindsight as a memory backend.
+
+When your agent stores a memory via `retain`, Hindsight doesn't just dump raw text into a vector database. It extracts structured facts, resolves entities ("Alice" and "my coworker Alice" are the same person), generates embeddings, and indexes everything for retrieval.
+
+When your agent needs context via `recall`, Hindsight runs four retrieval strategies in parallel — semantic search, BM25 keyword matching, entity graph traversal, and temporal filtering — then reranks results with a cross-encoder. What comes back is the most relevant subset of your memories, not a raw dump.
+
+This matters because naive RAG (embed text, cosine similarity, return top-k) breaks down when you have hundreds of memories spanning different topics and time periods. Hindsight's multi-strategy approach ensures that a question like "what did we decide about caching?" finds the right answer even when the memory uses different terminology.
+
+---
+
+## Implementation
+
+### Step 1: Start Hindsight
+
+The quickest way to run Hindsight is with Docker. One command gives you the full stack — API server, embedded PostgreSQL, local embedding models, and MCP endpoints:
+
+```bash
+docker run --rm -it --pull always -p 8888:8888 -p 9999:9999 \
+ -e HINDSIGHT_API_LLM_API_KEY=YOUR_LLM_API_KEY \
+ -v $HOME/.hindsight-docker:/home/hindsight/.pg0 \
+ ghcr.io/vectorize-io/hindsight:latest
+```
+
+You'll need an LLM API key for Hindsight's internal processing (fact extraction, entity resolution, reflect). Hindsight supports multiple LLM providers — OpenAI, Anthropic, Gemini, Groq, or a local model via Ollama or LM Studio. Set the provider explicitly if you're not using OpenAI:
+
+```bash
+docker run --rm -it --pull always -p 8888:8888 -p 9999:9999 \
+ -e HINDSIGHT_API_LLM_PROVIDER=gemini \
+ -e HINDSIGHT_API_LLM_API_KEY=YOUR_GEMINI_API_KEY \
+ -e HINDSIGHT_API_LLM_MODEL=gemini-2.5-flash \
+ -v $HOME/.hindsight-docker:/home/hindsight/.pg0 \
+ ghcr.io/vectorize-io/hindsight:latest
+```
+
+The `-v` flag persists your data across container restarts. Without it, memories are lost when the container stops. Port 8888 is the API and MCP endpoint; port 9999 is an optional admin UI for browsing memories.
+
+Once running, the MCP endpoint is available at `http://localhost:8888/mcp/your_bank_id/` (replace `your_bank_id` with any name you like).
+
+**Or use Hindsight Cloud** — skip Docker entirely. [Sign up for a free account](https://ui.hindsight.vectorize.io/signup), grab your API key, and connect via MCP:
+
+```json
+{
+ "mcpServers": {
+ "hindsight": {
+ "type": "http",
+ "url": "https://api.hindsight.vectorize.io/mcp/your_bank_id/",
+ "headers": {
+ "Authorization": "Bearer YOUR_API_KEY"
+ }
+ }
+ }
+}
+```
+
+Or with Claude Code:
+
+```bash
+claude mcp add --transport http hindsight \
+ https://api.hindsight.vectorize.io/mcp/your_bank_id/ \
+ --header "Authorization: Bearer YOUR_API_KEY"
+```
+
+### Step 2: Connect Your MCP Client
+
+Hindsight works with any MCP-compatible client. Add the following JSON to your client's config file:
+
+```json
+{
+ "mcpServers": {
+ "hindsight": {
+ "type": "http",
+ "url": "http://localhost:8888/mcp/your_bank_id/"
+ }
+ }
+}
+```
+
+Config file locations by client:
+
+| Client | Config File |
+|--------|-------------|
+| Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows) |
+| Cursor | `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global) |
+| VS Code | `.vscode/mcp.json` — uses `"servers"` instead of `"mcpServers"` |
+| Windsurf | `~/.codeium/windsurf/mcp_config.json` — uses `"serverUrl"` instead of `"url"` |
+
+**Claude Code** — use the CLI instead:
+
+```bash
+claude mcp add --transport http hindsight http://localhost:8888/mcp/your_bank_id/
+```
+
+Restart your client to pick up the changes.
+
+### Step 3: Verify It's Working
+
+Ask your agent:
+
+> "What memory tools do you have available?"
+
+It should list Hindsight's memory tools, including the three core operations (`retain`, `recall`, `reflect`), six mental model tools, and additional tools for browsing memories, managing documents, and bank administration.
+
+---
+
+## The Memory Tools
+
+Once connected, your agent has access to three core operations and a set of mental model tools.
+
+**Retain** — Store a memory:
+
+Tell your agent something you want it to remember. It will call `retain` automatically based on the tool's built-in instructions, or you can be explicit:
+
+> "Remember that I prefer TypeScript over JavaScript for all new projects."
+
+Behind the scenes, Hindsight extracts structured facts, resolves entities, and indexes the memory for later retrieval. A single `retain` call on "Alice from engineering recommended we switch to Postgres 16 for the new JSONB features" produces:
+
+- A fact: "Alice recommended switching to Postgres 16 for JSONB features"
+- Entity resolution: "Alice" linked to "Alice from engineering"
+- Temporal indexing: when this was mentioned
+- Embeddings: for semantic search later
+
+**Recall** — Search memories:
+
+Your agent will proactively recall relevant context when you ask questions. You can also prompt it directly:
+
+> "What do you know about my programming preferences?"
+
+Recall runs four retrieval strategies in parallel — semantic search, keyword matching (BM25), graph traversal, and temporal filtering — then reranks the results with a cross-encoder. This is what makes it work better than a simple vector search.
+
+**Reflect** — Synthesize insights:
+
+Reflect goes deeper than recall. Instead of returning raw facts, it reasons across your memories using an LLM:
+
+> "Based on what you know about me, what tech stack would you recommend for my next side project?"
+
+This is useful for questions that require connecting dots across multiple memories.
+
+**Mental Models** — Living documents:
+
+Mental models are summaries that automatically stay up to date as new memories are added. Think of them as pre-computed reflections that refresh themselves:
+
+> "Create a mental model called 'My Tech Stack' that tracks what languages, frameworks, and tools I use."
+
+You can list, retrieve, update, and delete mental models. They're useful for maintaining an always-current view of a topic without running a full `reflect` every time.
+
+---
+
+## Memory Banks
+
+The URL path controls which memory bank you're using. In the examples above, `/mcp/your_bank_id/` scopes all operations to that bank.
+
+Banks are isolated stores — think of each one as a separate brain. You can run separate banks for different contexts:
+
+- `my-project` for a specific project
+- `team-knowledge` for shared team information
+- One bank per user in a multi-agent system
+
+Banks are created automatically on first use. To use a different bank, change the URL path:
+
+```
+http://localhost:8888/mcp/project-x/
+```
+
+If you want your agent to manage multiple banks in a single session, connect to the multi-bank endpoint at `/mcp/` instead. This adds `bank_id` as a parameter to every tool and includes additional bank management tools like `list_banks`, `create_bank`, and `get_bank_stats`.
+
+---
+
+## Pitfalls & Edge Cases
+
+### Memory processing is async
+
+When your agent calls `retain`, fact extraction and indexing happen in the background. If you store something and immediately try to recall it, it might not be there yet. Give it a few seconds for complex memories.
+
+### Token limits on recall
+
+By default, `recall` returns up to 4096 tokens of memory content. For banks with extensive history, some older or lower-relevance memories may be trimmed from the response. This is intentional — it keeps the context window manageable.
+
+### Mental model creation is async too
+
+When you create or refresh a mental model, the LLM-powered generation runs in the background. The initial call returns an `operation_id`. The content will be available shortly after — typically a few seconds, depending on how many memories need to be synthesized.
+
+### LLM key is for Hindsight, not your agent
+
+The `HINDSIGHT_API_LLM_API_KEY` is used by Hindsight internally for fact extraction, entity resolution, and reflect operations. It's separate from whatever LLM your agent uses. You can use a cheap, fast model here (Gemini Flash, Groq, etc.) — it doesn't need to be the same model powering your agent.
+
+---
+
+## When Hindsight Works Well
+
+- You want structured memory, not just vector search over conversation logs
+- You need memory that works across sessions, clients, and agents
+- You want entity resolution, temporal awareness, and multi-strategy retrieval out of the box
+- You're building agents that accumulate knowledge over time
+
+---
+
+## Recap
+
+Hindsight gives any MCP-compatible agent persistent long-term memory. One Docker command to start, a few lines of JSON to connect.
+
+The key insight is that memory isn't just storage and retrieval. Hindsight extracts structured facts from raw input, links entities, tracks temporal data, and uses cross-encoder reranking to surface the most relevant memories. That's what separates it from stuffing conversation logs into a vector database.
+
+The MCP tools cover the full lifecycle: `retain` to store, `recall` to search with multi-strategy retrieval, `reflect` to synthesize insights, mental model tools for maintaining living documents that auto-update, and utility tools for browsing and managing memories, documents, and tags.
+
+> **Want managed hosting?** [Hindsight Cloud](https://ui.hindsight.vectorize.io) runs the full stack for you — no Docker, no infrastructure. Sign up, grab an API key, and connect over HTTPS.
+
+---
+
+## Next Steps
+
+- **Build up your memory**: Start using your agent normally. Tell it your preferences, your project context, your decisions. It will retain what matters.
+- **Explore mental models**: Create living documents that auto-update as your memory grows. Try: `"Create a mental model that summarizes my project architecture."`
+- **Try multi-bank setups**: Run separate banks for different projects or agents. Connect to `/mcp/` for multi-bank mode.
+- **Use the SDK directly**: Beyond MCP, Hindsight has [Python](https://pypi.org/project/hindsight-client/) and [TypeScript](https://www.npmjs.com/package/@vectorize-io/hindsight-client) SDKs for integrating memory into your own applications.
+- **Check out the docs**: Full API reference, SDK guides, and more at [hindsight.vectorize.io](https://hindsight.vectorize.io).
diff --git a/hindsight-docs/docusaurus.config.ts b/hindsight-docs/docusaurus.config.ts
index 9daef52e..f5916ead 100644
--- a/hindsight-docs/docusaurus.config.ts
+++ b/hindsight-docs/docusaurus.config.ts
@@ -1,377 +1,386 @@
-import {themes as prismThemes} from 'prism-react-renderer';
-import type {Config} from '@docusaurus/types';
-import type * as Preset from '@docusaurus/preset-classic';
-
-const umamiUrl = process.env.UMAMI_URL;
-const umamiWebsiteId = process.env.UMAMI_WEBSITE_ID;
-
-// Announcement bar - supports HTML for links
-// Set to empty string '' to hide the bar
-const ANNOUNCEMENT_BAR = 'Hindsight is State-of-the-Art on Memory for AI Agents | Read the paper →';
-
-const config: Config = {
- title: 'Hindsight',
- tagline: 'Hindsight: Agent Memory That Works Like Human Memory',
- favicon: 'img/favicon.png',
-
- future: {
- v4: true,
- },
-
- markdown: {
- mermaid: true,
- },
-
- url: 'https://hindsight.vectorize.io',
- baseUrl: '/',
-
- organizationName: 'vectorize-io',
- projectName: 'hindsight',
- trailingSlash: false,
-
- onBrokenLinks: 'throw',
-
- i18n: {
- defaultLocale: 'en',
- locales: ['en'],
- },
-
- headTags: [
- {
- tagName: 'link',
- attributes: {
- rel: 'preconnect',
- href: 'https://fonts.googleapis.com',
- },
- },
- {
- tagName: 'link',
- attributes: {
- rel: 'preconnect',
- href: 'https://fonts.gstatic.com',
- crossorigin: 'anonymous',
- },
- },
- {
- tagName: 'link',
- attributes: {
- rel: 'stylesheet',
- href: 'https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&family=JetBrains+Mono:wght@400;500;600&family=Space+Grotesk:wght@500;600;700&display=swap',
- media: 'print',
- onload: "this.media='all'",
- },
- },
- ],
-
- scripts: [
- ...(umamiUrl && umamiWebsiteId
- ? [
- {
- src: `${umamiUrl}/script.js`,
- async: true,
- defer: true,
- 'data-website-id': umamiWebsiteId,
- },
- ]
- : []),
- ],
-
- presets: [
- [
- 'classic',
- {
- docs: {
- sidebarPath: './sidebars.ts',
- routeBasePath: '/',
- // Only show "next" version in development or when INCLUDE_CURRENT_VERSION=true
- // In production, only show released versions from versions.json
- onlyIncludeVersions: (() => {
- const isDev = process.env.NODE_ENV === 'development' || process.env.INCLUDE_CURRENT_VERSION === 'true';
- try {
- const versions = require('./versions.json') as string[];
- // In dev mode, explicitly include 'current' (Next) + all released versions
- // In production, only show released versions
- return isDev ? ['current', ...versions] : versions;
- } catch {
- return undefined; // No versions yet, show current
- }
- })(),
- // Disable version badges on all versions
- versions: (() => {
- const config: Record = {
- current: {badge: false},
- };
- try {
- const versions = require('./versions.json') as string[];
- versions.forEach((v: string) => {
- config[v] = {badge: false};
- });
- } catch {
- // No versions yet
- }
- return config;
- })(),
- },
- blog: {
- showReadingTime: true,
- blogTitle: 'Hindsight Blog',
- blogDescription: 'Updates, insights, and deep dives into agent memory',
- postsPerPage: 10,
- blogSidebarCount: 0,
- },
- theme: {
- customCss: './src/css/custom.css',
- },
- } satisfies Preset.Options,
- ],
- [
- 'redocusaurus',
- {
- specs: [
- {
- id: 'hindsight-api',
- spec: 'static/openapi.json',
- route: '/api-reference',
- url: '/openapi.json',
- },
- ],
- theme: {
- primaryColor: '#0074d9',
- sidebar: {
- backgroundColor: '#09090b',
- },
- rightPanel: {
- backgroundColor: '#18181b',
- },
- typography: {
- fontSize: '15px',
- fontFamily: "'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif",
- headings: {
- fontFamily: "'Space Grotesk', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif",
- },
- code: {
- fontFamily: "'JetBrains Mono', 'Fira Code', 'SF Mono', Monaco, Consolas, monospace",
- fontSize: '13px',
- },
- },
- },
- config: {
- scrollYOffset: 60,
- nativeScrollbars: true,
- expandSingleSchemaField: true,
- expandResponses: '200,201',
- },
- },
- ],
- ],
-
- themes: [
- '@docusaurus/theme-mermaid',
- [
- '@easyops-cn/docusaurus-search-local',
- {
- hashed: true,
- docsRouteBasePath: '/',
- indexBlog: true,
- blogRouteBasePath: '/blog',
- highlightSearchTermsOnTargetPage: false,
- },
- ],
- ],
-
- themeConfig: {
- ...(ANNOUNCEMENT_BAR && {
- announcementBar: {
- id: 'announcement',
- content: ANNOUNCEMENT_BAR,
- backgroundColor: '#0074d9',
- textColor: '#ffffff',
- isCloseable: false,
- },
- }),
- image: 'img/logo.png',
- colorMode: {
- defaultMode: 'dark',
- respectPrefersColorScheme: true,
- },
- navbar: {
- logo: {
- alt: 'Hindsight Logo',
- src: 'img/logo.png',
- style: { height: '32px' },
- },
- items: [
- {
- type: 'doc',
- docId: 'developer/installation',
- position: 'left',
- label: 'Developer',
- className: 'navbar-item-developer',
- },
- {
- type: 'doc',
- docId: 'sdks/python',
- position: 'left',
- label: 'SDKs',
- className: 'navbar-item-sdks',
- },
- {
- to: '/faq',
- position: 'left',
- label: 'FAQ',
- className: 'navbar-item-faq',
- },
- {
- to: '/changelog',
- position: 'left',
- label: 'Changelog',
- className: 'navbar-item-changelog',
- },
- {
- type: 'dropdown',
- label: 'Resources',
- position: 'left',
- className: 'navbar-item-resources',
- items: [
- {
- to: '/cookbook',
- label: 'Cookbook',
- },
- {
- to: '/blog',
- label: 'Blog',
- },
- {
- to: '/api-reference',
- label: 'API Reference',
- },
- {
- href: 'https://join.slack.com/t/hindsight-space/shared_invite/zt-3nhbm4w29-LeSJ5Ixi6j8PdiYOCPlOgg',
- label: 'Community',
- },
- ],
- },
- {
- href: 'https://ui.hindsight.vectorize.io/signup',
- position: 'right',
- label: 'Cloud',
- className: 'navbar-item-cloud',
- },
- {
- type: 'docsVersionDropdown',
- position: 'right',
- className: 'navbar-item-version',
- },
- {
- href: 'https://github.com/vectorize-io/hindsight',
- position: 'right',
- className: 'header-github-link',
- 'aria-label': 'GitHub repository',
- },
- ],
- },
- footer: {
- style: 'dark',
- links: [
- {
- title: 'Documentation',
- items: [
- {
- label: 'Introduction',
- to: '/',
- },
- {
- label: 'Developer Guide',
- to: '/developer/installation',
- },
- {
- label: 'SDKs',
- to: '/sdks/python',
- },
- {
- label: 'API Reference',
- to: '/api-reference/',
- },
- ],
- },
- {
- title: 'Resources',
- items: [
- {
- label: 'Cookbook',
- to: '/cookbook',
- },
- {
- label: 'Changelog',
- to: '/changelog',
- },
- {
- label: 'Hindsight Cloud',
- href: 'https://ui.hindsight.vectorize.io/signup',
- },
- ],
- },
- {
- title: 'Community',
- items: [
- {
- label: 'GitHub',
- href: 'https://github.com/vectorize-io/hindsight',
- },
- {
- label: 'Slack',
- href: 'https://join.slack.com/t/hindsight-space/shared_invite/zt-3nhbm4w29-LeSJ5Ixi6j8PdiYOCPlOgg',
- },
- ],
- },
- ],
- copyright: `Copyright © ${new Date().getFullYear()} Vectorize, Inc.`,
- },
- prism: {
- theme: prismThemes.github,
- darkTheme: prismThemes.dracula,
- additionalLanguages: ['bash', 'json', 'python', 'rust'],
- },
- mermaid: {
- theme: {
- light: 'base',
- dark: 'base',
- },
- options: {
- themeVariables: {
- // Gradient start (#0074d9 blue) for nodes
- primaryColor: '#0074d9',
- primaryTextColor: '#ffffff',
- primaryBorderColor: '#005db0',
- // Gradient end (#009296 teal) for edges/clusters
- secondaryColor: '#009296',
- secondaryTextColor: '#ffffff',
- secondaryBorderColor: '#007a7d',
- // Tertiary
- tertiaryColor: '#e6f7f8',
- tertiaryTextColor: '#1e293b',
- // Lines and edges - gradient end color
- lineColor: '#009296',
- // Text
- textColor: '#1e293b',
- // Node specific - gradient start
- nodeBkg: '#0074d9',
- nodeTextColor: '#ffffff',
- nodeBorder: '#005db0',
- // Main background
- mainBkg: '#0074d9',
- // Clusters/subgraphs - gradient end
- clusterBkg: 'rgba(0, 146, 150, 0.08)',
- clusterBorder: '#009296',
- // Labels
- edgeLabelBackground: 'transparent',
- labelBackground: 'transparent',
- // Font - Inter to match body text
- fontFamily: "'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif",
- },
- },
- },
- } satisfies Preset.ThemeConfig,
-};
-
-export default config;
+import {themes as prismThemes} from 'prism-react-renderer';
+import type {Config} from '@docusaurus/types';
+import type * as Preset from '@docusaurus/preset-classic';
+
+const umamiUrl = process.env.UMAMI_URL;
+const umamiWebsiteId = process.env.UMAMI_WEBSITE_ID;
+
+// Announcement bar - supports HTML for links
+// Set to empty string '' to hide the bar
+const ANNOUNCEMENT_BAR = 'Hindsight is State-of-the-Art on Memory for AI Agents | Read the paper →';
+
+const config: Config = {
+ title: 'Hindsight',
+ tagline: 'Hindsight: Agent Memory That Works Like Human Memory',
+ favicon: 'img/favicon.png',
+
+ future: {
+ v4: true,
+ },
+
+ markdown: {
+ mermaid: true,
+ },
+
+ url: 'https://hindsight.vectorize.io',
+ baseUrl: '/',
+
+ organizationName: 'vectorize-io',
+ projectName: 'hindsight',
+ trailingSlash: false,
+
+ onBrokenLinks: 'throw',
+
+ i18n: {
+ defaultLocale: 'en',
+ locales: ['en'],
+ },
+
+ headTags: [
+ {
+ tagName: 'link',
+ attributes: {
+ rel: 'preconnect',
+ href: 'https://fonts.googleapis.com',
+ },
+ },
+ {
+ tagName: 'link',
+ attributes: {
+ rel: 'preconnect',
+ href: 'https://fonts.gstatic.com',
+ crossorigin: 'anonymous',
+ },
+ },
+ {
+ tagName: 'link',
+ attributes: {
+ rel: 'stylesheet',
+ href: 'https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&family=JetBrains+Mono:wght@400;500;600&family=Space+Grotesk:wght@500;600;700&display=swap',
+ media: 'print',
+ onload: "this.media='all'",
+ },
+ },
+ {
+ tagName: 'script',
+ attributes: {},
+ innerHTML: `window.dataLayer = window.dataLayer || [];function gtag(){dataLayer.push(arguments);}gtag('js', new Date());gtag('config', 'AW-16635605869');`,
+ },
+ ],
+
+ scripts: [
+ ...(umamiUrl && umamiWebsiteId
+ ? [
+ {
+ src: `${umamiUrl}/script.js`,
+ async: true,
+ defer: true,
+ 'data-website-id': umamiWebsiteId,
+ },
+ ]
+ : []),
+ {
+ src: 'https://www.googletagmanager.com/gtag/js?id=AW-16635605869',
+ async: true,
+ },
+ ],
+
+ presets: [
+ [
+ 'classic',
+ {
+ docs: {
+ sidebarPath: './sidebars.ts',
+ routeBasePath: '/',
+ // Only show "next" version in development or when INCLUDE_CURRENT_VERSION=true
+ // In production, only show released versions from versions.json
+ onlyIncludeVersions: (() => {
+ const isDev = process.env.NODE_ENV === 'development' || process.env.INCLUDE_CURRENT_VERSION === 'true';
+ try {
+ const versions = require('./versions.json') as string[];
+ // In dev mode, explicitly include 'current' (Next) + all released versions
+ // In production, only show released versions
+ return isDev ? ['current', ...versions] : versions;
+ } catch {
+ return undefined; // No versions yet, show current
+ }
+ })(),
+ // Disable version badges on all versions
+ versions: (() => {
+ const config: Record = {
+ current: {badge: false},
+ };
+ try {
+ const versions = require('./versions.json') as string[];
+ versions.forEach((v: string) => {
+ config[v] = {badge: false};
+ });
+ } catch {
+ // No versions yet
+ }
+ return config;
+ })(),
+ },
+ blog: {
+ showReadingTime: true,
+ blogTitle: 'Hindsight Blog',
+ blogDescription: 'Updates, insights, and deep dives into agent memory',
+ postsPerPage: 10,
+ blogSidebarCount: 0,
+ },
+ theme: {
+ customCss: './src/css/custom.css',
+ },
+ } satisfies Preset.Options,
+ ],
+ [
+ 'redocusaurus',
+ {
+ specs: [
+ {
+ id: 'hindsight-api',
+ spec: 'static/openapi.json',
+ route: '/api-reference',
+ url: '/openapi.json',
+ },
+ ],
+ theme: {
+ primaryColor: '#0074d9',
+ sidebar: {
+ backgroundColor: '#09090b',
+ },
+ rightPanel: {
+ backgroundColor: '#18181b',
+ },
+ typography: {
+ fontSize: '15px',
+ fontFamily: "'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif",
+ headings: {
+ fontFamily: "'Space Grotesk', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif",
+ },
+ code: {
+ fontFamily: "'JetBrains Mono', 'Fira Code', 'SF Mono', Monaco, Consolas, monospace",
+ fontSize: '13px',
+ },
+ },
+ },
+ config: {
+ scrollYOffset: 60,
+ nativeScrollbars: true,
+ expandSingleSchemaField: true,
+ expandResponses: '200,201',
+ },
+ },
+ ],
+ ],
+
+ themes: [
+ '@docusaurus/theme-mermaid',
+ [
+ '@easyops-cn/docusaurus-search-local',
+ {
+ hashed: true,
+ docsRouteBasePath: '/',
+ indexBlog: true,
+ blogRouteBasePath: '/blog',
+ highlightSearchTermsOnTargetPage: false,
+ },
+ ],
+ ],
+
+ themeConfig: {
+ ...(ANNOUNCEMENT_BAR && {
+ announcementBar: {
+ id: 'announcement',
+ content: ANNOUNCEMENT_BAR,
+ backgroundColor: '#0074d9',
+ textColor: '#ffffff',
+ isCloseable: false,
+ },
+ }),
+ image: 'img/logo.png',
+ colorMode: {
+ defaultMode: 'dark',
+ respectPrefersColorScheme: true,
+ },
+ navbar: {
+ logo: {
+ alt: 'Hindsight Logo',
+ src: 'img/logo.png',
+ style: { height: '32px' },
+ },
+ items: [
+ {
+ type: 'doc',
+ docId: 'developer/installation',
+ position: 'left',
+ label: 'Developer',
+ className: 'navbar-item-developer',
+ },
+ {
+ type: 'doc',
+ docId: 'sdks/python',
+ position: 'left',
+ label: 'SDKs',
+ className: 'navbar-item-sdks',
+ },
+ {
+ to: '/faq',
+ position: 'left',
+ label: 'FAQ',
+ className: 'navbar-item-faq',
+ },
+ {
+ to: '/changelog',
+ position: 'left',
+ label: 'Changelog',
+ className: 'navbar-item-changelog',
+ },
+ {
+ type: 'dropdown',
+ label: 'Resources',
+ position: 'left',
+ className: 'navbar-item-resources',
+ items: [
+ {
+ to: '/cookbook',
+ label: 'Cookbook',
+ },
+ {
+ to: '/blog',
+ label: 'Blog',
+ },
+ {
+ to: '/api-reference',
+ label: 'API Reference',
+ },
+ {
+ href: 'https://join.slack.com/t/hindsight-space/shared_invite/zt-3nhbm4w29-LeSJ5Ixi6j8PdiYOCPlOgg',
+ label: 'Community',
+ },
+ ],
+ },
+ {
+ href: 'https://ui.hindsight.vectorize.io/signup',
+ position: 'right',
+ label: 'Cloud',
+ className: 'navbar-item-cloud',
+ },
+ {
+ type: 'docsVersionDropdown',
+ position: 'right',
+ className: 'navbar-item-version',
+ },
+ {
+ href: 'https://github.com/vectorize-io/hindsight',
+ position: 'right',
+ className: 'header-github-link',
+ 'aria-label': 'GitHub repository',
+ },
+ ],
+ },
+ footer: {
+ style: 'dark',
+ links: [
+ {
+ title: 'Documentation',
+ items: [
+ {
+ label: 'Introduction',
+ to: '/',
+ },
+ {
+ label: 'Developer Guide',
+ to: '/developer/installation',
+ },
+ {
+ label: 'SDKs',
+ to: '/sdks/python',
+ },
+ {
+ label: 'API Reference',
+ to: '/api-reference/',
+ },
+ ],
+ },
+ {
+ title: 'Resources',
+ items: [
+ {
+ label: 'Cookbook',
+ to: '/cookbook',
+ },
+ {
+ label: 'Changelog',
+ to: '/changelog',
+ },
+ {
+ label: 'Hindsight Cloud',
+ href: 'https://ui.hindsight.vectorize.io/signup',
+ },
+ ],
+ },
+ {
+ title: 'Community',
+ items: [
+ {
+ label: 'GitHub',
+ href: 'https://github.com/vectorize-io/hindsight',
+ },
+ {
+ label: 'Slack',
+ href: 'https://join.slack.com/t/hindsight-space/shared_invite/zt-3nhbm4w29-LeSJ5Ixi6j8PdiYOCPlOgg',
+ },
+ ],
+ },
+ ],
+ copyright: `Copyright © ${new Date().getFullYear()} Vectorize, Inc.`,
+ },
+ prism: {
+ theme: prismThemes.github,
+ darkTheme: prismThemes.dracula,
+ additionalLanguages: ['bash', 'json', 'python', 'rust'],
+ },
+ mermaid: {
+ theme: {
+ light: 'base',
+ dark: 'base',
+ },
+ options: {
+ themeVariables: {
+ // Gradient start (#0074d9 blue) for nodes
+ primaryColor: '#0074d9',
+ primaryTextColor: '#ffffff',
+ primaryBorderColor: '#005db0',
+ // Gradient end (#009296 teal) for edges/clusters
+ secondaryColor: '#009296',
+ secondaryTextColor: '#ffffff',
+ secondaryBorderColor: '#007a7d',
+ // Tertiary
+ tertiaryColor: '#e6f7f8',
+ tertiaryTextColor: '#1e293b',
+ // Lines and edges - gradient end color
+ lineColor: '#009296',
+ // Text
+ textColor: '#1e293b',
+ // Node specific - gradient start
+ nodeBkg: '#0074d9',
+ nodeTextColor: '#ffffff',
+ nodeBorder: '#005db0',
+ // Main background
+ mainBkg: '#0074d9',
+ // Clusters/subgraphs - gradient end
+ clusterBkg: 'rgba(0, 146, 150, 0.08)',
+ clusterBorder: '#009296',
+ // Labels
+ edgeLabelBackground: 'transparent',
+ labelBackground: 'transparent',
+ // Font - Inter to match body text
+ fontFamily: "'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif",
+ },
+ },
+ },
+ } satisfies Preset.ThemeConfig,
+};
+
+export default config;
diff --git a/hindsight-docs/static/img/blog/mcp-agent-memory.png b/hindsight-docs/static/img/blog/mcp-agent-memory.png
new file mode 100644
index 0000000000000000000000000000000000000000..ae00fd06c3f92beb2237ffb621c93f9510948ea1
GIT binary patch
literal 387693
zcmeFY_ghox_XQetX6!O5Wu%VuP)Dj#9UwvyiU|oA>PVHYR3jzMR}qB)qyz*6qy$KS
zAe{sV4oC@AdMDC5p@kAia^u|R{uB54oIFYPPsus^yzkm;t-a5?hvvptF9}`(0039P
zCPr`o;1_QA^WPWFa=#|uQl|iC006MjpNQulH(2OomsK<^gq^kAsF~7T()hwSPe3hw
z%mg6G|9_Gfl)jrs=Yt^0rr;WnE-hh^P=(kwy?`(s=j@%2&V44L@jmDhS0k@lqiAgn
z;@D{01VAwM7r{n)waem-XY_EIJG)L(T(y|+cV_{r3@`pn}+|NGsofo*mc8mY*%;!^fF-EnC~RQ2jdif7VsJVgIQZkUt^DS
z;?8{gSL8DISAa>XLN-};kn}tVDQxEuPPb6PbV(WkUdsQ;<>N8FPFybjQl3wGGUf%-9-N?qIIzzx*gg+nUoeoi|Cr-wV^nqe
zqDeaGr!xS`^_b_B(VGCkfsTb?wEs5ptMZ{PV7qW)HtwbUfxKgO`O;Ycf8iq~
zT3^=q9q<${zqWE}jE45kT?W*h6+Uwga7v$_0ep{K9qj|fSC2Ucp-BNX3bjAZ
z_vc>$-{YUqKBwQUyYtxcEFh{Db7^ch^9AbkAQwA~`|AJWXR6kI0@&qL&<)S)i=B!R
z6#!o@S3mkQCjVgq0ujw?*jIfcrp&S8>^ZOx=p
zCxEk3&P6-#WF}6L4gi3@E=jy3Hun!cpy_QO!ruj@|9i(8IedJ4kqqe(ee*x6p
z07*gbEa>>gJZ+DbzNyktEgMa_0qncRG>SjmWH$t$6>Yy4n#M07Tk2
z)QhbBt-!nF#^?S80HFQK_aoPX?V4_h;=H#>XfNz&gTJkXX0LR
z7hL)Kg-gK6&$p>DUVYQMLXw-I_Gz`QiEq*z-Dfl;U-Bt9V%DQ*Rj^
zFVmCT36J@?#!*E+wAw&^4QkphNHTNfsbw7d$+Qtb($JgC)0asLqdYx_Etg-qu`Kv>XUGlO!M}^
zPKOt3W98MG#
z92}g12D<*1|Dh{TXZ(?^Z8lNF-c~<&VFf=g6Gyc06|{A{mCP??(A8JNald8N>c1V;
zXm|XrqMqZLox*a|J<4?CygLIprRJW!03f2e&}*;84$ntySEhua(wSeOG
zL_`BEGx=d%H{Y6F3e#PJ$szm0s>7lWe!d^$AQ+?gHnny1#^en^>P>iYE=b2G{CEFx
zL)*~X?M~xB{_8mX*|m!I1~{+j{LXxxg&`PJwBSKHG`33K2eND!udB)#XyL&y%4M>`
zmNrP6rJ2*mR=zcPUW$?+qdS|7U!rG6eN*5B9V8MfXOHn@y}8-$7_q0Q+%&tSZDAL(
zmu?PSA5cTI=K4%-&to-gG?nEX5NP~1Ay-~MqKQ&t5gyL*u%F}!UjK!mB*a>oti5fB8?Zsv3*|Hrf-`-5^HnbM|sFp
z4X?4=Yek>0ZMai*JC?=Jr~Lu88RKM6#2R>L@CNXp=U}bOV2P6pPAvvPc{Uho&nhIo)*M4Uy5lfQasw-_JH!JiZaHr
zV`$%WWUHsO&%OH{aP}!G9KaiMDZT5b`{&O;1+)H7DA8qPd4^THAdJs`^#pVqWVN8w
zV3tQx(+nD@+5biwFKl8CE9)|k3dN2(k2QL0(fo26z0?+X&F2IGp%(_q*3%S=hx&I-
zuiGdzV^aqg<6mD
z?_>yU!ulN-N6)iDwj6iEJ3{%(G+8~Jb!}GwqmtZ8^1T0uxgKP72T0|!ag&usuX;bj
z*Yv>ax{|=eUhZ87^Z2Z1m3?G=Z**jCw8ZN&r`$3K-g5m)bVUpWDj*~~csJvJ$nj@eHry-{ASXRUsSAi&J4;m8I#7(yKT
zxTjwBoJ!?wz{FuIOi9T8pD6{D`(}gMJxv%{i<}WB5;`7KNITlCrv;8q(*id-E_x`$
zMi1E4$O>#GHd1U-)LGTUP9l#8cTK;=S%?sv)H`Z~RfK-IJNGw!+o0Hf0XrL%6u
z$y>NiVLH+V3|B;=IknY$oxHwFNSVHtMc<$S!{z<7^V!T50kPAs)?(=I8wcJEkBu#Q
zOFQ{H$Dy`Co3azIn)iuyZk^}Zk0I_6$Jk{V8oHt;m`Pg9)y<*NQF`=H1s3sffwu=$uY
zZ^F%P46Cv20C`=sBm~%ko&@z~MWuh}eZwGpK(b(E<4$SQ38H@cli7`jS!Fs;>EVZ&
zljHc2kpbolubSe-Vwk(AZ{pQ^(fQ(gp6Cg$=MQ7PxntNfm}kk=3A%hemRX@$)}Wv#
z$!qx^dID#gZ3Y`%8g|l!{37NvY5Q%~5qrgD#hUqA{9d{EB9}#Ux2F(ey{H%hUxUh;
z-2)cq>+uczZJigs8vjPhHc@G7mCFtIe+8WR64Rf1yi@VBKQA7Ox6DL(pi}-#gqZlG
zP9{Qjr}LMivwRu0Vwep}9-Y%jWenrAVUIDdajzm1nXW*B!;w<*z>1*KMQQn5!k*L6
zw*UD7$2iLVP9#t+)kAjrqUCFUtJJ|dr5>F{9TD6_iQ3+PI)CM)-^}wp`K{C0(T3e1
z%{afrHjov97lx9@KCF0rY9=e$D!w+3f%oz^&5YWTJDd`(C7d}^_p!_Rn!~P43#QQs
z^Bw}~$3H_QB2};i{j2I_jFSEFy`8PT@HIn6GQFQ$2m_@u2A-5?^#o|jqkIWoX;i!G
zhKptp>3Gz9jJDpd=dd}`-)5}Eb-MF3DmUb;Tr!8`wD7W0*bm8e>h|jEaaIfw%^Cm0
z*ip`k(9C{?<)DzKS^ksU-ku4yNPkgj9ckO2?x#purX~+xb^TKi&RN{6R1Q;);Y;Is
z!$c65o^H?ikMrM$^Daj4rv}C3ODM7p^u64ae4vLqBkTiXz1^t8h{anXlL~n^64qcl
zyy5cMh%R|hQCBA@L8_P_C*=hdNJwpz$&V1)Z8-BDqRIWgH(HU4;(@8WV5dLu4Wwc%F7ArS4@2jwZo;q?R*L
z_1a}gVo;B~w8pK2N!kI~58XAbTpy6H?xC>gW))A!?NGr(!V9a#)3o$|1#Dv6I{owK
zzlo7exVd{8D-JmO(rai@NjtSwOyNK}CQ&$&$LwxiMWNXro
z7uuV4v6XuoZ8A$_qM|cC$rXwkp;j=Ng3w*bV!rC=;t&3Xb+;X;Ig&lAA_jwQ3$S;-aJse8NQrZ%O0nn*3>qhe%M^fvrO`r
zU4B^6&)zh4T)i2ys^iMx_d$cm81g@teg~vhZg{EkDx@slm*2EiKQOD=rHluRebYqc
zbdbN9crm|?X0bK1kH(_J!nVEYD@zHxs|hbDv*9X46j?c=Cb4{N{puMt
zV&R+Xl)bG~8YN`}$IP{?5*!)#mO^+x*RX3DubmYL|DNRp({v5Jr33h$Zot)8qealO
zpB6tASI~=3&VH)+*gFXXeds~<;7I$kCm|8@64}h}EFPVSMPDDmpy`E#-Ts9n7u;8c
zPP-J>OvFM;)ZZOoy~NQ9o7>ge@RV`f`Cpa7w+rCQZ9`PJRq|(XRYs|j4h|unyPlu8
zrX>!s&QF*^j#4Y>-o!o)x=on_+HD4uzU_(%iF{&Bv+&
z(h~YFa`*DlFk1yP`7%S2MHqq5d2hL3ha7hye$I{c+reAe&REbR9mjeWOE;%Sp_^A!
z1^e(~8YvBB(rMy7^2CT-^xjk&fiZ
zQuySgemvA5#lm2t>t)r)-nx}rMnCfUqiEGVXr1dMTvHnrp83C8A8RBQC1u%r4_CDj
zX&F5=l%^3wslhdI;&?EpIWk+JOgn7{3ooHcxB+VZSvp>>Yt;rfmTTYVAQG!g4}H=c
z_SV=jaf02?Z%N||dh1bzasKRQd>sq}CN@iHsw2BKb|Zznm-{gE49r$(8KqSnOIYDW
zDJ@z7fp)F=kl8L7ue39Y1yd`DCqKW8bOkK582tf;-@0*Ck*qIpb(vDN(vq#7nr>qO
zZhFy|%03Ro&}R##iI(%oM-#QLnGTF@&}EN0$ruo)qP2e4$=>eY7u8`x*>j1|UoNxW
zl{DI_Ch?(Dq7w=4`+{Z6LhT8TT3KvH_Ho+ijQ{D2!J?w*k2)@>dr)lhfoK?Y)=kfp
z?|qmuK+Z6(?Zsul=Pwt~yKa0tY=05u7+XNX|3(pJN>
zU#z8awp$MAY8FxSqmBobhlH-oAs}Dhc;1yoRY9lJ#xu(Nk3nnE471lSQFgk=LRSxaJV2rghHlvTH8SW2%RyG_V~J!iq{u%+LvxIGMywi?0K1cjhV
z=hi9+Hd#!R7W!FsXu!W?v4Fag@G}n`On-ug2aCXEf>4Y{i4|ISK`{Ko(!kHF5*FU<
zvZlTIrce$`+jwM>YUBVk&7ow(Bi>vo>iegG?m2>SK=3JA83<7xxwty&u}^uzo(s_|
z=4`G2C-vL(!j7DinwwqR9{bnkn)^#x`>OkmxD>*xgJ+xLn~tyQpXmC9uNrv`AnbwK
zH_P~()p3ED@$D)}kZhYs#_*rSMW_0*luLl8rMG`zXaDHsmj+A3?T5*qTcx~uy5dgq
z6SA>-><~korN-d~x+m0z?G_vuCj4Q+On~YWqm*O-rR=od55DHKyfb;(JeO^(lQ0O+@`-V
zX_SpD6c?KNExxs-Z)vSdUMe7_Mm8VOl{oQ$RIIo*FjCoLE6t{}zs9o{iX9r2L|~do
zqxB$2;!vbGf+6y`QtmQd;oR>cD+NCR>PCJrqUsg&xlio7$VW!6b@-QW1RJ`ggWYj7
z_I?s)&yW4@Id>ubaIe(?$xR3!&WDHM6$W+(o;|uI-+I#f
z4dlQZm7Y5+cFQ&bL!-Pvr=5IxrZJhZFmrfEkoeNrF#ti5cJ|2}4O<^OAkmKtQdu(k
zC#;a{Z$^Sp3E+~MPt6DFl*f>T(t*mA5>%Bm?hF?RUr+$DcK7m!Fowa4kW#f&ty((DNFr>(z26Q{gc5E
z&juwNvBX;M^=gj;M0q``;P~HjU4WNfyxexVT?|)6Ud1e#P3C(JWm~N@kwrYs9LI*5
z!st<$lPqODJ}>lUekTGZZ)&gFiFRq#t?<&;3bJ3!LooBs@b7w0XcvC=J|#8KE}-mm
z6pq(XqVn=KMmnNh*&Bb^u19D!kPwMBmNM8``6W59ZT&E_|6S|dTGzuJ
z{jjL)$?PC{xMM+$w>~X5D!7y=ml^|g_0L7|FGo7iLIbO{B&D^1gSR!UTVLJ
zS`876*v)QQ*FDrd`nEq5wD+Q6+y$2)PL+==d0niE{X7-22fiarpIBdSNUiZw*0`t~
z19q_x<5&q@nENXz^J}d2WVXJTZTeNrA{9f=V{lY%h%`7JVc7d=0vt^v%~A+
z8vXQoZ#ycBZ+gi};-4Q;Uj5Z#_J-PAiG2!g6|axRzfL}}{5eGd>htk#MLC*nS6dl$
z+O~e$oYb^kGs@Wr3EwMqE(LqRk@+9723b-;{!~+}^10t%z_}pU2q^mMRBg568+Xl(a`oOKtO%_bo;J^I#X!%2#k92!#u%B@^pO&0%$`
zTt
z4>*zfQ!8ID%<-rD_&P5ZZ3oE0jTUqv?+g+i9qLaQ=5&5Lg_QnK7
z&}1xJeI{&+7BOEOaT;3|+S8+H1^3w9fkEJ!^fg%ZDVVFW_5LF)n?K(#7j|=CQdMxz
zt#PC(`OM3#t5Fl
zR*FL#^f!^byYG#`x8t`T-tn^RJSljo%Nbr}|7LLSR~hh0++U14@5PQJ)?G>^L5fH@
z@GQUo;*D5^sAaBsNA1TZ7v#Ae8qMG}`Wje@ey4{KYl_MlPZX&#sL1ZGe?5$foE(3U6e=-}%xX%nf{<
zI)ngApFDbTDE80v<=4$b9l$Q4p${F6*EguAyQ8LDOsu-Q4e;_?Gm@Z7NNG)Mu7-SK
zMf`$j3VeF$3He~iB(Gic`H7b!Yo2!4=to|BlQ)1MM6aE@WBHB}9>lS%oH_eN{oN1s
zXC{?wxLYJe<-P6}>pxg{uU_w-AJb_>|0p(;c06NY-R?J)9JIv`;_r%~x+>$xC!-(n
z(&>+P3S(BC!h;7j(^CXOfP7%Ng5ckxE9){Fw^zO+$|9^S#X*?Ft`sDrzI^%EuPO|
zV$QP9b9s8JYT^$jfUBwB*Jy;qdzrJj_;+&>ngnbS%qzEI8Skjux@!R+;X3UzYvKK$KgWoX!T7p`>*ylD
znpmRp(l=-eA(w@j7(>)$6DgsnCs3L%%hl)Psz7F)F|F
zMG|iCU#ff`jW(%xCG=tTTGyUl=dwH8b*48YUevyCIV)^EQdD(99(iD_tO;@oJy`
zE`9#~c&620%m4YhomkUA3xV6ls`&BgyTO4CjX{B-2b!4OLQbh4rEy|7D2Y9UnzZQ^
z^$kkw^tFta`JteF{!`GF?*`Hft&rA;dO7f&RLI!T`1VQ7J`WAuSB5#789#bLlo5=D
z?DJ`*k~g&cG_GXqsO+z=Higt(X{6H?jj6&qw`R+Kn~K<0Ixv%;guYF2tZn_XrZLUQ
zm7bv-;53I$>%5DsQ57o;uGt$32_J-V_L{bxX%z)|vG7$jVoKD|gs&dKv+d=X=ME^9
z#S4c6Az-Tm@6~_SU-fOB#?#S(-185csb<^-
zjW^yEzxOfRuSt;^zb%{O9#0*3YoYwvIao2TBH}bPui1`QOClzZeRR+&|9+
zFT@WDEGKCx5t(ZRw0A*PLb4k^HJu2FF~5Xc=&BA*FrO6c
zzbeISbp?f%{hZppX=D0+M>gU+xtbx7wCNx6zNcj^V(v5I%`b*Erg*03Cw8bnXig$g
zr&)!X_hG2IbSnPi*oW*;H|OQk_@;wl&T3y+d#QxF_GZ6252zQt<{T75{04ZM@Lmva
z6&$n{Jh4e|SVv&kQ>RU=Y8rdH#X`@E63lE%oE#syhZ|WZB$LH>gCo7m8p=12<5wgm
z4|`07nJj4Q;i6IBD9arqz}cGX9XuZB{qwx_m)3`${T`ihS<4+q*=D=ME@fy7t+x|O
zH`nX81S0k~^-tbd3#U#jZBY9qsmql*x5|KZU%4)S(V7tEGT^&~iITtHiGO<0T3R57
z$ZmH$=`a@4+gn%)W4*BrnB4Hr%CHMzZH@elw5;DXq4DQoEFHRC#d=*7EnZR~{WCkS
zV*DEP9iLLKMqMrZ4FY?FDb=zA!SWYxt2HV1~fnM(AktW?~gE>WI@5>6uMWU3^#@y<5zkb@q6>K6-vrlQm3ln0K=j
zaX?`M!0OsJ0DUd_kn6K%*62)m-2{e(-f52G$(#UTP&sY$YtcIxB-WsMa;&R&YaLS7V15cmGW9C(n2q!9zum!1>^Aquj*Z@1`L5y<6K^Q$
zczI7FmEkN?ldWCGpx!kLsR>zH&znAubbP@HEz=G^U3NIw?JVqHB#SQRqI#2}zlm_I
z8p!G`mL1PtCbtl9}64
zA#d8+t>!Iwnk%GG^YK(Ft(kWzrcX3nB8M$kHU98>08A|U530gcv#u!tA&1Q`LR=%+
z{-I17ET7*TuUt#7e%4rDKkp@^?O`_^c%mP+Oy~5vXOCkiNW4_m`_c6?rye)tP?-uk
z!_t`vGtc^#F(;PUbaThrVb@q0w}L6WDBft?2N@sb@y`1BNr5+xk=W>B-87+eW3Mw0
z(rO7t-s!`0J{L*W!Woy{`6tbrAzD=jX0egrp-N*mVE#TYnws)bl0{Rf*z>ZCgYu
zQmm4#64BFcpzfmABFrq^WY60wHaYAr4fsPCw$oF1pzvU{7@3?99KCz6qFJ;Wi9
z%f!qXOeg58>*(JPd4Za1a;(|ZELJG}lofXR#+QFLA=kyLdjghPihv|R_jdfgKoHl1
z7Ual;K(HBnekR?0Ps4b$(_auv%{P5Og5VN$bb!cNV7~cvUx@G4EPuG+6MP+?#ck_@
z4maFxk?vGQ!y_Lg)+bqg&Be@W5S>x11lQk>pxvz4*U^93B{w`+p(@s;wxdMvtXP;N
zh)(o!SWWEMDBJOT_>-9)J7%6b^%ubDv;Pz-4CC-=)h0H6qln$DdhB>Q(;i%4T;rb*
zDV`Bs;u4T{m{fgDCQN1Gq1R?4di-i_!oXN@`Dl_`*5v1HLS4v~U@QXZLv5*>gAWC9
zy=-BerBR?+a<5Cu0}VmEDAg3EMkIIGdmyc0NFSh2d6DtBPJOe%NSZo$FJA*+es}0i
zPBwN!R0`BVc0!E+U5qXC>Zf(JM)i+M4|V1}lcWb3cGt#t&VI?3w)fRWX%3&WW#U3O
zGXZ*N-{Rr@x`hg*k|Z)AnHP>2FbO`Y{T5#7&O=I;Jba2pc&JrSje^oseQUk^6Rel8
z)I1{r++|l(Ds(WY(v6ZiIejA*WsZC9dFQBjKeLfiAy-oipdR8CiM)!j&J{m
zS!bD`Rkr4{n(%;gbf|ZnP^PP@9o*PoHGhn2HH)QE1O0_fH*HGb&x8#JQaKol0t%WI-M$VT?lO|
zmc47t!85m$a%CZpz}H3BY_DJSc}sk#kS!H?)iS^Z1zSr@Cwa{8pHP_F`p-E6oatK1
zu9k<>{CDBsUUrRu-k1$cqy$KeTc+
zb#uDeUu$~yo#nLK~Bo17F=?sY+Tn#6{2?0if8jlHWNJzl|($ZR6dHP_?30|=r
zY;&UMl{DHo*CrGf=SSKp$nb5LJ?iI@gUX4T5{vMewdUZ^t?P@@ZIgoa;@Isr!l!k>XNaQ<196nti?Q7JaoE%X?^Ui6~a%!M^w?on&X=8!cHmusGlriH1bk
z1SyJRmFk;gOlQ!SB6YeXNXeQR(}bF`9yd;xcEtK3W|1ZeUH_ru%>L7HFq44Qoiuij
zSlH3Ody`u1#ErbqxjOVU_QcK~W34T$&r#PU!6`!rQSCYn*J{z48OxbHh)Kleb!APl
z>F38in$xUATZiyN5n5PMoXLF7z5Z=fwc1WWpk8U1P5Y|lv1_4$vLCJ|_arNpXZi$Z
z5wR6xkwqgv-0;3xNmSP++d4h5cezw4>^pMRy@eQNaU)SHjTtA1QsGnXbWkIPgeX1H
zQPS34?Z7MR?|juineJm5>+kodm!SdI)+R;!aC-w~5!=r3ADg}*^N3Xy`N=MQm*w-GDV9#8Y%
zGaI!)DnF=o_oylf685!H^?)+x@+@@ry9W>T_rF%i45ye*{v6CSHC3OGh4G^B*otU444V{H+wySsM#PSkhic67yQo~T
zpOQ+5mdOPfezAGl@Yd@=e&mzhTFMf#tZDuz)5|8Q4W4L&H{n+SdhCqnw}#CMw;U9R
zZDMf>_U}c*9?+W(<;5BfyAJiyY;S~_Ze}5&QcV)v@*rQf^Y($Hl?y7d69KuD28q@P
zeFw&Eiil{Jj(dl@FF*H`nI<){G%>S2?Li82$8EW1jx38XLSeld(-xW>hCZ{w_rWx-x5M$4*NZC
z)truCmERmNGTf2?8i*3Y-$roDNhH<9M)Dq|&U@Q*rK`_7eD2>e3Oyj3vtZq%p%>&|
zsi+zmTd?E+G4VfyA2ca#*rKBZ5?+-FS}~#K|oqg{+#^leX7j{XVsC1x~t
zc6Ua9bCFcqiiv5CQB&2GV3j(C)9Dej(8|qB3C*ksE&3Ck0dKdYtF%o8os1}^un{qL
zJM2^Y4keUyv=t3%azPr>#Db#ju)Y(E9;3n@lbTcLlf&?Jt~bpWGKIjWNDjm02xcC%
z;#au}?zQp;DJ~vI^9t%Y6Ul)ZUJf2gx;M!59o42?;-LbA5Vjx8Kf&{1?0
zV7kb7ul!#7s9`un!RGWnNX{y`nJ-I`fqL`-VdL{pRluLHIK=!;Nv5B}5nhur%h_?C
znQ3~vA3I}EQJ4Qyz;lBq0#^anJU>(-UpV+5udT$+M*&!IUKd@Oc0bJie`6Wp-TrwH$e(OJMQL3~U*
zWo^^ZaJ~wXn?RiPolM6^ljs9&M^;7lNk9E0#dgFPE+vIeB(UWIF{NXyzvg3J{jA+}
zay1nQ&CG8#!^_sYaof4p`iyGK4wq{*2TZQ+LwnVbqvW>s;Wvc*;4Zad0#P;!mniKi
zDJBoeoXpoKaj{%xd=B{SfeKX6Aa_OV9iH|QN%~MxBJ88dS#LTW)JKm_P&FQms39*Q
zkye7icT00kl#2J}JfDl7JL~Y#DM9{&7BFfm8DW=WA_uolFRx$foL{@OIx6~nuIY#t
z!8(27l(VrGMi*=18~r!W)^Phe<;jBG0rJ}i|02=i58_h|3nTui1lV#lA-|#6%^mJF
zwc(IjKl)LRwMRQ-l{GP>G~gJp5GG}-2OVZ~+TC+_ZH-i@$#<256rgAE9jG+%sy90VRc
z%P6h`U($cbba6c%hk`-CxhJZeKFmQMyW75Y>XA!j=_4o#w&>wlqjoARjT6T{l;XDq
z)Y+^=ai0koo@1TN*$}~S^@;kwGF=n)`^y&N!&Y;amq7Ee-dxv`iYVCyJ@sonm{C6*
z|7TN7wP8xvRC*!}2uF_g%jVV<4ya>mg`9=#@178Z;yCsC%p}@jw8T2xW1
zbWs`2%Xi8YNVdM%wQ~Zwub=~8VrX;OPZd%w2*DHIo8kgztA`oph3;~Vd-K^Jka+M3
zds-Rlqok@5@r(y{p!l|>BH_W{RAA?A3z$64rC|G8m@!TiSD``NO)K2e3ttn6Scqym
zA*N<+1cpm>!Jjm$qzU4SK7`eo$)AY!OI_ZcIlRK7hd05&P55_9(I>A$Xb1M(_jw*2
zM*PeUF*G~;V1FlRSv({N*{f$AD?Ml_qwJlT3KcRQ3TE}Z*mr-e{NjP`HJ#TLhenZ5
zx!pO>Qts^QXuCc`BxKrOp-Mv(x`$GoEE);?Lw*o+2ml<-|9F1dItDtTTu)^GYWd9L
z?mt6;Xhc`C)^PoRHjOjeo*nTZX@2;*@O71>P@oi~e{|ESa>b&bV;r5I`OujFFaEGB
zg7ol_%%B%!s;;{(x6_!LoL-BtJ*XrdAr)&}UHs&^7hRCNUl+J@!U*SaqFWs5Me&H-
z?`g?Tju{ersx2Lx?|4M4cMP8Q;cV#APgc(HRL@`a5w?^}GY)*LN7S4kR{4~#7!=61
zp4>jn+KjYQxVG0fbGUdIvAbp4#CYSvFiEeiPx4gUY`kLC)!psbp$n+9+Fk*
z`g{TpNX7=FTH@Lm@09f;`rP#$NgmScVLRsv!ZU`hGk{@_T%Ex$JY;oRvtLq>tPWH=CnleKpv`(hf$oDv>i3H^C*&NZb`
zPylaKs1EIa5)!IIBZp6O*7{hj^zdV5dZ1A{VprNUGZx+ydH2Yd0*i6T@LdELp>|SZ?ozebsmp
zpL|S8aZKC&D8vHECbV5F;^@2s$8t2I0Fnfedc!XiV;DH&=xGt!C;L($2ZZaR{2%4F
zl)~J%pIz{RnO;?@19a{%%^t#Cd#dS>H%6&bLm^BFHzzmVQ)-R^O`9T%AkiwmwS}b6
z@qXu~?K})SYD*^wVUtSUv@64XtWRX}>)?!t;-r(gZ`)6K9A$o)kY`^6`wKy`n1A6i
zHRpF$UVB-R?V0hIZEf0ir#5DF6vO&=xz~Drhvae{yB4(gt)Y@2*C`cgdMDh?d%ui4GrFI+oGZ^#9`jI
zq%MOz@+Bl_#DvaVanH(<54DE?_ekX4ZgFu)`5OAwi8x(I;fk4gi_R2OU5SxyF%+p_
zy)Nn+Fpw4A!|>v?VzvYPFvrY`9(hj;1*6t<4%Ie9H~d%oK%*YcJ20i=hQs!jeJ465
z6#?%jueuZ_2fRjMoo!k2ea%rpdnt!5+Bz_td-HZ7uLjXr&@dy9$H=4zJ&&8}@b4Y-N&wa+-X~
zaP0xEv&b5H#l!4(UR-aT7T9|qIqk?HZ0$!Y3@(Vl(v=5zA(aOZIOapl<)W*K&fg%~_HFRD)2m`$y28?;hz{
zTWIjCagL*NuvvkyOx%p7uUb%6G>b9k}^6lIk{e<`-xMRN|*rWR&+
zW;}&_`dkHF7x$*2W|$qHvJ+Bm_+7R0kF;X$B%d|jmHBWUa
z!7fkYCf3Tsr2mAvMwAR#gbploJFQpmJoLMJu0~U(B%6nR3D2!rAt}nWp6g-8
z=m=(~Fks$*lm(TDs-WZt=37d1yfE!6k
zm94oN;&lFTN?zbsAOW5-e%upe<@5IX=Y<(jf5~R}J33*4iHBjQP#*gaea1qt*y%>%
zdh$TU)rVW;mZ@xaYa!e^x!icTJ3eHO&Mweq5AcMKhBUa4l`^+gqRmOSO3kqO1u#e|
z#^bk{y3|JKw-b$@BB)VnRTUS2U}x@A49x6CLX}>e+eo*Yrf{i7ekz&06dz8rXke??
zn!_i!qm$S+XRd>k9<=va`0uB}pkohIQxe00vq}DM0KB3g9iqcJ@bkFiz9dI7NF{VMpsYe|Z
z1T`~QU$7%Q7PEpaV=G4-xcg?OCJo?i_Kr=#g!%&IIM~kn#gDmk#3n%*zuzD$KAzfv
zX>9i)BD~zK8BcUX3Vropp^er-Gw7Zj3C>JBdpo{it9ld|_d0gUSx-5f<1P<>&FCtP
zM&H{{$|K?K`tMuv=kjN!tjo@;I-=aV
zxFF+qn(wcO?3>xhaNSq!4p*MA?y1uM#fJYpqmumQ
z5wt~kmiHvi7v;X5*WYF`Q1tbMQag^b&_`h@*3z`n{IHpqNr41~2VktL@_Dz(c7I{k
zZH=psXF4YPCrCvzd;JzQ11>&>6*_@(PCREzQX1=AZb1a_9R}C)Jcc1+O&s}npH1J$
zlR(yhhohr$Hp9iSO4nAhBeQr2SoqLmc%xvmRAO&QQJKUQ+N%1y6*i->4HJs}3p*1<
zmA=N@LCtWQs5PO%YUjzWxDc?QH)_5pCVM5#MQ=l3!gVZjSyZ^+XueK!sIl;iy%^A2@EA7Iwzu2|SymU$xT
zru`M;*HM#u>`yxtbr%8K?eRZM(Zt1#zew;^?W>17hA@cqB#_y`TBdLp;EPtl3
z9TJy3QR9>TppSO0!zKD{XN)ZsblpESowzkn_qF#}yI{WQSXF-~yp|X%B$A{+R^!fe
z`j0-(^;EDR5Ga4P{LO#YDnEBX!~}zIky^HrgOL*h7AokC;Z!*kP9f&a8&tO_b{P@0
zl&MqF(VWlt2F-8US*CCnW#Zzx6p)z&;VkSMvKUy-@U=^n0_WBcW2@m^Y?4?Ly_m=T
zp#+HlwTRfr`0c0ft*c*PNd1ShH*e#gWhTvV()xPalRW25(ln!9K!poN1SGx;3CO(A
z=-Yzv;gOe=Hv`=dwSDVZoYP9o(xNjm7O_xmEx}!2kpy!MwN@a}4(t}hwfAfm7EuX&
zXg}R8<1=4(jeKuWZXYQ3#yEIOBUvv2gMo$)P_Tzf#e80W`o8}tjY$=IG2c@woTfR_
zlPrXWscNP{s0r!>tr%G!S>9(jT!M79*$`uDU0LV!D2Y3H;a1(nAOBgOULe_v;Q|%t
z2Ngp)m|ipQI^65Ly>2?rNI0SR7vw8tbmp9U`_{Z4`xY^*N9eH^6|5&;PJ#t^e#Gp!
zN9-zUu0P6K_Z$y1w&^y}NR=W*q8)3Jc+}D#*=f)Jj
z%QV88K~nb2n%*9^JtV)R6Ulhh&CGF(5dg_>&Nxh!_`R+a&Z$0<*_??C#wqLGCAZbYH;qdGCZ%
zQH~{F)+`)7V2JT-Y;^7dA?!o_Z>aJMqfu5`p(qH3eAk<{VHCiScX+hmOYpZN6IVF<
z0+_9(XM*b5^B$Y`z+B%!ASMIVp~5#0*xaa^pCBMU2Y?iv*YO%IT2$=BOtgXpkOL5t3-B|qSD_HTGt7XIruQxo6Y
z^gf5Lv&Mm_1b4FsQYUWfV$9~$J}CMq`}gs0K$o%iA6zK4Qs=gF=Rq2$d3s}?x@~Ih
zS5O)R!qmF;tVUhkqMn9L%0QiM*Cg)%;EAxPglCY
zeX*|g-GnKpBRD6)EF8D^?H^Mq2v90DF$VN3yVhrN@kV0CluJxJ^sCd~n`KHawg}7g
zE;(w+0%7oK!KiS*BYRftLwD^6Bxz|cp&=tgDkBk^lcPK}>yTJNz*deX^+;nDD9S$I
zC5q{Y{fP2DgC9pOB!jG?gr`ZZl$HWLt^QWZV-@emWBmsmRPzLmVMUW
z|9N%4y+3EpnVDR#Ej6{
z=|1KL=}Wc@!|E`A&*Jugp>{aS?kxWY{rrz;wC$LAItzfB2m(pEg%}elgl7tETy*K2
z$y1?D_iZ{T=ovCZ3+X1ycq|2jJ!C<}6N
z+99Z7>3&b`vgCnXYPy?Xo1|P@PW!o)_!qwy2BP1;(2>UQM>aLmo=dcja3jr3TWGrx
z8|;5}N0dQ&770*QrFdH2tM;r>BhyM5(1is!pgRj(f+W2hJ~}H9D=cL56jTsHw&7E%
z>2=cGO1-Z7f5geTsw(9cv-Z{3O!m{mf$c>}HwP#d^7)#Y`{0=dSvKE|-it)_>&W(7
zi98m@iY7Jh4iU&EqP~@4MbN)P3`;FJ)qPL@S;D(MT5uGotpLz%4VmOfJ)QzF!f%0|y8*E>e
zbnletO1a{i6?{dxK3_9&hh3M97FW-D
zNZv@TXim6muaR~fHms=Sb(At{!B+R%r$t~6NpA7a=*;j?{Vtj?qxBd}q^J2`H}aiE
z?=D?<1qOXhQMsH_x`#6CWQn{15|PaZFwohL%#k8zs>za1t4=mp^0f4}=30XnA}dMQ
zT@K(zCVBbn4nsiNtspR6I&^Q2@NvzJW!$AtTRI;ob41{u#^R~YEN|72c(+O2-gS8)
zr9bhsD)yhlN~PJXkhyP`etMvVER&Li*!gALS;z6z{%Bb|us)iZDQg_xxZ&W$_5R&Y
zRWe4wJ3PR_fY{waq)-Ld+Hty|AtU=9*TLTxU6~eXl#{2jtbk~{auHXN^W_J6_S{y#
z5;Sj(21!)XadbmeYqy$kpu2$>oXk1!^oOQrrDkP?_Yo|$eB*e58X|7p)U&3qu2ZGJ
z1l0#XfBTCIrEZZO7l-7JVu=*;RV%xJh94<(D_gTgxda
zc-%NE*zaoerSz?_D?*M7+pitX)n9LlC#~3MR-_J{RF8?6zyZv_$|?1Y0zj5vS~X6r
zDayC1kbf?|=o#l1RTUm9E&=nLPQfDe0pHqope9(qr7?;3*$U=qWjoMpaI$M
zx!uQ|Q`1>=Fz5u2D4bMv|6pUJx71J`lh0#~^g4Z`8rV~;YzHuTELN7Ri}u=l2&uKn
zSI{v-{M-)0RhMrDsBdzW7f_irk)lwarn4F7R2Ym4Qo`HM;Q7=_#>dr6qJ}F_6z6zW5ROe23?V10iqb#twDC)uR)KIC0>)nc*k&zVF)|li=
ztBO<&ieGnEEmYy^BWu#5)A3ETdG8$oge6E^J)ybK)2e^Q`d3;_(MUaGo~~Ik6f%OW
z_cS7v6C4E0f_SpLa$0+jrkpz;@fXv4Gc0Qzs1@w8Z7Z=vd^i~olo>7cxGT>5uL~Qm
zdbq~fD(fbg@{C=agJ1mKBJF{YA>~ns?2IN9wSq%NX|%ZPOOQkO*X}}BU`Rk$5X*En
zxU`ukspOnlQBW9|+bCF3X_>rAviM|R><6!^)!CSZWh-hi5bkMe0n@NSrV>Xy4rZ`C
zMZFT%BgMF`v}xe5_w~fe(=NA4frz)0x2U~BEfd8OWcR{+sX+K4nIt}+*nSsqNfTEx
z+Vf%XE)SkS!HW0}lrpVES8yf=M^$4$JJSeKOQ
zQie(|8mLA)x+BI3vD2EKGnd;I6$R#NvJ_nX1O@5g_pQBq8?ps3eW(4jifGLxB^@_5
zwrQRFr)x35(w@~)Wiwr?@lry85Mp_yCS$$Lw9>)%)e4P9az>%sKdkUi)Uq}rD9SIn
zO7mS@rFMGbLglVjw!&S&R-fOFuD$4{z}XE=HP(Y!f@`}$*Ju0&rnu|}!$Dpm`xak6
zFdTx4=ude1BbSXV#mpk)Pjsg)&R$n`pKNr+4AHu
zuQkP^8&%8FCSkOFw_|L3Da7DNoYu|`_2cc*deGTfFu+SuR4oN$f#<7jrPS?J?bsnn
z$D{4Wb!VpJ!)8k8wR43HU58~i1Gx5>O3W?+rSm#W7dYr$pWD0C!L7vUJWYNH%Ek|W
z3KDx@6AyGs7R7Vvt|CWnxPpqM4$=fis}A;7jCK_#a*a3hT}Su#k0yaTA2mP;hAcN7
z6wYJS(?KxCuM3wL)m6Gq^UX)4*=@UO-j14S6^m~ma1|%S&@gh=0~IPJ<_w5!u{Nq0
z0*%6;R*jtTH}2DUy$9pN%E8x|bpZ?5Jx88mK6k4&r5erZ6Pj5p;g!-)T1D(aX=Ufn
zwOTxvJ!HYx-N`a@cU?~%n*yHK7uMu?2}`_rP(GpJxE)7OS`ucRl)rTfHi|@xGfq}`
zD#*vYVQnG};F`Cx3Y*(e>A4;1EL8^rj-qMYGj!l#a&&#Ke{1!1B3m;6iH}SJGn?wE
z5#}0fc`LIkHF_k*^Nb79bah&nW{=xCZvRyryAdb2%OzRPIu*dDmI6WJPPv-nRhxnC
z=FIT6EWm&;(y_1EaN-*afhVe94vSFDU?1nJ@!<3CDk8AI%EW7{6-t#%-%tzw3ZHg>w#
z$P;6#IO_-a>yZ}yZQwcIHV^z&4bPHjeVTShK0bHQG+V3#WrDgU#ig=DnqCVVp%&fy
zW^QNi4H%5SfJ?7{?grC&eOUCAu;ck!qd}Vfr@DHwf_dD&rSZeieixb2(R*Zy=(Kq;
zs`7lB0rjosIbF38UHN6GMRF{3<>W7nN#eNonXB@+_&9;LGa+angq(PMz5{!WZ^GV-
zsVdkLYuN>w5c2tojdU-&Da90$x?jNNTFXJ6b2(={$AJgr-5=ssRcl$4QcD;FCpbB<
zbTZg?)qE>6Gr?DY^HKlx{}{Rhsc`>wSZSrLE(bf;yA{jiRD>HJC$bLQ
zDjKMiD%aBr3#SX6dL1kMls?++r!jhh4K|-nk7MY55~h8`XSBQR}H?AX!hARkp0e$fj|$upYVsY`-&MGXM^m
z76V;>Q5$WqoLKKO>%^`rOdglZ$k)MvbXM81N{k(Bp84|?w$$wuS*cgn><$I>)b_Ue
z9X8~3JN!MD^$Bo(iU(}OL;~Uuvx#@;&~acSp8*Pdk^asfm=Sno%W6zLXC@!Gb8O;$
zr2`E_@~eb-4E-tByHkr?fSRjd4w38S;<%n>LqFcoH-s;0scIdOjhg1%h=pFljOgoK
z?&^5mXIF2WG$KdCu9hLmN)5RUN%Z{vOtI>&x0bvPRfErtL`O;!lGc|FIr)`6M
z3Yik0`K4z5^Vsm&V*;Yn1hKobn%dHEG@4X8PDi^}qTRBzx4KJrCd)LQOru9*s{|_*
za%#5H@nvIXl6Gsx*cvN`X{>l?l0)Q2qniX_&h}QX}-KLo=-=24MrZW
zTFgH?P2|Y%;gRh}UB2Rqiedn!7FlosqkaH8P27%8%MvQt%TAo#>(j6EE;A+v%^oCX
z!tw3dCTRC8unFNQ*n!)@J_pW$+x_jc-NuHm8RcjvYb;aZ6=(R=|no^poBB
zjyw;fDngQMW0vfyF$n^(0k7S>KPk&kZ$Qqt`EF+VLN3|a0;`@!{2=w$M{8$tj>n$J
zT=L-!hO`ImSp*?hjQZ~FAxH(94rgu88=6Mem@mkYCW;@N$;e-EJNKa%LCQ*j`EqnF
z_1(fDF5G`8tVe_+ggQzbm|C*kx`N&p9ei=#hfDSiTdH}
z2^<`-54mbB5WHD>t|_?B?=-o^sZ++Q8-N|}e*D;8zS~n-ArjnkEEu=QBeELH=T%wU
zc~gH18Ljh7Q7OnmY(Dp~BNof}r*rs(78dlKa!Qo#O0+k|00r$Q3qtL(Yl~2}xRRwH
zP@cwF*Gdhz5?Q*xUJ&#;T&hDm9)5v8+7+FeFX|6npE^gF+ep+ev87eb{bthjB00_w
zP01JX7mch2G>8TSeL*Z6MXOVlrQ#Kqf)j(+jOuhVs>x(1Zq)&LNqhCqho;ci*+E$1
zI&sH0wTH3SVsKbz5G3%-A39R+w%z1V(q1t?$IuF#q*bca&J$)ns|4#!gJ)Nu26ep;
zb-kyjh;!$sGBHHU*>vM=lDkka0_k9;rUM|O%DzTwRqm5of)y;CX6(jj^WG*{6(cau
zHjtbjeB4CTX-%*{+4J<|4T=SH<3KDrQPEhW({pP*fC2FXPV%7x@#44E|C*kYJ^Y(7
zk}8zVb34|2jb*=R>N==a-lKghlA^Cr=1X_*K1gfb?4VTgkl%buqFiwENN#fSTGPI4
z@t|Na_yO_!n77!2m~?)qd&U;KIt#vIMXVGcT1=iQ3YIhZjok==VQK1Am%lOqqx^g{
z&aGBL2Ax;A9e$3+btX}+`MH@C-4})J@K(gVN%z49w-T_7eM0u8Bf2U~b2m>tDT6YJ
zX)JkyP$OAk2?AXkT5?tto=$PwOE+&Td3u!(k4gl(#IVq^=eJ}(a9ejiS1h+uzdGMu
zL`Xt21XzPv&qAT@IR^uZPSVL)$r%F(5PxG3B^P$u)aq^d6H;%BGucjKF0sv~zV8Y+&W+D){)gk%|~
zOM)6|EBwMe4AJ4GX)<&CU^fuNuc)*>Su6T+>-AmX*eD)l<91J4PT5oe@CYf}Xz_1w
zcY!-Li2t6+eQ0FAcNbieAvoQmiA+Ug?^_GTY_gjWx8ORh#{B>MjBzUL+zZ`Q?
zR2E4p*Kwrxti1H9nKqdb^WQ9+F5v|>7a)>ayX{JZfI8Z+E$51j^XSf01@!k1MJ6(?
z;ml)DMMf>z`1_%cT3UE%r0U5kEhKxmOJdL+#2(q%Lms>HqU=z+`(C}10F+}gU%E&#_8a)&+O+6trR_Fi1gE`|6nkJ(u##`j)L99z^4o4d;JKFYln=*1
z)BR|Ps7uEeuW4#-T+4XPWSup^V*J}rJ-U4yAXT5dq#>xcgmeP>3ZA_`uZO!=wIvJp
zzVi*&2Zz@M3}5#lsg%>fh`ZLs_`_w$vfc6Mk7lmQsp*abz8c6;GiHu5V7IBB4&T#J
zgnY9tXjhBB=bE+EI9PJgam}ydy7X9i-S4S|OXT9j=M-^Mhgf(hajYOA2*AYct+qI}
zo@UR_Up8T&&2Uog*y%W)Zz50!MD~zU?ggEE*BMI&nq{|>`$AXTM!lgz1eh=G&HvFn
zf^ifrUC+PT*K)62ZRaawGVO_$3OucuHm0iEb^=_%vo|CORmqnu6tO%30;j++{igfa
zDUco{MdkEq96R8?e^)n)yuyeixiv|mnMYJ`s&recEgUHNnh7WcJsQ=W_3SjT^jApI
zYL{tVcNA7Lm~uS5zu^zquQ+&~6$(D6I#|$FZyVFCZ0I_+zPe6{Hlo~P8O?|NDD
zF_)qpzy8lxN{X~)&2=d&Yh8hnZS7N>@_fqiqZpIk$Nl6Ac6}bba?)OZHPy0%T*~V(7(XHk|b`oLMpgh*D9UG5a`i}mq**UT7o2mN=n-F$fy2ku(MhwLo9
z-}3Re+GRPlc1GHL>?YVINQ|DF6Y4&xbHYtR&gxpSqm@iq%~$O@kpoX9rf9Vn@-RT^|`a56rPnDPs7J$^#?O^2!|UGK^z$RQ0xuQp7>xV&nzkK|gg_ifMs|{f1-j*sa*`r-6=vT#Ud|&4RmGYx3azfrKMe
z}5zR2znC2YBTvmkR1$DO%TV6BHw
z{<`diw!so>w8m3{-(PM3QTB;!z9!_4g}#^yYmB{`L8c}__YcE-ptj%F#>WwA>^u_^
z@8XVWv!iNlT7Pu*L5T|I^s~S#3uf&~yis1e-Ud(TlIUH{3w(g;fNMCKYlf&RQq_fl&#vU3{TAv@_vw^Mju-ju7=fBa
z?>gJk*7+AHs!5)+BfB`)p!%4Y=Pb8iPvPmSw=eED$^M6T9?KLkzeviJ*2r`U2%cFd
zmHncM33X1W%k9)r8-wh~9>MS0d>S{Wjq7_}+a6I_WP6oTfxS0z*AA?q=2c3zr|^Q{
z%bvRK$Dw2XsfiYf9B&Y))ydf;=>69itTF;=^-T4)>Joh;5IGUWTAsI2NsIC0I`=fZ
zFA%$HkJei$r827SoG*RJ=UK22;AfX`nMvVrPw3
zXHHUkby~Fz!^LJ@9EFW;`Cb@4-m=o^KXa9|XtdVdxfY=1bbsSuU?ilC!2zbKZg1W`m9d9Wy+74Tp%-L;%g~0QufvjyFWV3tj;ksA!hVVs*}b(Xu&};#e(a*mpesxS{Sj
z3>Ic-M16#_6Kt79TW*M?h(0!>PJ0+tRQ7atSNI_N19;o?v6yC@6NEv+C{#m>-vCDa8LPQ$|+|FYTP-$r)PfP4a$1I
zad_|N*}rf4F`8wsaDN!)R7hSap~cB=HOMm2pQ=c5Qy7Cvkn~9+y&5N)hSqme$x)*N
zu_aq38(%IbfCnreaWmq9T8xu00i+4k-L#rh=Pf5=8t5r}^+DIE@rIj>NKOWDERaV%
zUT-nw^r;WLQp!`Ot~&+v)PjF(vs5V>Q~@ToG9^*rJ1W{`NQZTQ`+)*a!K2IyFT&$a
zu`jcaw(u8O4@ogWHYWdNpjxej5_0M(3iNBtnHj?U*d{M6tS-mE;BFNy7`LL{*rg@m
z;a1Q7M}dXH)Vbw;g_N2<4&FjAB<0!BK7sYn_~FXRBpT`RKO3XV0~ZV}pO!vp
z16z)nR*J?NNOeW~BcZlPy~Ey8*#obe`4w(^dy=E*Rqg0xH;8{;R-~R-ui~Hv1HPv~
zG*agd@J=IVL1whDMy{o_k_k9zX}oIW>Fe0EVG(?^zF!^upOVg~5dZ)$YVCcgYSN)c
zlhMu?URkN02_&3jrz$#IbgnHS<%44QVhcM&
z^||P@NaC>FMhXSOJinH|B(~GS^4(F>TNtHLX}%HgS48r^mO*Ofs#*wtmluY1vJcd2XURUQ|Tu&D)BHE>rCRGJthX1QxV2bO@VK}
zi7_H28SW8{cL!<>MoU=~_iK;2{?t^F{9?ir|5<&Y`GS)xn?zMnSi&@}uE&&i;+8fp
zxmL9btqtzz?&$35I9>3nyRFnGuUzMCuO==@rUevf7STkPe4a*;Py7#k>c1CeL6SYB
zR8SG?v*(@lsMvrPa>8gnBX=G_$5bX378ZZva-!VN9;RA*joMXD2rNg9Lw{@+0pCR%
zHt-QndQ87o@bPMR57J|@pIx~s>atA&X(TgJ*@*F!5}|6ZGGyESw$j}s&1|x-QBfJ-
zspU1w7d-ky+1+<=JU1S*A}aMoLGM+@hzDJ&Mk?&d}8KcY>mdF
z6s(IC>AkRM^;O0{@=mIA~rBzLOLJlHSKq<_@3tygW
zNL#qeXGfgYqW;>=uMaRrwf@`%rNT*+J{$aYKgW4-b>g8{fgHIP6Y^ZHL4My$wwEjW
zgxO?bAO9)GRSf0Ld@E?NpC6bgabjzqWSGJ4Il^aGtgxC3rEz}reSgoP0-7C^4tl{0
z@hT!7g?#E8H}Tl%)0@s}oWLNv;~rmwOIe->+!(}~rPFbb#pXtQLC@}GpEeWlv14gY
zmla5GH$LNL0|oH$YQ#5zg08-Tx?t%Uv6P>EUOS58U%kNep^=WzI?OUBvsf18C5xO*
zjaPFD8Ft8|v&{pq%yKU${zRE5Eo#~3$_Az_$IBGw`)+v1baxdb+5>EXZk&w|U(uAH?hCJ6%0
zFAe1)RbLg=v=oT$J`+1TcyhnU{xH53_p`n$>&L?>0R6%Fdrl80k(8ySFCRJl>P57h`_}bvYc?(}ms>qsEWcMmLp@gN
z59vqDFL`glr=R4%>XlU?Pj~E1Ay#J^0O-~?Lmya$#VPkY4}*@XEh@~~Rga}oK!{CA
z$oGC1aw1kI%UepSWPm2Z#%tw!sA&(bWg$`(
zPZOx#zN`o1sB*a;p=9}p;_l|PlG2C3m^JNEiptCyI{%BCkP%gouG$oLIrp|bH9UN~
zWmX&yZwZb0yn&?7`B6`io0xYFs|6Q@Ghi77RA@J0$P#1OTu8@~Y84ytgSPQg@|{uW
ztP&o0Ibe{NKld9!*oht5;HwhJk!&c;CwF_0#c2VRJeY>$!+s(BK;D+DF56Yg4DFq(
zTz(EhZ67|EZ&^?e0IFByifO(0r|t1R>QJ3@kmHq#jFP4fKfO?Nbm4R8A%MY;F~HF3yE_(MkvzAHyo%W0IDomK
zB_6C)|5|X}gwU7vy$(Tb$a#xibZ|C(0iL0PbWPh;73tL0u^)t{lD*S{S7@?X{!U;V
zcpRrw6H8x_BelG;`}@zU&t_3MpDm{w6T=N7>P7bH2BHcf(@r26?QIsvBO2xPB`Y|I
zQ`esA$8V%&;-iuua*y)GkG8a3=Ck_X^c1L=bWWEJLVeUtdU3k(r2h_e
zEWG5M`2VhPBJvu)wKpewlLn4C-+OB?jfacThd(Ro?pEf%>j0^M`t)D+|6ylv`rD48
zR8`gl`fBboOvc}{*Fv&XDpV{gjoHMCV?^?v+RcN^*QS9_;1A2}8`q)(8()jYBu8Ff
z=GB!%ej4Y$Icd0?N5@3XouA?bEfz>I$icg)
zIV3`AAs=g~|+U|y%M`G8t
z#9fOpp?v9o7#DldhRxdCkad2((x`%GqCn&b9^;QE^3YBA{_bPKuCA~Mb=%&^n2_YIK7$Tc9zCl2?ITwO}xE
zPJ6FkgWZMs-}mR$%=VVSr`oP19o;yb(YEiOX2BO%J^Oszgnj0G;ExZBp(-@u)S^*h
z#(=4}RaoX~6RXSRKyk544{%iP1-F>*DS&jE4|b}toNB`p@>W91V|k__)u@MxF8*tu
z`#C9V^TwOALhGF$ZLXIs169GtgwNY#vbHc`N_n;5Fki`f%EbP2saGxoT8Su|KIf?P
zpn2j+fnhGxya}sKs)Rq<>lF|r}&GVFLH|WYuokmYVn)Ygu`=*?$qqbGR)6H=l80JvKHF^yoGf4
z(Ep-e1Y1^s$HnRQkIY|+K4o@xPBITp-DT@i(@AiYI1icJFSharxLP`n(;*s`Nn(G2
z%z^Y7HE74@Fnbv>#6D8w*#Vf9_lM6$(Bkcn59f26LlG7lNi=g+9&-~ChnDl>w%Z&-?00tu;K+g@_&m1#Bb>Wo`vpCqi~A!
z1dKoGa0YiY!zsQ~vq2^BT32o|$b^diJa{;$6z^Ccpp|PfJ-#V;Kj{zU{QP;pV`q3Z
zHHS(v6JPJ4i$P0`D#Y5%o_MMxVEV47K$jfgl`?f3`@3aLidj6S*CG&3xbak)K_=G2
zmsj5%_qWJshUVx!WSELzG>J6S)|~k2=gT*s+{UOBT-#FcNyDe$BhNbj1<%M~ED_3+
zS`m~a4#L7{*iIchuz>bvnpY&2a6oOaJs
zf!qt}t2Nm^T!e3YN4o6?_b=`Ho6H><(t6s&Lw(IEx+ot8J(CiyVok&)Q*+5&W=l?&
zkP321tnqb!@JC|?&%q6h{OV5G1k+L9wt0S}{Wb|cz)Wz?4Z6S1m=3d2pocff5=#h}
zAhk>YrW_BQq4q-|Ic-c~iaU*Jt*)TL8^rMD{kS)&*&B(?n%Y>(jM9m1S7$klM~5jbCZ9ey
zd2*K1(DiFzvg7c6KB1Pd*dXrH2%*bxH##N(pHk1&@(z4EEgYEpXbKukV37Hw;Sh$>
z&))mooRGg7v};~qY#=gYpSibt#l&QI(dWg3_dDHBcO-~<#{=2zuWZ)WF&4XAhn#eq_^`2`WCWG(Yk%vzv;f(V}
zt~M))HJt**!sP`KAJ&dxDVeReG796=CRlGHM=SBz7@BfDs4e4Y=^DLE=o+laHabZ>oYS;ULxeWB@l#a#`^oo9%Foh9%(|KYFR-G6X!uyyfGgNc17d*
zSUpz%zqndhj`b61Bj1-Z?R!#`{Xbsg*4qk+=7L{N6D3`B(=A$AG|rdRlwy{0LheB(
zk5Cn`uM&@uh(~p3E)lPfM0T?HZd75mYUqC`zja-eQG&MO$Ll`dHum21sRZp_ndD6N
zr^(iCD7QDVRb&I=owVID-9P9NjW18|QCQpWj7dgr_#EUp2d!Xw8;|cLY1vGi6XB3~
zs+kxEFsvqg`e}1uR7L&mx90ss_ohIexcLL7c=r3E8~O?Zjw;8jSCWz)UgDVDN%
zp5jkyCvRm
zuX(3MKF<*a4(L#<-1k8mjU;%ja!~8?4jx7(Cdk6)m?r}U2a-m|QsAPVssD=#^7!BW
z7mm#vN(^~i;P}Hg?@jEf*YXOJf?|@~g6!vx=%T&`x?QCPHo!*f0`H)a8<&gBC5&?s
zlg#B~R1Q37+)caCrVmXls0TmxsFfaDn6Y~dE0qz~6q`aP5cycGY
zc)W1-{W^bdt1YFC?lq?NQZnh*_JIf`qf)TA8#!>rQK#qdkD%Fz@VRW{+w&{^Zb9~c
z31`6Up&f&Z1cx+9+tG)A*4Z3_D2+o$8V?zDOA2tT&N3M|K>Ly=?FYjq?gI<@@3a+s
z61K}RPO-)hwcp;=6KSDvxC?
zqgog0Z=xpIxjpY&@UoWVn|gX8*@W>29XaZ})sDjlo;fBys)>~KER4l>O8%GL*Q~?$
z*W9G{ZVP0c!si&3XC22%CAOX-h$7A2^Tw5ho{oCr!wBTBjmKbL^Fx+%otV8bmf=4b
zdyvEQLhB#ivij&>VHq^{+f&DQF-l1!%X(q4f!eJ{p>~7b)+~zgMyPG{XzXsY0hutyZh(eF~@fTVl?0Ao3L-FG#0~#UXrX9
zI`43Jz7i1~fAZL$pele{^&qb4aN-z5uT^mg0TJb&f<#w7VpT|{eF$CiS?q?D=1`TK
zI8w*_am*6)%8yV(+Dr5)*Lk19iVSbV<%LrxY*i)jVb_Lbl(+1OMfBX=Xq6OShwyZv
z=Xxfz;0d}D42dv*`AUFF>EfB?EIqZdszH|T_%d3sUzc;I?b3XStnIY-zA6|N{wR8W
zp%QewMd83lJUq#B6z@DX<|CMwV)#E374vz>gAF}NTip1eLav-&m}RFadh`YQbvIzIekWz{XGhi8iZ6d=-9LC&@csW@
zPk6E6$LX9GjU%)oUQzb7!WZ3Vc?82?^q1oYRbpXYxvkTsEg%``oF-mS+Urdb_;T;V
zj1fEHL1^j4-OR`YD?oQ%hUaSZJDZmpwP{pu(z<^^F<(78wLGf+G*&5_ot|NoyOM0-
z^hyngjw!7Cs~iuHF9wtT>d3OH_27)ZZltGeG5TyDx4`9s?87{N&x)_YCsQn9Lqu%N
zO3nvA?qlm@kWz+;*Xb7=Cks@)3Go0lV37KF3-UT~x=zXJ?rVL07x!UnkXWd-`MQmXKq-{Zdz>+`D2dqTT_qVS$cz0qng~Zxg2t**(;dPD-n+bKb6gIly
zZ}p?P6_lgqn3f#`<96`#1K5(>!Z=ja^uM<_;yC<{>^UDCwlZ3)^(7#rj7kZX`>`%C
zRN$8IE%Ut@V-jZTw{@4BW|)UaZ`auAzo+rN{C`iQ>%+Y|L3|_Ay2rpxK^MZw^Yk&l
z-VEMopKwg$Vk#9Ylgpc;67*ni67ZmO*7f|th)(K{^eYU7rI)YxCQzk5@^Z|c2olG|VA?lUI
z8=kKmcGR#D
zPxgL>xc!#C78zgW6Tz!h4?ajTU)<;6p>^M3GH(&sFY6RK(MO4rLPO1Y-k63t(Kh&>
zM={u}LC~eqQgw}dJ>JwB+1Q5x^NBY<)ncKFxW)3~-*O#=Y(6E>iKY&7g-E(sI?Qe1
zG7qb~K;K?>(!;w6qK{jPddC#nmIAwIn>>g$kGYB`a$U;CqvpPULjL>1;~nsVq0P^2
z=;iGEonJnY__xl;59(00VNXk*o(C8qZ|BsQ{+$*wgs@|HesBCAHUU7osoJoBikaVT
zMMFs9$@Kb)=p1ARN8j>U;GH=MZtmZGGqW6r$ErC*f&Wao
zIofx+^ylGtPvFp(50MsEEHn`V{ngg*H1-rWgLkn-FXib_rE+pHmcF9!Q;yGk{`~h8
zgpU<|x}vhBF8L59!N3_+l`f&utM_^l4RsG!ooQQwv4TW_y9y?V+tEo@xf44!KH-ED
zPQws1rBHN6dT;w?Oa>acqef0!uz&+8VXZ3GEh$gD6_%AY7d5q&#M#a#PLATUfR?yy
zKFYnGt`m(|tL#1l^pH|1Y;1>%;R5(XF(|9H=8mennDRe~O|g{MJ!M2)F_e^26Veva
zdiJ{=JIp)nHsMjlsbMEa$if)1nkU!Y^S?|i^os-z`Ni8=@-R|JF~?{Z6jsbG_)B8h
zN~`Nk^YwOlu{&nDqL|d(m^hu!b#=ai5WBqKTv`${9AkZ*pMF^M9t=YK9l#d*56>V8
zhSX}|lC+*l!eubt$M#pocvs2Vl-Xhv)|Qw*k2W+C^&@d+H(5#&!RsaWqPd0G+cQ6g-a(x8}UIF7t8t%}IFmS74@?`_C^<(SB;Sw!iW1
zUoCT(%^1q7+RERPM;+U3{T@O>evj?+akZ$Kx#(#^#2Xz_Dyh20WWe6GW$n_k@aD1$
z54N6lyRB`UPy(-W_twzoJbYdW!w`EHje;sMY0!#RFkV(G8cV1P5tm$Po;~(ZY}!Tr
zqgOWKCJ-6<~rBA)=
zp4X@B+(H0%`Y3?Y6Y#>%+6su}$iLU)5q>g{9wAK*y}u8{4nD6kvG(ldKP!eY=x&Rw*HluPssu9pe3`0pR0nxqqxLY7|5x)wUL?}%r9
zt!-G=GGT)7c}pzkXUaP}+K7~$KA&Ent883BI>~)Bb>ic6u-AA#YLX2mhS6AVfQHsg
zAIJy}xIE|Yya=tL;@<+NlTYP-Ep58NEqn+Cerdue_f`&Szv~yPRv0!dyG2%*I?TtG
z_JLFA#$0^{J(m>ajv(@k{4G_PzkcDeG2BuNYDVZVnQIPNmRScp@D@BT-UVO5DbBX)
zr`&!AxX`Nc{FgHKZnoa6e|<8=Ym8fL#j9!QLq`)toime-C05Nlcqy*i+$~7O0|OS__+M=QP7!W4nN_4E4{KNv4$g)U+g-WUxY71j(IrVo`k@y6
zxcvhAPaYM{V7J!kF?nbL&$-*|?Bn^$9I2?yox;{E#AxwD%Ay&w>ibupcj-lCQRo&t
zZzfIIVp7LgnH4raI`13c>9~gAj#-Sx^vZVr6^7$jF|r;+SDE0iL!>?sFeAR
z;$h?DPV6!Z58HywS&4fx>Vz&iyy4}Ms2JAOotPLNUFP9e6sAtb%(frs5eG9WbzLX-
zdESQjUXlV+__4?wg;rcm)yp#ci#z+PAIUW~G<5-^H9BOX%caJI{b8x(;a34L_mTqX
z+{DnTllElt_3VnAsSvM}*+?4p;!3~iHHi~Lm|_b0j~T+yIf-roiZ6c(
zaRn)l*V*ha7o!qhQJe0f$a3!kgQ?Jow&GfgK`uB!HwlPyf9q)v#|f?xJxR=5vGEFt
z57H>rM9ucZ#(`_6N-MK3OkKDzr%&`rzW)z}6l1mhFOYxIpJAXil`w6a(D|_La}$$L
zkjYau$d}SrtdCLK*Ia%1mYwUvz+U_7%qVKM%Gz%~^i@IXl|S2Vji_S1%pM=kHV|S@
zs}zB)=C7wpzH-FRNx5cPy1%3?b6Pe+EtBFcOSUNNJlkb#u_VCP3L{riy$p7HNFrEE
zq^d`02H1H0y-K)92s-Z0>99(9z1CjHy_)8>+>n@7ZDl6;m|gVp)OVJ`3%NwDG%3-_
zdjkmtbQib$^|XV%xXtbYkZ+ewAH!?79H*~X+LzC}YF0ew
zj;T6rkwJ=21v))7P&V{^ENmW8?N1-XGx(hT@7}vn{(m&_DLwb;D%cV&jROVJ9+W2J
z+_tJL_EGBMC&8c4HUjIo&)cO=v_%r#HsbH>iugw4Ld$|UgH@MiVr^tq9F$vE7ZSja
z@LmLR^{+9Vv=!NGq&T{)P_b+cQKt+|QN0IBC=E@aH%_);N{nUwA2VuGy@^3X40#)g
zWZbI{R{|)(0Qv6t53y)!t=0k`F#^91AhwVz)4&P2Y34d20d_~O;iF$*iZ+qbp1dTB
z=StpHM7OtjdK(tL?v!!eIUN22%ueh=JLyy%-Y_-rKaA10{-#ZCln5iKG768ZAAJgC
z!)-VQyMjNzFYse)!ZuUwQDv?F>%xOJ7wD%~N?$$u%L5N5AOU~>>X3^)+&$koi*TTc
z6OA^mV=h#Ekw#NKZc>(?o1QUkEZWJX@SQbr(9yndXV$ayz7Y40Rl5HTPk6dL5WVst
zDd0F;2e>2?P#<$w0dovZ)cEyOZ)=)MUKm2w%u9v26_1E?Hrmf%m1ZL
zc!P(c*tJA4gkyS}*88I!c-`}JK@e0Z!Q)uA;PC6-&j^Ch)QIz0oCBsS
zNu492TV;g+XYU6053wsN_6gNszZ=!S8M_xxkv#mh?#M7aC+=0lA<4|9mAgnZpui>;
zu$D$otRVRRc)H54sM@Y8A)z!#cS?gG-7OMQ0@5Je-7|D|mmuBU4bt7+-8nQ2e1ksk
z#~=8`b9!9B8GzCmdW8nR{sYoN$}=)(N64@wRGPYVQ1=Chz5r
z|IC%$W|0v-*Yu)srLY@&U{cS$my0wY7a_5{wC!ORCo;72%SeCS(YGQ6^H)31{LjwO
zc0s5l2|nJr@hSt+0HpHPgME7I2I^hfO=>QloHqkyPo28g>e@*vgEKXE9z3i+*OSy1
zSH%odGPT?-X!2_fUN%t$FC*7L$=1JQmkLaiatYH+=EGRpSrCZoV$iHNNWD!
zJ7~mP=Ev9UNpwFg_?d+~kQ4Iup(CQge+-&KcC}Nz;mG!R0lxk2bPPyAB)~eQaA*lW
zw;f78Kp~4Vic9`rj~vvA@%Afz)c$Gs3brZ3kNc0VamM8>2aCQeK3+#z<`+{`X0KQ}
zCLZ}FQKdbTqrWbP6zW8Bhv9jh>MHAiXN~K5^&4^~v*y+j*??%5$gAo!9VNK?v@eK5
zZu{d{zj|2VBf+PVf?&uudpuXq!5Ks(OIIG{Jd^QB|2=j^!}#FX9$4aIIR0CZA{#-!
z_$BRxMb|ePG)!Biy9a9E3+Ed6*GMUiQSbyTvY*<653+Gg>)tQW0$DaXUwGb%xpm8Z
zz*e@2VU!#Q7qW0bv9RU;tsRBo)=m9t6r+ND1-CQaVD)JdCvf3AsrN~dpjlqRj0|?W
z1g$*o;V-oAOffNn-6T}FU-7{aKkA$>o$8&oy9e;V-Uh()M)&6>;PX-j1XaS@m#BpQ
zt>QC*;x>X7gHKqcZ%bPvJjU(WZ&h5yg&PoX+8=~jA%!CPE^158!aff9ZczPs4%K60
zPT)FziaycOMM(FPK(lQKduVo^%9;vrmmV}E@Vj*%_2L*-9zLsmTU=EVS2SI=b6EE0
zYGmo?7rOYb@nmz2%UD$FA<0QNh>zD0xhOeWH&nz*4E{WOW+Z(lIdI~!z=;P}Oy+M>
z$G2bodPma?Yw9fZvul4{cmtm#&tA65fsgPuPGzM>x<1MEsIf@cq)h^aJlB#N(kN6$
zBo(f27sh!3=&O;`n_;^Q%cw6Iz>8CNVxYb|yB@o@kO_A)rp(Z~l}{-0*eyd4b^7-@
z=hK!4arnRvN;bPMFRz8b;Cu0ZSS<8rGq`y-3vu0uJ3`W%J)pjQS6sEEm&1C>vXt-#
zne(n`CSCr4533pOqVp$&^&ryC2vSo8Ce|EBk|IP8@gkZz%
z_RH<90C@Fm8+jhR&b?)=)47}D#~NWJzdkljGEYEb3T$GMIB0o)N;rV>C!X8Vk_hoT
zq!S~%yt93bFa6=U72)Xts4HtP5Nzt%dChU`K$OO576p?4iy?TIntavuP}$| nIK
zSGheHvfcMYK&RrnCKaq*gmAK~!FUwN(0psIZTk)v-()aNmQr0iCOqIvj3D=H6C{IH
zma@I<*Gt0{eDSnNp70Zo&v{mD858+7=D|(
z-jcxJDvjUR`F65k!iZ<34Sas#+_qhZ9;Dw8!hsej+QbfD7%}u3AHMxBKFCXNX)ZGs
zHMq>x+kl|}H?q!hP2utJ6`q%@KCGt6mTXoBynKnDKJNbLKPT+k?)KHN$yyk%$cq!!
zYbf+KPe}S~5%{6;F!u~RXz(&4=y@x67kdUQHsB#ImC2jJ`?wOefW$Vue?g2D%r)8Q
z%;V%f2W~GK*L&$&9
zr%wjKBFVc@-+I+sbmBD_8$4vZti0@;D#bhwTP!HZR
zlMUxh0XRf!@xmpt6~Yv{DO_ioNZP@kRjdw_IVQ+5!nLecf$L8^mr+#qt+H-flz|*yLM$UmG
zy@k~jdl>b$>~g>?8`8^hU9dVs1*&!D&9D@9=VDhX$F*)yO7q9`p36|{hSN9fUQ2vz
zQl*4$3*gx4d#PNzi|oDSC@NGvJZ@*-!xenQ@}~QTF5&z^Il&&qpm23g1OeYL0U*bm
ztKNsuh##S<7gXjn+H_;n2(}LU+XH>5B}A@gIPFjKn2|4~IuHJdLxMc$t%G7v9pZp{Ms)gLDW)V
z;_D$yF`;iKHF2AAS;b5QwU{e#4FrEd7p2&bHeNNK8Pt2O91hC29gc3<1|#6?KB{5EIfMCPfNm{$|j27R8+{lHGz47SIMF@DAv17BN*A}
zyu3A-ngdo@hYb3(0WR-tKQjgkHOo#0E=ZYDeut)!{<_t1m{~fdp&^V)*u48SQt;vB
z0WubQM{f;otZ&)frML*OO_M^xtDfdSCvzW6SC;mHgD|Ks+Q!JqE75(j;UaF-G9GL-
zhma8!*BO?)
z0Yg=*G{7)*F$9yG2ZA8@wT|Z;@2Ur=RyBy)SbwoMh%MC-KgDI;W12)Lh(0syiAgU9
z3dtw+i$&e1B?_Lq>#?;*)HP6g_yr{qUmOOz0-9o-Ks^(=)tyM~kDnvRflBE=U_P;l
zAdodQj~E4+EY*!$S+-ovlsDcZP{8!NWN!&G+l#@IG2tM#LDFVAoRI&TSB9$KWE{)n
zW^{Y?WG4w}7~p*=MDw#465uoYW@k~;{TuufO$tJ=50?dr(u5tujfkM};8>
z$y}yAB}L<`B9Hhb{&tK&YqCLLGWt-`j(OvN6JZ;#*!%>Qq
z8xeQu2a?Hk{$|ic%1n%KUBBZxe{S&LvHvb%@m5{7fh>In3GsQbk2ICo5>muL&3@Ct
zXmu_Pc&{^2wyO=dDxNZr7Mjp$w4|ZOzPija&{@lz!T;zCxYl`EvIb1)xX&$>ArQW&
zL=&d53>dX!co>dH4`ldB-zZ^L(YW$8EYq@H7yEut{V@Xw<~#*#D>ObGD&@F8O%E74poo7Z1rPG$K^57^MC|=bTR0n
zvNb!3LT{cUV{O6
zoIP)cA5R}9^V^+YFx4#$XHc~2CgmWjPWP1v%MGfkTN&|t>FK$z*CT$I@>3YT1X50R
zwkba>NG-~~bqm=#&gx{d`a)#uTy0*~@YMg#_M3AHmTkXBR-N+O?~pPN(TR#UKriN=
zUle)n$-7K^w+*zLN|W)T_AZ8HSZsONnMA#)5!=l_aZs~+D@IlVp2)Src+qBWoi%QG
z>`x~}DzEW?+tb}l`%S0(^5Y8p%O=6<-KeT25Kk;A?#hGP8gp|L(vl1xJWtT8`LyUA
zdwxPBaGu-zG6T`XL`>WrkDj6#V^NQF+IEGAZwLorXdd*tkc$!8`uHX~yinOs#iG;p
z=vd9xls4xtgq67;4e2}_V$uxTQVFrM>jsQsMnKk57R^o6zt*gz|ILm1;}&p{zhBX>
zNPB}w=z~G{P)&c*$+=efFgn+EYQNS{Z#~aSmiQ%XINN6U>zBAVA8OKd^bZcii3U^;
z`SWJe-B_4&>p^?!!0$daJQ!J0HsR`<$_@@!gME)DvH8wzSD9nrAwh8Whojg;ZQ#mK
zS^G^wF|#1o?l}|+><GX<-mzVwsJ~fZq{y_#eocib}HJ>wOd>sjWu8ZA#|1h_UVHnmv#*|o$aGuxs
zBO(!Zw}}?>LdtkUV}Z8wwMy)L=1b_-%B9^_Q9t+yTay3Qs2Th+K%=Lt$
z2py-p@j@%Gj>&tW166R!+Fjd1HQ`fwRkJ?+@fHWc
z;U33L8UoknsBPz|?e|L=d>8iCuHa^Ew%xF5*rF(PG9{ai`j~jZy~JenG_X#kS=ZtJCdZl(mkckr
zO*|5Qm-T+{YZ&^ic!jjE6x=Nbo|P2Gd`@RMORJ29Q;s@kj=U8k>ru(sQx&3LIxiRq_YbR16>3Z=iPin>a3DvHeP;4g4%
zbUj+^7oA-j+v}X<_#X6*XfVMxI_Zu
z#-9zW3Y3R!=BNn5(v^H3rrj=|$26eP1prmqIUqfDL8gjcUUggd`%
zWDtWF=Gt~GnLQU~ibvl0-Fp!S?9FFK$K^9wQ+A>pl1jI)Ej*uDh^LAXR0Z!*bmP5+G7I-=sgIs(DBo5lLq+i!W;
zCf@>s6PlwGG?;2pjkG;|G5|wEKnNd@&zw;Y>j4F|bDAn|+{Ls^zeo*jq?sGb6=4FM
zt)vF1!{AMj0w>vybSv3C(-Y2joF?p)e_+Z`lZE|*H#ycS#Ug#DvziC?9p3MvT!{`U
zF0)At>NfHKBZb6IjOfg#xfTnpPxw(I-*SndlEX+vwI`k$xQli-eFuWq$wh2#T|Wni
ze2?K$r$Cr!2Ec35#GaU@s|mz$Snjow(
zV?S*BqbZr*@M0@DW4i2%PWscuv=wlh{PUJP@On2J9(Y>I-0tS-(Q`3`0^j?49H|s-
zC>9BdXXgl;?+s+2>#X%Q^>+C&{OoCcBX)_m8Vz*lO@x@WSvIU#=*jjKb~*Yt_Mn=1
zP>fz5Hkrgq)P0&Q%LjZ23)7Dr?@)p7BV!>HYKkR9Rk3#I`&~R|yBqRsiV+tqh8O>#
z{2M&1G8(Y=-{u6L;=ks^x3pr~{Y&|qc`y}pvA5}_;N5*95S$4wc-wKnrM9XN&V0H)Ezq>TJBjTpZ`zt
zDpdtM9!kMqQ%0+fy%`?)OQ&oHPtO}nj?<;bC+9<(Qrx6;n}HH;HPKwoFATR9t6zWl
zDbpp=xx
zd^rOG9cK3iynh{paR^!QeLlsLnWiKUc~Fw)exl7uHumO=@9t76;G4aXmmQEs(l
zb@y<`M@{F7e=HZQ!z1D4jehKtrhru=lD8Yxk{c-LYWi6n*PJGnUHp5KEQy2Ihj#bQ
zKHEH1SGV(xY@8Gat2iTKy1gJ`Bk%QHs*e30uT}fWw_m!icn=^qVhr+rRf4R>903+1
zN9CK=&&SQrtL*@5;7?1*4+@k9o;L5xTG^=$sXm{0!g&@s9vDYHDwUhycpBg4%ey5t
z>!=|kAQWJ+Dchiwm6e4vA0NE}jmX}Zk`Y9j>W`g9?_|B~C9C(Oz5*}bzduc9D%5)0FWV)7WAvtSE2rQLrO*~4$F4mL><7++Rk_Gx9x`+
z9{bhws@nDZalDO1@Iz>UWxW;dD(&u$f}Hn{@732FpxA$};Iqz6V#_X99xr^S*_r@7
zEJEsY{XX;!q3!(#VGd%|w=>7hb<*wtI2LpT6*f?u6z!NZoM}`*udUMUPomBl*_>!@
z>Xa&X<86S1NH|)Q7afys(r?ivM?$>A*?@Y`@Mlt6Wx{^NCd7iQFX1LKehUlxPTU8A
z&ledUU6rErQTbYIRv93J*BJ>2jqhK!mM$+L
z1V4$TO7%q*XKB7=eLbNYT)_6zi69e-z7OIiz8!4U`p-)a*|oIgyTZA)XJc)rM^<>@
zq6a0&Ydprg@xM+DK4O08ohpqWowb%*KST#UCa&H!4b4U5o^TLknWT!QQf)FdDmgpS
zFQpsX@y|U|@P*>Ocg436tUvzx^P6k>Q}!O3ZFff2aA`|H5|_f~kFnIVI}wm3Y}YyA
zZ~q}wBG&3OkcS7sRm|Q1l-Puq9fay_fFP_QI!-N(X_up#@dwFBB+{9jmYqG8OPeTM
z)nG|FZgmPN;57Uv1usUB!lJ!@66n+OF*#)qmS#_u3)%c_t6
zMR0STb~Z6pad)v9-PL{Yr#fig21ioN2Q7*Nt~7jwK7J6jQ|q@kOsop)5hF}fK}HJO
z*tqLxK&%nFh+i6GZkoMZ;qteknAjA0jL&|!3arci#|bebiffKqYqtp)Mpprd7{L_!
zzM>f(#!byHpOB(@`t8%9We*mZHt{v_dVh3H&U3e|yj(j!Pcxd+>$9YW1pOkAQhl{C
zu*hGe*DxcC)r(w~y4NV@st?B6P2s8hC03`ALq;-{z|vwMDtIfpAVA{ndxaE^AY(-u
z>K}`<3>*qMexicTW(pUN$E7!yiZ8Xd&pna17J?!9NErz|u^Ep~AyQ!zD+I_tzk-ju
zFAN%$ZTNsrIgrMRLUs|0_ZO3tJYkvaoVXlZYL#*SwkOT+KG&X+2&`E=NU25SG5qTj
zL2@$0)o*VRD1Q2}Glfqj)$L0;YsLHHZ-VCjEvtP?vS7K?}yT?6f`P4O}Z
zyxp@(mIB?0(#w(t)YQf^I#wqqUso?!*iVftUNm^dyu8Fn=&2D$G)0}w{e0gXG7s1$qud?Z@i74636o?|127WHf^~zc(&W$-a4O>{f
zG)|*&avQrT?Gl3i)EsM@O$;mk3Wpp4Nx++rG7<(b-4AIHDI!~qQCauz=w^E(X#2+^
zg}n3%R(lo&4MparXDR_=jy@VJ4rDMVZGHZTSA1g#WopMHf>R~o&X;+QvuY1BQ~A#i
zscR3aI`)0x6cTVE@N7Z`MAi^KmEoElq8#Gur=lo?G$IOro9hlkZF&^KYTfYtWfXXB
z-MT$)VtI6-B1<+>0WgOAxHoqv{#c6znK+no3e|rCEnu2%oHo2a^@X0^!Iy%J<^pgz
z$|Z?v(OG?T7aYF~HbfN#sC{P}VY1R^l33un4SJd>XZihUeq2Rwcj)n3dGHxVoAaop1k~M&x
zfA;*69wNlHmEpP--WPdeygi(KluZrS!;rsyI^t529gTNr$a=2`g5sY^Rrsddp~de`
z-Vo}za^-WT1<9Wqk|JXwlsp7{wX=>DfLHhBu=f2aipO@xd=7pnCkT+aC%?Q6r+bBc
zz8nFycfPpW`bn|^2HgqUqMbe
z@XTWl9hVnjax+9|m_0(EUKZ{(K3}H&%Ssm_xhO^8`b9{FeaH|$&Av7H_Q~_TYW>r%
z_UD@n_mQE9(y+_X(b-w-b=qsKe1t3N2D)({^i3AR=>l4pNqpa;>Aa2U^t-7bwR{l1V=m4?10Qz|DtpDbq-9fTJ
z7DM>=WDKR&V~3htJlvED64&!-neWY&KBuBvAMQ9x|IbK?lwGe5?tb~_8
zv-qRXVT&jI5t|M@wBa4?SjpElNcatnZ526F;y}_|rca7C+J|eZoRT*>NiZ?P6uxAk
zOW2Up>TkwQvA^2P2er&A@!v@vH#0iFK{IfsT`xovz0_RLDZ-~`=J9(L<694bk6*Ra
z5XD9mvFW5rO2#WHN=p5TW+^f!KVW(crk8ji0p~im9`w|Q1^y;s6~UZ^E1#H*3Sr;D
zIv-xMhJ1F)Ot}Bc(^}{+CU4z&CO?9XPV5Yf?e`q}XzHIXQ?1($i`F1SrS|*%+r{{y
z&4-DRUrg6{Du^Llylh$B6Ww`m`fV-i&36#E<&0YCic~41{aK$=Z0wgRRM%z0#@H>a
z5c)Yl;6xb0N;%(_LOUX0Rau!os2_TMcVD>0Jm^las`jfHQeI)~P`qUS#626}Wv8ik
zqCA4I^s?P0Sy=3_jB)968&ERVgg0A`YBb^E2bFOH%$f0B7c^MWaBPsw@x_OS740~M
z3868Tmz7n-7>{ml`kT6r%$a#TuG*jLU;doXA3>!pqs6T+#A0@($4-0H*S_2TTQ>Z&
z7|nMGgc`rnR)^swHmuvOA2=ZbTb%T+5M^0vf=$G-uKg4Ivsf5KiI;
zSHWUq$3#Gz*>5j{Ut>0s8Yys*`ogszqNnAx!i1)rV;5!}kIV(__lf}*;pHua&_B-@
z_Y{zzgSydfb~aw~hQX=-3TjH5e!>)3zhCKzL_6&d@tn`|oI1}(BzJdx?I6$Z5yyTi
zc~F=N=!of6V#+a@x=fihz)}j>y#Fg_6UpI79jZT!d_1dwSbpwpM7+UDZ1PIO@`}x0k)MX7%@VOIG(i
zB<@2;7dL2Ok
z+ynyGR0W@}A5UG+S#`LN>CNRWES(o5ii;c1NV(Djuf```=6w#(gb#~Qh{bBK_*uA2
z7_hFp12HNuFWU;TVsf?I0Bf})Iyjm*?!K5J{Ze*r@0I3ajW1y0{?v$*EwvC-jRMR0
zI=QD(AQ@sIt5_Oiq_Vof`b7A1<*!mx%un15`I%5XP~991uz%&qm5O$l4|AX>;gv}h#mFI6D~U0+oMovXYBEnMKUYQG^ZpPO@is11dW
zloLfj8l&kkZaSdh^k+OL$85B
z`5c{l*Lv$ej3n#!QEqDZZPSaLEr!MM6J0q1KW+v^Rr^tEj1u$8t~I`No{nZOAZ)&$
ziWwk=Drk968Go$&`<2$y6O!f*8gT2eS}8(Z?B_gv=}ca(b_ycC4O_C~nYW6L<(rvm
zwP{d`a1C1JM4wwXR93|dc(<0dUf^hUC}zDvcyeIupb;oFS6Zgo4p>hF9@1F1Z{8{3
zib7;ibfv!{6bXH!?a|uJl_-OlHysYnfA0?~-^wnV*rJL^8dcrX(eU~ANjA42a4(v3
z?Vb$?Novm?j}rxMui^9b;;5)iV`|h>!fq`ch27q|FCdP-ygbtWHZ;-frJYHtS&q;
zpQ~BlFOE&>0X~{Pc2@INL)~D1+!(Yj@~lJZvYra{!P$^i9J~Uv
zi8{_B@(`C}-FBZR$^uQ}p0SjNOrcdHH%uEWg#cymjDvnN3uKIt{V@7B0so)FLi>s3
zB_WOzFDs0RErK1kZtjQP1pTsl5(v1sA$gpo6#&%+zFdKHo(93F8T!-Zgo`McUnSUj
zVF{xV%$OVkt}q~Le9)jFp~`G2=T~z7=}sHhk2LPl%fWlLPHUK&UpkTH2oX*}GtX%ZMIooIGZ=St{ND^@=;OZze~P%`?qSgc
zQ`g5SF4gRs40+0*&zu1SOGt*RBmAVkDRdF}cC>W7V?Ho={IX-y1C0gBYDNW+z|_ki
zWHs<6^fxLH6%KO{bCcVFHYlu{uJh{GE+!K-D>>l&h0M+oGHDGOQD8Dz2sz=SNj9Gs
zF8j4jzF$Vd!WzoWW~HuvDtYQ+ohkNnj=QEb9=vl7=)9DK?{X7{21`Qw$Kuv$a}QA)!w;=DXNs>hWCXHrSh~)?Eq`>x
z(Rv)T!OJ_h%2P}ErW&H^uQz|l+8KI&?+u4<`dHS*Uq_*Gq8NF*C{|w*la-u@Wd!c`
z$PF$oDt8+h(gv(JLe8L8#~~Ao5}*P#(DTEZKG*{@4Z@?*f}t
zv6;zR-Fl9@oJUz&jGJ&(q}10RZ*PV55elRkd79>CYfB@AAoerOBMs~lr6eLr3c!km
zHa9k|4{M%1@7}K3E(KTWqE%sj{%9ICoS+Ys9(UC0g^-xU<1k>TX|H9cuy}O?)BNN;
zz^fzMR#1*&Q4D$;`8oT4+BC?TBhf+&Y5K*Kl}2-DS0@U@4VtJ5Nv;oq_K^c4S~tb#
z+8+{@teP$_hvtINGNC@>OMY|nq3gsjv~VDkeE8NPEYC@oo*MmEi3$Am--MfDRuW(^
zOx&Lu1J2N(9*FEm#^ivJ9A*3E^vG{0qHm5!u;#u>6tx{ZJLb7H4c~rV+kEOC)Gs&w
zYb0DW5G5V(R7t2jJIgOKUJ!I0JiizNRd9vS9EFX)7AvYeO_J^6frc3sCEBv*j>@N3
zuAw9W6|-KpN6CLy`Eoo~5DBS>jQ^}4t4`n=RML(rCT{L~53dNijBoX`T_vNb%y_bf
zjSyHciba6gMH;-C>tfLmU3X#QO~6jhyTcbV7nZ6z7mFI!uGfy7%XWAB!5utd*sc?>
z{=b8S;6059Sw4t&4%l1MR-L~Y@F?ILBVT(h7?0uqb?Oq4{*3=AE>V2{F+h#=8R^$Z
ztce7S7^(x_86q}?0#eIo^@&>FSeNS|)OOI0^;0i4@UjqI;Nia9<1xCgj&qEV$D?5A
z*upAe4#gqB(sC+n$lO@3EPuX5Y2H7Xu%EBNm{ozZ
zk2TOJY4{PvpTXYHU9eE_4fN3#V9O!nL7_PNKrYR4+37x5b>*U}zV+clpK7maSYMzn
z5`_tp?KnFF?#~!ulRpR&nOI!`GHBvoGgv+?#<_sWpiOR%Hm@PB5`swmgYz2M$0yTP
zSSg^TzZkEYFDB}vy(67~AtQ$xkdi-D@PV8B9#kA1bP=MW{S*Nq^?pzVZl;qwfdrq&
zof5mNT#lWchAHqxP3)z28cRK*cZd(i&RTSxKLZ+hlZ|^4Lovjl@j3Et;;q+i59zIb
z_$%OQihha%j64Rh#!YgYfj;I!9)&hDYj-y*fSZ`osv`ri0W$8EB|laAw(`##rtu~mOmqOX8|bB
zWwv0cU~Re>rKodrimlrt41imuXRc@7g3ovPoF=LfTGgeoWk-lSaTrKM4SwP*AkgS)
zA})J@cya)bHWGj9BX+j6z};Okkp*(1Vmph2%+w@ZxNCGj>JTr4afbsXs@k#Xh7}SD
zPm_3sFeMZx5bEK73WLcxxQE*`r=T>yC7-dAS>8Xtv5-TB2JSY~JKB877
zDV2B+y8AYkIyCCl@cFbDd^|o|nBlQi47@27yonLrf~kNufH7bv_SVCzE-@qHQIv3p
zvj0O)Jc>ao>>YNvDYFTZGx-!&+GL(u@>=MKOZ@YVF}eeupq!&iJIN%Sn&M+m88x~E
z^5eQm5r+m|zhE2KQ_Z~y9k-s$=LuBcQE+*h+jPX5AKjr#`6n0|=&S~E(eg?`-cxsK
z4RR0%ABe!`Ub6w}vx7qM`X98woUJk<{+9c@#I{Rc4IQ8%&A2*(EFnZy(yRauhNfWz
z)Blh#U$K#kw(SFJ->zX{2&O@79NTcDYHJO0zg&tmftHjh
zF54cy^FTr*iu`A;r>Kq1Cpb~txXjsMSZ1cLO12_@7|Mx%EG>G3Ete8&UiZms5naDr
z4ncra94&VbM?#@6i9Km2g*I49tjN7|O>^NKq&O(`eVHcujiDBp7NpOuLpm8oXJbdL
z-(NvZA4O(Mi09Z*)T6yIa)sHoPinxu8FQ7P4T;(Ldb?p9@)6_1_jN8p$LCO;`{3f)
zuITT%XF8SnXNq~}BCXe|40riO;lM-e32t)#mO#x+;s
zv|C*@ZL`AJl8+)7`qQ{|#GVb7lJF=cawN~4^yO`v)-RVju8)kIYYjZyZ;C6jU|H%d
z@ZPG3?fHzcES}+=8&15jRU?}RW%sbIFPHyy5c~fegff7=>xW(5hgrXu?Q-zuNFvE(
zDb2L=Ip6kfLlMFE7Qwo9eTQy@&C2`Z`nKy*IIhbCU=C-{eST}_j#ak^WUH*UsZd!dBxAnKiUrIEmfwBmMqCt
z_!TGS8qm0`Iv=9GAu}s~HrWL0G&q~6mp8;~_Zw!Z{m2=?>1s_Ur;iUMgl9)hB|{9{
zE^B&=+ExDC>0a+6&AX@rlYrYSCkD|;GS2`plyGFPn{#VfJ?lJQmbct@4|*%+8ttCu
zN^$IY$X!_cO)vkAP0)=YVGihf+VGA?@vJ%-fU3)zJzGFx=B+$EqL|A*8uN*mk!g>#
z7V@(%+hy*=2M1)S&10C_mIdG{@k6s~C>1&!W~$yH+D2VGI|XGsNrJIIa8J9&Z4VdL
zKMax@>ufOhcv_PZ2Elu@pAzfqOXy=t(eGvI5d
zSMaq;z92vF^{n^|hLwYDK7R6Uzr-xpzAcTuhL&)E&fP=Fdz6EL#EY;gBd~_N1@JIE
zmLIn)SL{!`_&(fC$tMAbb9nBQ=D_P1-zlo8{gg#*NFeYi_7a%UdSsF2U|SPwp~LM(
zC^Hz5IJxMLZ^{0rcc6cxZzcqx6dcDb-p16GYHCd~5Z3
zbm^>Q!%jTT8mhA!y)zc)86Uhf6BJhdhFOc1u%@@4B+g1K-(j-
zesxz7Z0ue%LhsRG?MyPf;5X*hUN#;%oYeT|G0|57QGV})UNsW*&#wwJRN3v-s=kbn
z086de=xzy;D(f$cO@x@c+aTq)wBbut`>4~a!7t2RnX=bWcx>n#2tX=yO>
zLD$4`n8^0bSQoLt9}6&jN3ZjA1HR=KMlG!0QPS(scYS(an+@>@jh)yT1_M$|Zt&_|9v-3nYL<4NJ3gz!^A^Js7$mHsWd!y368)`tZbzhGV<
zc{Go`9HYLNR1*c(c7YcbOf31GSKcl%-maVkQuwGNm3qOGA%Jg+`a4e!###?QL*`8D
ze!ylaj$TrsvnY7l|N=Yz|=EVJ39obSfzB%0((
zN#b}*6z?Ntw=l(m?ZU#LMHS%IQ}Ax{HlK}XG5#J6%92aA05c!L(UzbZZDR68a9EG3
z^_5&ddpSF6vo_}~FZ1V$h^<|aqrvzIq-_(mP&idW@Lt~HP$$}B%eUgIc)nTEw!-mFQ&*yZ;d5p{P532(bPRNhNfYMjl%THD`D4qe>Smq0U&cI{P*~_M?<+U!y
zL0$dZxC)YLyJa$$QF0%=Mh)wfhSvK84J-GV-~rgI)M(yIB-yW%9)BH#pdZ-D`|mib
zXGnG(eHen27o4`o=Q%>F)EdU5)OEQq?px;dG65~_1(n8UhS;P3jnqO?v4eG
zeCzIRDkPCep<0|pf3NnHa0{K>vr=47!ryidsY@y!>d`dZ7QFR2x%490Z+y
zs}W{59?+(vMPMn*`Ll}Wx?(~GGP+vsX%LGd^39Gqs)w-V)!@ZP9}ZJesfMAA*GbxL
z9w7S=aMUt8cw&c1p}mQTPe2$%`-66WDu@(DmA
zo1TD-I4RSO{hQvF-jS@1dyeh+wCzfzcHH>zTif%x7Sd@yw$dPw`Ti*2z3xW5biXD4
zXV^o4WVyOB*gW|J8k!ki909lAp{f+R=x8F=FGf(VBt
zH}zL60w=gmWTGn=4nsm4&bPyNPCOL8Q65`?av+EzQ%X0Qsp(QO`~})%DntU4j?gQp
zJQ9VAf)b-PNAvaUAujK~Bq<$zZ`j2HV2o5_GqR(~A%d0iy8-h?=VKwRPg7BG17vSD
z<^0`x-)Y;eJ!-CiuF%=oNBAElgg)Q{Vu)$*d)#&z)ge%T8b6&3H^nhRz5DVfn{CYx
zc;lXNcfPV_f~r%Q>}TW`m)X%VJ<+;?e2Xq@f8#jE-&v&nv4d
z7{}QY*pSY~A$!gZoFeDsLsW2
zLcJo|<2*I;X@f?PHPp7q0UU-KfC^Bs*6Kl*%!r4%xTi8k&aBst8_&nla@y>6>*7Am
z26GR-Cewx_)h}``uU=@O-etlA+WuM+s&ga3yf?6~Qz>JGRn+0-mp&mYj-#I1r8A8D
z==S)8yvNR}VC!Qrt&D#d>8{$U20TYOXi^v)t=RJ2=r<$^-~S8?b&@&zeD$e}%$b~hrEdSc1SsV|(9
zJ!%EVQNP(>6mX;m!ENc{J%<6!JbzOb0SPYzo_(Q+JC@r9qhAnf&(kOO9uGRLM>AnA
ztVE&C)r;7`lM!i-ckqp0b9s>@@n$?Ps0NrNoqhiF0r?|p?nig~&_kpWMb~t6++mkI
zAN-WBEs0mj+Lf2~vGee!oX@B2&m-={yvZoUfb-#G_IF_#lobrJCcqjBe{
z>N#RQ570%wz}nVdTSS@$N&WTfWV;MCXo1QPr$3i7{Z&`&x_%VL#7h0H_oNAG@aB$z
z*Xo1q8bHXdtqybU4O|6PjsXl}tD_WzF1+3{=tF6o));_Nu#y5RAl9=NuD`StFXSP$
z0X=l(^LAVY6_pwQ5eEd^8e~L^_8Hqc?q+g3;0`6}Xh_%rz3&a@BQtFE7u!Ag9Bp69uL
z(?;^>m5fXbqgHHJo$pTq;~
zPFIod6-ZfYePtzs&r4HH>?f9}^I$yfC`WjaBhzx18g
zLuKYUqoajJm+*!e{94wm@4ujCclZEy^1-{wmx=#*)-w9Z{HXBkabmDW3tan3Jhk2!
zEMe2M$tPk>m0pTl-oI4d`Np-2D?f+`34>#d0=E~9>*6ob^r6CyMf)$}P`bGUZ5XzZEZrC6DXjPR3L?ma2))p&dflj%THd@|ij
z*BRi-oWK~sa$yz{{Z!d+Dg17GeLt<@%KGX(I_K`O|4j?!wC5x
zl$ifTu7heb2W7w|@FC*p?ygn`=yIeAe36&${9-_0N4V2Q)4hYiwGzHQ-^>U3R@2RQ
zeZtAUNQpm4*?g+RyYqEVzk_eTg- |