@onlypult/mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Onlypult
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,94 @@
+# @onlypult/mcp
+
+Local MCP (Model Context Protocol) server for [Onlypult](https://onlypult.com), for use with Cursor, Claude Desktop, Windsurf, and other MCP-compatible AI tools that run stdio servers **on your own machine**.
+
+Running locally means the AI agent can read files directly from your disk — so `media_upload_file` can post a screenshot or a video by path (`./photo.jpg`), with no browser step.
+
+> Just want profiles/posts/scheduling and don't need local file uploads? You can also connect directly to the hosted server at `https://mcp.onlypult.com/mcp` with no install — see [onlypult.com/dev/mcp.html](https://onlypult.com/dev/mcp.html). This package exists specifically for the local-file-upload case.
+
+## Install / configure
+
+You don't need to install anything by hand — your MCP client runs it via `npx`.
+
+Get an API key from **Onlypult → Settings → API Keys** (starts with `op_`).
+
+### Cursor
+
+`.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "onlypult": {
+      "command": "npx",
+      "args": ["-y", "@onlypult/mcp@latest"],
+      "env": {
+        "ONLYPULT_API_KEY": "op_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+`claude_desktop_config.json` (macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`, Windows: `%APPDATA%/Claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "onlypult": {
+      "command": "npx",
+      "args": ["-y", "@onlypult/mcp@latest"],
+      "env": {
+        "ONLYPULT_API_KEY": "op_your_key_here"
+      }
+    }
+  }
+}
+```
+
+Restart Cursor / Claude Desktop after editing the config.
+
+## What this package does
+
+It's a thin Node.js wrapper around the Onlypult Public REST API (`https://api.onlypult.com/v1`), exposed as MCP tools:
+
+| Tool | Description |
+|---|---|
+| `account_get` | Timezone, plan end date, publish_at format |
+| `profiles_list` / `profiles_get` / `profiles_platforms_list` | Connected social accounts |
+| `profiles_get_pinterest_boards` / `profiles_get_youtube_categories` | Platform-specific lookups |
+| `posts_create` / `posts_create_story` / `posts_create_reels` / `posts_create_shorts` | Create posts |
+| `posts_publish_now` / `posts_cross_post` | Convenience shortcuts |
+| `posts_list` / `posts_list_failed` / `posts_get` | Read posts |
+| `posts_update` / `posts_delete` | Modify posts |
+| `posts_retry` / `posts_retry_all_failed` | Retry failed posts |
+| `media_get_upload_url` / `media_check_status` | Browser-based upload (works anywhere) |
+| **`media_upload_file`** | **Upload a local file by path — only works because this server runs on your machine** |
+
+Full tool/parameter reference: [onlypult.com/dev/mcp.html](https://onlypult.com/dev/mcp.html) / [mcp.md](https://onlypult.com/dev/mcp.md).
+
+## Requirements
+
+- Node.js 18+
+- An Onlypult API key (`op_...`) — Settings → API Keys in the dashboard
+
+## Environment variables
+
+| Variable | Required | Description |
+|---|---|---|
+| `ONLYPULT_API_KEY` | Yes | Your personal API key, `op_...` |
+| `ONLYPULT_API_URL` | No | Override API base URL (default `https://api.onlypult.com`) — for self-hosted/staging use |
+
+## Troubleshooting
+
+**"missing Onlypult API key"** — `ONLYPULT_API_KEY` isn't set in your MCP client config's `env` block, or doesn't start with `op_`.
+
+**Tools show up but calls fail with 401** — key may be revoked or mistyped. Re-copy it from Settings → API Keys.
+
+**`media_upload_file` says it can't read the path** — the path must be readable by the process Cursor/Claude Desktop launched (your machine, since this is the local package). Use an absolute path if a relative one doesn't resolve as expected.
+
+## License
+
+MIT

package/dist/api-client.d.ts

@@ -0,0 +1,23 @@
+export declare const API_BASE: string;
+export interface PaginatedResponse<T> {
+    items: T;
+    meta: {
+        total: number;
+        page: number;
+        limit: number;
+        pages: number;
+    };
+}
+export declare class OnlypultApiError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(status: number, body: unknown, message: string);
+}
+export declare function postForm<T>(apiKey: string, path: string, form: FormData): Promise<T>;
+export declare function createApiClient(apiKey: string): {
+    get: <T>(path: string, query?: Record<string, string | number | boolean | undefined>) => Promise<T>;
+    post: <T>(path: string, body?: unknown) => Promise<T>;
+    put: <T>(path: string, body?: unknown) => Promise<T>;
+    delete: <T>(path: string) => Promise<T>;
+};
+export type ApiClient = ReturnType<typeof createApiClient>;

package/dist/api-client.js

@@ -0,0 +1,74 @@
+export const API_BASE = process.env.ONLYPULT_API_URL ?? 'https://api.onlypult.com';
+function unwrapResponse(data) {
+    if (data !== null && typeof data === 'object' && 'data' in data) {
+        const envelope = data;
+        if (envelope.meta !== undefined) {
+            return { items: envelope.data, meta: envelope.meta };
+        }
+        return envelope.data;
+    }
+    return data;
+}
+export class OnlypultApiError extends Error {
+    status;
+    body;
+    constructor(status, body, message) {
+        super(message);
+        this.status = status;
+        this.body = body;
+        this.name = 'OnlypultApiError';
+    }
+}
+async function request(apiKey, method, path, body, query) {
+    const url = new URL(`${API_BASE}${path}`);
+    if (query) {
+        for (const [key, value] of Object.entries(query)) {
+            if (value !== undefined) {
+                url.searchParams.set(key, String(value));
+            }
+        }
+    }
+    const res = await fetch(url.toString(), {
+        method,
+        headers: {
+            'Authorization': `Bearer ${apiKey}`,
+            'Content-Type': 'application/json',
+            'Accept': 'application/json',
+        },
+        body: body !== undefined ? JSON.stringify(body) : undefined,
+    });
+    const data = await res.json().catch(() => null);
+    if (!res.ok) {
+        const body = data;
+        const message = body?.error?.message ?? body?.message ?? `HTTP ${res.status}`;
+        throw new OnlypultApiError(res.status, data, message);
+    }
+    return unwrapResponse(data);
+}
+export async function postForm(apiKey, path, form) {
+    const url = `${API_BASE}${path}`;
+    const res = await fetch(url, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            Accept: 'application/json',
+        },
+        body: form,
+    });
+    const data = await res.json().catch(() => null);
+    if (!res.ok) {
+        const body = data;
+        const message = body?.error?.message ?? body?.message ?? `HTTP ${res.status}`;
+        throw new OnlypultApiError(res.status, data, message);
+    }
+    return unwrapResponse(data);
+}
+export function createApiClient(apiKey) {
+    return {
+        get: (path, query) => request(apiKey, 'GET', path, undefined, query),
+        post: (path, body) => request(apiKey, 'POST', path, body),
+        put: (path, body) => request(apiKey, 'PUT', path, body),
+        delete: (path) => request(apiKey, 'DELETE', path),
+    };
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

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

package/dist/api-error.d.ts

@@ -0,0 +1,9 @@
+import { OnlypultApiError } from './api-client.js';
+export declare function formatApiErrorForAgent(err: OnlypultApiError): string;
+export declare function apiErrorResult(err: unknown): {
+    isError: true;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};

package/dist/api-error.js

@@ -0,0 +1,28 @@
+import { OnlypultApiError } from './api-client.js';
+export function formatApiErrorForAgent(err) {
+    const body = err.body;
+    if (body?.error?.message) {
+        const { code, message, retryable, field } = body.error;
+        const lines = [
+            `Error: ${message}`,
+            code ? `Code: ${code}` : null,
+            field ? `Field: ${field}` : null,
+            retryable === false ? 'Do NOT retry this request — fix the issue first (e.g. renew plan or choose an earlier publish_at).' : null,
+        ].filter(Boolean);
+        return lines.join('\n');
+    }
+    if (body) {
+        return `API error (${err.status}): ${JSON.stringify(body, null, 2)}`;
+    }
+    return `API error (${err.status}): ${err.message}`;
+}
+export function apiErrorResult(err) {
+    if (err instanceof OnlypultApiError) {
+        return {
+            isError: true,
+            content: [{ type: 'text', text: formatApiErrorForAgent(err) }],
+        };
+    }
+    throw err;
+}
+//# sourceMappingURL=api-error.js.map

package/dist/api-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-error.js","sourceRoot":"","sources":["../src/api-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAYnD,MAAM,UAAU,sBAAsB,CAAC,GAAqB;IAC1D,MAAM,IAAI,GAAG,GAAG,CAAC,IAA2B,CAAC;IAE7C,IAAI,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QACzB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QACvD,MAAM,KAAK,GAAG;YACZ,UAAU,OAAO,EAAE;YACnB,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI;YAC7B,KAAK,CAAC,CAAC,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI;YAChC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,oGAAoG,CAAC,CAAC,CAAC,IAAI;SAClI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAElB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,cAAc,GAAG,CAAC,MAAM,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;IACvE,CAAC;IAED,OAAO,cAAc,GAAG,CAAC,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,IAAI,GAAG,YAAY,gBAAgB,EAAE,CAAC;QACpC,OAAO;YACL,OAAO,EAAE,IAAa;YACtB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,sBAAsB,CAAC,GAAG,CAAC,EAAE,CAAC;SACxE,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,CAAC;AACZ,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+/**
+ * @onlypult/mcp — local stdio entrypoint.
+ *
+ * This is the entrypoint end users run via `npx @onlypult/mcp`.
+ * It only supports stdio transport (Cursor, Claude Desktop, Windsurf, etc.)
+ * and requires ONLYPULT_API_KEY to be set. It intentionally does not
+ * include the HTTP/OAuth machinery used by the hosted mcp.onlypult.com
+ * server (see the onlypult-mcp deploy repo).
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createApiClient } from './api-client.js';
+import { readPackageVersion } from './package-version.js';
+import { registerProfileTools } from './tools/profiles.js';
+import { registerPostTools } from './tools/posts.js';
+import { registerMediaTools } from './tools/media.js';
+const API_KEY_PREFIX = 'op_';
+const PACKAGE_VERSION = readPackageVersion();
+function readApiKey() {
+    const fromEnv = process.env.ONLYPULT_API_KEY?.trim();
+    if (fromEnv)
+        return fromEnv;
+    const argIndex = process.argv.findIndex((a) => a === '--api-key');
+    if (argIndex !== -1 && process.argv[argIndex + 1]) {
+        return process.argv[argIndex + 1].trim();
+    }
+    console.error([
+        'Error: missing Onlypult API key.',
+        '',
+        'Set ONLYPULT_API_KEY in your MCP client config, e.g.:',
+        '',
+        '{',
+        '  "mcpServers": {',
+        '    "onlypult": {',
+        '      "command": "npx",',
+        '      "args": ["-y", "@onlypult/mcp@latest"],',
+        '      "env": { "ONLYPULT_API_KEY": "op_your_key_here" }',
+        '    }',
+        '  }',
+        '}',
+        '',
+        'Get a key from Onlypult → Settings → API Keys.',
+    ].join('\n'));
+    process.exit(1);
+}
+function validateApiKey(key) {
+    if (!key.startsWith(API_KEY_PREFIX)) {
+        console.error(`Error: ONLYPULT_API_KEY must start with "${API_KEY_PREFIX}". Get a key from Onlypult → Settings → API Keys.`);
+        process.exit(1);
+    }
+}
+async function main() {
+    const apiKey = readApiKey();
+    validateApiKey(apiKey);
+    const server = new McpServer({ name: 'onlypult-local', version: PACKAGE_VERSION }, { capabilities: { tools: {} } });
+    const ctx = () => ({
+        api: createApiClient(apiKey),
+        apiKey,
+    });
+    registerProfileTools(server, ctx);
+    registerPostTools(server, ctx);
+    registerMediaTools(server, ctx);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // stdout is reserved for JSON-RPC; log startup to stderr only.
+    console.error(`Onlypult MCP (local) v${PACKAGE_VERSION} running via stdio — local file uploads enabled.`);
+}
+main().catch((err) => {
+    console.error('Fatal error starting Onlypult MCP server:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/media-upload.d.ts

@@ -0,0 +1,28 @@
+import { type ApiClient } from './api-client.js';
+export interface UploadSession {
+    token: string;
+    upload_url: string;
+}
+export interface UploadedMediaFile {
+    id: string;
+    url: string | null;
+    type: string | null;
+    filename: string | null;
+    token: string;
+}
+export declare function guessMimeType(fileName: string): string;
+export declare function assertReadableLocalFile(filePath: string): Promise<{
+    resolved: string;
+    size: number;
+    fileName: string;
+}>;
+export declare function createUploadSession(api: ApiClient, options?: {
+    is_story?: boolean;
+    is_reels?: boolean;
+}): Promise<UploadSession>;
+export declare function uploadLocalFile(apiKey: string, api: ApiClient, filePath: string, options?: {
+    token?: string;
+    is_story?: boolean;
+    is_reels?: boolean;
+}): Promise<UploadedMediaFile>;
+export declare function isLocalFileUploadError(err: unknown): boolean;

package/dist/media-upload.js

@@ -0,0 +1,123 @@
+import { access, readFile, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { OnlypultApiError, postForm } from './api-client.js';
+const CHUNK_SIZE = 5 * 1024 * 1024;
+const MIME_BY_EXT = {
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.png': 'image/png',
+    '.webp': 'image/webp',
+    '.gif': 'image/gif',
+    '.mp4': 'video/mp4',
+    '.mov': 'video/quicktime',
+    '.webm': 'video/webm',
+};
+export function guessMimeType(fileName) {
+    const ext = path.extname(fileName).toLowerCase();
+    return MIME_BY_EXT[ext] ?? 'application/octet-stream';
+}
+export async function assertReadableLocalFile(filePath) {
+    const resolved = path.resolve(filePath.trim());
+    if (resolved === '' || resolved === path.sep) {
+        throw new Error('file_path is required');
+    }
+    try {
+        await access(resolved);
+    }
+    catch {
+        throw new Error(`Cannot read file at "${resolved}". `
+            + 'media_upload_file only works when the MCP server runs on the same machine as the file '
+            + '(local Cursor / Claude Desktop stdio). For remote MCP (Claude.ai, ChatGPT) or files outside '
+            + 'the server host, use media_get_upload_url or media_urls in posts_create.');
+    }
+    const fileStat = await stat(resolved);
+    if (!fileStat.isFile()) {
+        throw new Error(`Path is not a file: ${resolved}`);
+    }
+    return {
+        resolved,
+        size: fileStat.size,
+        fileName: path.basename(resolved),
+    };
+}
+export async function createUploadSession(api, options = {}) {
+    return api.post('/v1/media/upload-url', {
+        is_story: options.is_story ?? false,
+        is_reels: options.is_reels ?? false,
+    });
+}
+export async function uploadLocalFile(apiKey, api, filePath, options = {}) {
+    const { resolved, size, fileName } = await assertReadableLocalFile(filePath);
+    const mimeType = guessMimeType(fileName);
+    let token = options.token?.trim();
+    if (!token) {
+        const session = await createUploadSession(api, options);
+        token = session.token;
+    }
+    const file = size > CHUNK_SIZE
+        ? await uploadLargeFile(apiKey, api, token, resolved, fileName, mimeType, size)
+        : await uploadSmallFile(apiKey, token, resolved, fileName);
+    return { ...file, token };
+}
+async function uploadSmallFile(apiKey, token, resolvedPath, fileName) {
+    const buffer = await readFile(resolvedPath);
+    const form = new FormData();
+    form.append('token', token);
+    form.append('file', new Blob([buffer]), fileName);
+    return postForm(apiKey, '/v1/media/upload', form);
+}
+async function uploadLargeFile(apiKey, api, token, resolvedPath, fileName, mimeType, size) {
+    const quantityParts = Math.max(1, Math.ceil(size / CHUNK_SIZE));
+    const init = await api.post('/v1/media/init-multipart-upload', {
+        token,
+        file_name: fileName,
+        mime_type: mimeType,
+        file_size: size,
+        quantity_parts: quantityParts,
+    });
+    if (!init.completeUrl || !init.uploadId) {
+        throw new Error('Multipart upload initialization failed: missing completeUrl or uploadId');
+    }
+    const parts = init.multipartUploadUrls ?? [];
+    if (parts.length === 0) {
+        return uploadSmallFile(apiKey, token, resolvedPath, fileName);
+    }
+    const sortedParts = [...parts].sort((a, b) => a.partNumber - b.partNumber);
+    const fileBuffer = await readFile(resolvedPath);
+    for (let index = 0; index < sortedParts.length; index += 1) {
+        const part = sortedParts[index];
+        const start = index * CHUNK_SIZE;
+        const end = Math.min(start + CHUNK_SIZE, size);
+        const chunk = fileBuffer.subarray(start, end);
+        const putRes = await fetch(part.url, {
+            method: 'PUT',
+            headers: { 'Content-Type': 'application/octet-stream' },
+            body: chunk,
+        });
+        if (!putRes.ok) {
+            throw new Error(`Failed to upload part ${part.partNumber}: HTTP ${putRes.status}`);
+        }
+    }
+    const complete = await fetch(init.completeUrl, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
+        body: JSON.stringify({
+            phase: 'finish',
+            session_id: init.uploadId,
+        }),
+    });
+    const completeData = await complete.json().catch(() => null);
+    if (!complete.ok || !completeData?.fid) {
+        throw new OnlypultApiError(complete.status, completeData, completeData?.success === false
+            ? 'Multipart complete failed'
+            : `Multipart complete failed: HTTP ${complete.status}`);
+    }
+    return api.post('/v1/media/upload', {
+        token,
+        from_fid: completeData.fid,
+    });
+}
+export function isLocalFileUploadError(err) {
+    return err instanceof Error && err.message.includes('media_upload_file only works');
+}
+//# sourceMappingURL=media-upload.js.map

package/dist/media-upload.js.map

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

package/dist/package-version.d.ts

@@ -0,0 +1,2 @@
+/** Read version from package.json at publish/install root (one level above dist/). */
+export declare function readPackageVersion(): string;

package/dist/package-version.js

@@ -0,0 +1,10 @@
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** Read version from package.json at publish/install root (one level above dist/). */
+export function readPackageVersion() {
+    const packagePath = join(dirname(fileURLToPath(import.meta.url)), '../package.json');
+    const pkg = JSON.parse(readFileSync(packagePath, 'utf8'));
+    return pkg.version;
+}
+//# sourceMappingURL=package-version.js.map

package/dist/package-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-version.js","sourceRoot":"","sources":["../src/package-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,sFAAsF;AACtF,MAAM,UAAU,kBAAkB;IAChC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;IACrF,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAwB,CAAC;IACjF,OAAO,GAAG,CAAC,OAAO,CAAC;AACrB,CAAC"}