@thenavidm/threads-mcp-cli 1.1.0

package/dist/tools/index.d.ts

@@ -0,0 +1,3 @@
+/** Every tool, in the order they should appear in a client's tool list. */
+import type { AnyToolSpec } from "./kit.js";
+export declare const ALL_TOOLS: AnyToolSpec[];

package/dist/tools/index.js

@@ -0,0 +1,16 @@
+/** Every tool, in the order they should appear in a client's tool list. */
+import { ACCOUNT_TOOLS } from "./accounts.js";
+import { POST_TOOLS } from "./posts.js";
+import { REPLY_TOOLS } from "./replies.js";
+import { READ_TOOLS } from "./read.js";
+import { INSIGHT_TOOLS } from "./insights.js";
+import { DISCOVER_TOOLS } from "./discover.js";
+export const ALL_TOOLS = [
+    ...ACCOUNT_TOOLS,
+    ...POST_TOOLS,
+    ...REPLY_TOOLS,
+    ...READ_TOOLS,
+    ...INSIGHT_TOOLS,
+    ...DISCOVER_TOOLS,
+];
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAE3E,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,GAAG,aAAa;IAChB,GAAG,UAAU;IACb,GAAG,WAAW;IACd,GAAG,UAAU;IACb,GAAG,aAAa;IAChB,GAAG,cAAc;CACU,CAAC"}

package/dist/tools/insights.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Insights.
+ *
+ * Threads reports metrics in three different envelopes depending on the metric,
+ * and the difference is not documented anywhere near the metric list:
+ *
+ *   total_value   {"value": 42}                    likes, replies, followers
+ *   time_series   {"values":[{"value":…,"end_time":…}]}   views
+ *   breakdown     nested by dimension               follower_demographics
+ *
+ * Handed to a model raw, those three shapes mean it has to guess where the
+ * number is, and it guesses wrong on `views` about half the time because that
+ * is the one that is a series. They are flattened here into one shape.
+ *
+ * `get_top_posts` is the tool that does not map to an endpoint. Ranking by
+ * absolute likes tells you which posts are old; ranking by engagement against
+ * views tells you which ones worked. That means a fetch per post, so it is
+ * bounded and says what it sampled.
+ */
+import { z } from "zod";
+export declare const getPostInsights: import("./kit.js").ToolSpec<{
+    account: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+}>;
+export declare const getAccountInsights: import("./kit.js").ToolSpec<{
+    account: z.ZodOptional<z.ZodString>;
+    since: z.ZodOptional<z.ZodString>;
+    until: z.ZodOptional<z.ZodString>;
+    metrics: z.ZodOptional<z.ZodArray<z.ZodEnum<["views", "likes", "replies", "reposts", "quotes", "clicks", "followers_count"]>, "many">>;
+}>;
+export declare const getFollowerDemographics: import("./kit.js").ToolSpec<{
+    account: z.ZodOptional<z.ZodString>;
+    breakdown: z.ZodEnum<["country", "city", "age", "gender"]>;
+}>;
+export declare const getTopPosts: import("./kit.js").ToolSpec<{
+    account: z.ZodOptional<z.ZodString>;
+    sample: z.ZodOptional<z.ZodNumber>;
+    sort_by: z.ZodOptional<z.ZodEnum<["engagement_rate", "views", "likes", "replies", "reposts", "quotes"]>>;
+}>;
+export declare const INSIGHT_TOOLS: (import("./kit.js").ToolSpec<{
+    account: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+}> | import("./kit.js").ToolSpec<{
+    account: z.ZodOptional<z.ZodString>;
+    since: z.ZodOptional<z.ZodString>;
+    until: z.ZodOptional<z.ZodString>;
+    metrics: z.ZodOptional<z.ZodArray<z.ZodEnum<["views", "likes", "replies", "reposts", "quotes", "clicks", "followers_count"]>, "many">>;
+}> | import("./kit.js").ToolSpec<{
+    account: z.ZodOptional<z.ZodString>;
+    breakdown: z.ZodEnum<["country", "city", "age", "gender"]>;
+}> | import("./kit.js").ToolSpec<{
+    account: z.ZodOptional<z.ZodString>;
+    sample: z.ZodOptional<z.ZodNumber>;
+    sort_by: z.ZodOptional<z.ZodEnum<["engagement_rate", "views", "likes", "replies", "reposts", "quotes"]>>;
+}>)[];

package/dist/tools/insights.js

@@ -0,0 +1,223 @@
+/**
+ * Insights.
+ *
+ * Threads reports metrics in three different envelopes depending on the metric,
+ * and the difference is not documented anywhere near the metric list:
+ *
+ *   total_value   {"value": 42}                    likes, replies, followers
+ *   time_series   {"values":[{"value":…,"end_time":…}]}   views
+ *   breakdown     nested by dimension               follower_demographics
+ *
+ * Handed to a model raw, those three shapes mean it has to guess where the
+ * number is, and it guesses wrong on `views` about half the time because that
+ * is the one that is a series. They are flattened here into one shape.
+ *
+ * `get_top_posts` is the tool that does not map to an endpoint. Ranking by
+ * absolute likes tells you which posts are old; ranking by engagement against
+ * views tells you which ones worked. That means a fetch per post, so it is
+ * bounded and says what it sampled.
+ */
+import { z } from "zod";
+import { accountArg, clamp, defineTool } from "./kit.js";
+import { POST_FIELDS } from "../api/client.js";
+import { dataOf } from "../format/posts.js";
+import { requireMediaId } from "../api/identity.js";
+const POST_METRICS = ["views", "likes", "replies", "reposts", "quotes", "shares"];
+const ACCOUNT_METRICS = ["views", "likes", "replies", "reposts", "quotes", "clicks", "followers_count"];
+/** Flatten Meta's three insight envelopes into one name-to-number map. */
+function flatten(rows) {
+    const out = {};
+    for (const row of rows) {
+        if (!row.name)
+            continue;
+        if (typeof row.total_value?.value === "number") {
+            out[row.name] = row.total_value.value;
+            continue;
+        }
+        if (Array.isArray(row.values)) {
+            // A time series is summed. For `views` over a window that is the number
+            // people mean; the series itself is returned separately when asked for.
+            out[row.name] = row.values.reduce((sum, v) => sum + (typeof v.value === "number" ? v.value : 0), 0);
+        }
+    }
+    return out;
+}
+export const getPostInsights = defineTool({
+    name: "get_post_insights",
+    title: "Metrics for one post",
+    description: "Views, likes, replies, reposts, quotes and shares for one of your posts. Reply metrics count direct replies only, not the whole tree underneath.",
+    schema: {
+        id: z.string().describe("Numeric post id."),
+        ...accountArg,
+    },
+    risk: "read",
+    handler: async (args, ctx) => {
+        const account = ctx.account(args.account);
+        const id = requireMediaId(args.id);
+        const response = (await ctx.client.call(account, `/${id}/insights`, {
+            params: { metric: POST_METRICS.join(",") },
+        }));
+        const metrics = flatten(dataOf(response));
+        const views = metrics.views ?? 0;
+        const interactions = (metrics.likes ?? 0) + (metrics.replies ?? 0) + (metrics.reposts ?? 0) + (metrics.quotes ?? 0);
+        return {
+            post_id: id,
+            ...metrics,
+            ...(views > 0 ? { engagement_rate: Number(((interactions / views) * 100).toFixed(2)) } : {}),
+            note: Object.keys(metrics).length
+                ? undefined
+                : "No metrics returned. Reposts of other people's posts have none, and insights need the threads_manage_insights scope.",
+        };
+    },
+});
+export const getAccountInsights = defineTool({
+    name: "get_account_insights",
+    title: "Metrics for the whole profile",
+    description: "Profile-level views, likes, replies, reposts, quotes, link clicks and follower count. Data starts on 13 April 2024 and is not reliable before 1 June 2024; earlier windows return nothing.",
+    schema: {
+        since: z.string().optional().describe("ISO date or Unix timestamp. Nothing before 2024-04-13 is available."),
+        until: z.string().optional().describe("ISO date or Unix timestamp."),
+        metrics: z
+            .array(z.enum(ACCOUNT_METRICS))
+            .optional()
+            .describe("Which metrics to fetch. Defaults to all of them."),
+        ...accountArg,
+    },
+    risk: "read",
+    handler: async (args, ctx) => {
+        const account = ctx.account(args.account);
+        const userId = await ctx.client.userId(account);
+        const wanted = args.metrics?.length ? args.metrics : ACCOUNT_METRICS;
+        // followers_count rejects a date range, so it is fetched on its own
+        // whenever a window was given. Sending it with since/until fails the whole
+        // call, taking every other metric down with it.
+        const windowed = wanted.filter((m) => m !== "followers_count");
+        const wantsFollowers = wanted.includes("followers_count");
+        const hasWindow = Boolean(args.since || args.until);
+        const results = {};
+        if (windowed.length) {
+            const response = (await ctx.client.call(account, `/${userId}/threads_insights`, {
+                params: { metric: windowed.join(","), since: args.since, until: args.until },
+            }));
+            Object.assign(results, flatten(dataOf(response)));
+        }
+        if (wantsFollowers) {
+            const response = (await ctx.client.call(account, `/${userId}/threads_insights`, {
+                params: { metric: "followers_count" },
+            }));
+            Object.assign(results, flatten(dataOf(response)));
+        }
+        return {
+            account: account.username ?? userId,
+            ...(hasWindow ? { since: args.since ?? null, until: args.until ?? null } : { window: "lifetime" }),
+            ...results,
+            ...(wantsFollowers && hasWindow
+                ? { note: "followers_count is a current total and ignores the date range." }
+                : {}),
+        };
+    },
+});
+export const getFollowerDemographics = defineTool({
+    name: "get_follower_demographics",
+    title: "Who follows this profile",
+    description: "Follower breakdown by country, city, age or gender. One dimension per call: Threads refuses more than one breakdown at a time. Needs at least 100 followers, and ignores any date range.",
+    schema: {
+        breakdown: z
+            .enum(["country", "city", "age", "gender"])
+            .describe("Which dimension to break followers down by. Only one per call."),
+        ...accountArg,
+    },
+    risk: "read",
+    handler: async (args, ctx) => {
+        const account = ctx.account(args.account);
+        const userId = await ctx.client.userId(account);
+        const response = (await ctx.client.call(account, `/${userId}/threads_insights`, {
+            params: { metric: "follower_demographics", breakdown: args.breakdown },
+        }));
+        const row = dataOf(response)[0];
+        const results = row?.total_value?.breakdowns?.[0]?.results ?? [];
+        const buckets = results
+            .map((r) => ({ value: r.dimension_values?.[0] ?? "unknown", followers: r.value ?? 0 }))
+            .sort((a, b) => b.followers - a.followers);
+        return {
+            breakdown: args.breakdown,
+            total: buckets.reduce((sum, b) => sum + b.followers, 0),
+            buckets,
+            ...(buckets.length
+                ? {}
+                : { note: "Nothing returned. Follower demographics need at least 100 followers and the threads_manage_insights scope." }),
+        };
+    },
+});
+export const getTopPosts = defineTool({
+    name: "get_top_posts",
+    title: "Rank your posts by what actually worked",
+    description: "Fetch recent posts, pull the metrics for each, and rank them. Sorting by engagement rate rather than raw likes is the point: absolute likes mostly rank posts by age, while engagement against views shows which ones landed. Costs one request per post, so keep the sample modest.",
+    schema: {
+        sample: z
+            .number()
+            .int()
+            .min(1)
+            .max(50)
+            .optional()
+            .describe("How many recent posts to score. Defaults to 20, capped at 50 because each one is a request."),
+        sort_by: z
+            .enum(["engagement_rate", "views", "likes", "replies", "reposts", "quotes"])
+            .optional()
+            .describe("Ranking key. Defaults to engagement_rate."),
+        ...accountArg,
+    },
+    risk: "read",
+    handler: async (args, ctx) => {
+        const account = ctx.account(args.account);
+        const userId = await ctx.client.userId(account);
+        const sample = clamp(args.sample, 20, 50);
+        const sortBy = args.sort_by ?? "engagement_rate";
+        const listing = (await ctx.client.call(account, `/${userId}/threads`, {
+            params: { fields: POST_FIELDS, limit: sample },
+        }));
+        const posts = dataOf(listing);
+        const scored = await Promise.all(posts.map(async (post) => {
+            try {
+                const response = (await ctx.client.call(account, `/${post.id}/insights`, {
+                    params: { metric: POST_METRICS.join(",") },
+                }));
+                const metrics = flatten(dataOf(response));
+                const views = metrics.views ?? 0;
+                const interactions = (metrics.likes ?? 0) + (metrics.replies ?? 0) + (metrics.reposts ?? 0) + (metrics.quotes ?? 0);
+                return {
+                    id: String(post.id),
+                    permalink: post.permalink,
+                    posted_at: post.timestamp,
+                    excerpt: typeof post.text === "string" ? post.text.replace(/\s+/g, " ").slice(0, 120) : "",
+                    media_type: post.media_type,
+                    views,
+                    likes: metrics.likes ?? 0,
+                    replies: metrics.replies ?? 0,
+                    reposts: metrics.reposts ?? 0,
+                    quotes: metrics.quotes ?? 0,
+                    engagement_rate: views > 0 ? Number(((interactions / views) * 100).toFixed(2)) : 0,
+                };
+            }
+            catch {
+                return null;
+            }
+        }));
+        const rows = scored.filter((r) => r !== null);
+        rows.sort((a, b) => b[sortBy] - a[sortBy]);
+        const withViews = rows.filter((r) => r.views > 0).length;
+        return {
+            sampled: posts.length,
+            scored: rows.length,
+            sorted_by: sortBy,
+            posts: rows,
+            ...(sortBy === "engagement_rate" && withViews < rows.length
+                ? {
+                    note: `${rows.length - withViews} post(s) reported no views, so their engagement rate is 0 rather than unknown. Sort by likes to include them fairly.`,
+                }
+                : {}),
+        };
+    },
+});
+export const INSIGHT_TOOLS = [getPostInsights, getAccountInsights, getFollowerDemographics, getTopPosts];
+//# sourceMappingURL=insights.js.map

package/dist/tools/insights.js.map

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

package/dist/tools/kit.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Shared plumbing every tool uses.
+ *
+ * Registering thirty tools by hand is thirty chances to forget an annotation,
+ * leak a stack trace, or return a shape the model cannot read. This wraps all
+ * of it once so a tool module only describes what it actually does.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z, type ZodRawShape } from "zod";
+import type { ThreadsClient } from "../api/client.js";
+import type { Account, Config } from "../config.js";
+import { type Risk, type WriteGuard } from "../safety.js";
+export type ToolContext = {
+    client: ThreadsClient;
+    config: Config;
+    guard: WriteGuard;
+    /** Resolve which profile this call acts as. */
+    account: (hint?: string) => Account;
+};
+export type ToolResult = {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: boolean;
+};
+/**
+ * A tool returns either a pre-rendered string or a value to serialise.
+ *
+ * The reading tools return the tagged format from `format/posts.ts`, which is
+ * already text. The writing tools return a small object, an id and a permalink,
+ * where JSON is clearer than tags. Both go through here so neither has to think
+ * about the MCP content envelope.
+ */
+export declare function ok(data: unknown): ToolResult;
+/**
+ * Errors come back as a normal result with `isError`, not a thrown exception.
+ *
+ * A thrown MCP error reaches the model as a protocol failure with no structure.
+ * A result it can read tells it what went wrong and usually how to fix it,
+ * which is the difference between a correct retry and a give-up.
+ */
+export declare function fail(error: unknown): ToolResult;
+/** The optional argument that picks a profile, on every account-scoped tool. */
+export declare const accountArg: {
+    account: z.ZodOptional<z.ZodString>;
+};
+/** The confirmation argument required by every public or irreversible tool. */
+export declare const confirmArg: {
+    confirm: z.ZodOptional<z.ZodBoolean>;
+};
+/** Cursor and limit, on every paginating tool. */
+export declare const pageArgs: {
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+};
+export type ToolSpec<S extends ZodRawShape> = {
+    name: string;
+    /** One line, imperative. Shown in tool pickers. */
+    title: string;
+    description: string;
+    schema: S;
+    risk: Risk;
+    /** True when calling twice has the same effect as calling once. */
+    idempotent?: boolean;
+    handler: (args: z.infer<z.ZodObject<S>>, ctx: ToolContext) => Promise<unknown>;
+    /** One line for the audit log and the confirm message, when this is a write. */
+    summary?: (args: z.infer<z.ZodObject<S>>) => string;
+};
+export declare function defineTool<S extends ZodRawShape>(spec: ToolSpec<S>): ToolSpec<S>;
+/**
+ * A tool of any shape, for the one place tools are held together in a list.
+ *
+ * `ToolSpec` is generic over its schema, so a list of tools with different
+ * schemas has no single type: each handler takes a different argument shape and
+ * function parameters are contravariant. The type safety that matters lives
+ * inside each `defineTool` call, where schema and handler are checked against
+ * each other. This only loosens the seam where they are collected.
+ */
+export type AnyToolSpec = Omit<ToolSpec<ZodRawShape>, "handler" | "summary"> & {
+    handler: (args: never, ctx: ToolContext) => Promise<unknown>;
+    summary?: (args: never) => string;
+};
+/** Register one tool against the server, with guarding and error handling applied. */
+export declare function register(server: McpServer, contextFor: (extra: unknown) => ToolContext, spec: AnyToolSpec): void;
+export declare function makeContext(client: ThreadsClient, config: Config, guard: WriteGuard): ToolContext;
+/** Clamp a caller-supplied limit into a range Threads will accept. */
+export declare function clamp(value: number | undefined, fallback: number, max?: number): number;
+/** Trim a summary to one readable line for the audit log. */
+export declare function snippet(text: string | undefined, length?: number): string;

package/dist/tools/kit.js

@@ -0,0 +1,119 @@
+/**
+ * Shared plumbing every tool uses.
+ *
+ * Registering thirty tools by hand is thirty chances to forget an annotation,
+ * leak a stack trace, or return a shape the model cannot read. This wraps all
+ * of it once so a tool module only describes what it actually does.
+ */
+import { z } from "zod";
+import { ThreadsError } from "../api/errors.js";
+import { selectAccount } from "../config.js";
+import { annotationsFor } from "../safety.js";
+/**
+ * A tool returns either a pre-rendered string or a value to serialise.
+ *
+ * The reading tools return the tagged format from `format/posts.ts`, which is
+ * already text. The writing tools return a small object, an id and a permalink,
+ * where JSON is clearer than tags. Both go through here so neither has to think
+ * about the MCP content envelope.
+ */
+export function ok(data) {
+    const text = typeof data === "string" ? data : JSON.stringify(data, null, 2);
+    return { content: [{ type: "text", text }] };
+}
+/**
+ * Errors come back as a normal result with `isError`, not a thrown exception.
+ *
+ * A thrown MCP error reaches the model as a protocol failure with no structure.
+ * A result it can read tells it what went wrong and usually how to fix it,
+ * which is the difference between a correct retry and a give-up.
+ */
+export function fail(error) {
+    const payload = error instanceof ThreadsError
+        ? error.toJSON()
+        : { error: error?.message ?? String(error) };
+    return { content: [{ type: "text", text: JSON.stringify(payload, null, 2) }], isError: true };
+}
+/** The optional argument that picks a profile, on every account-scoped tool. */
+export const accountArg = {
+    account: z
+        .string()
+        .optional()
+        .describe("Which connected Threads profile to act as, by username (for example 'thenavidm'). Defaults to the first connected profile. Call list_accounts to see them."),
+};
+/** The confirmation argument required by every public or irreversible tool. */
+export const confirmArg = {
+    confirm: z
+        .boolean()
+        .optional()
+        .describe("Must be true for this to run. The result is public immediately or cannot be undone, so it is refused without an explicit confirmation. Threads has no edit endpoint and no unsend."),
+};
+/** Cursor and limit, on every paginating tool. */
+export const pageArgs = {
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe("How many to return, 1-100."),
+    cursor: z
+        .string()
+        .optional()
+        .describe("Continue from a previous page. Pass the `cursor` attribute from the last result."),
+};
+export function defineTool(spec) {
+    return spec;
+}
+/** Register one tool against the server, with guarding and error handling applied. */
+export function register(server, contextFor, spec) {
+    server.registerTool(spec.name, {
+        title: spec.title,
+        description: spec.description,
+        inputSchema: spec.schema,
+        annotations: {
+            title: spec.title,
+            ...annotationsFor(spec.risk, { idempotent: spec.idempotent }),
+        },
+    }, 
+    // The SDK derives its callback type from the schema generic. This wrapper is
+    // generic over the same shape, but TypeScript cannot prove the two are equal
+    // through the indirection, so the cast lives at this single boundary rather
+    // than in every tool definition.
+    (async (args, extra) => {
+        try {
+            const ctx = contextFor(extra);
+            if (spec.risk !== "read") {
+                const summary = spec.summary?.(args) ?? spec.name;
+                const confirm = args.confirm;
+                ctx.guard.check(spec.name, spec.risk, confirm, summary);
+            }
+            return ok(await spec.handler(args, ctx));
+        }
+        catch (error) {
+            return fail(error);
+        }
+    }));
+}
+export function makeContext(client, config, guard) {
+    return {
+        client,
+        config,
+        guard,
+        account: (hint) => selectAccount(config, hint),
+    };
+}
+/** Clamp a caller-supplied limit into a range Threads will accept. */
+export function clamp(value, fallback, max = 100) {
+    if (value === undefined || !Number.isFinite(value))
+        return fallback;
+    return Math.min(Math.max(Math.trunc(value), 1), max);
+}
+/** Trim a summary to one readable line for the audit log. */
+export function snippet(text, length = 60) {
+    if (!text)
+        return "";
+    const flat = text.replace(/\s+/g, " ").trim();
+    return flat.length > length ? `${flat.slice(0, length - 1)}…` : flat;
+}
+//# sourceMappingURL=kit.js.map

package/dist/tools/kit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kit.js","sourceRoot":"","sources":["../../src/tools/kit.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,CAAC,EAAoB,MAAM,KAAK,CAAC;AAE1C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,cAAc,EAA8B,MAAM,cAAc,CAAC;AAe1E;;;;;;;GAOG;AACH,MAAM,UAAU,EAAE,CAAC,IAAa;IAC9B,MAAM,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7E,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,IAAI,CAAC,KAAc;IACjC,MAAM,OAAO,GACX,KAAK,YAAY,YAAY;QAC3B,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE;QAChB,CAAC,CAAC,EAAE,KAAK,EAAG,KAAe,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC5D,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAChG,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,4JAA4J,CAC7J;CACJ,CAAC;AAEF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE,CAAC;SACP,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,oLAAoL,CACrL;CACJ,CAAC;AAEF,kDAAkD;AAClD,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4BAA4B,CAAC;IACzC,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kFAAkF,CAAC;CAChG,CAAC;AAgBF,MAAM,UAAU,UAAU,CAAwB,IAAiB;IACjE,OAAO,IAAI,CAAC;AACd,CAAC;AAgBD,sFAAsF;AACtF,MAAM,UAAU,QAAQ,CACtB,MAAiB,EACjB,UAA2C,EAC3C,IAAiB;IAEjB,MAAM,CAAC,YAAY,CACjB,IAAI,CAAC,IAAI,EACT;QACE,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,MAAM;QACxB,WAAW,EAAE;YACX,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;SAC9D;KACF;IACD,6EAA6E;IAC7E,6EAA6E;IAC7E,4EAA4E;IAC5E,iCAAiC;IACjC,CAAC,KAAK,EAAE,IAA6B,EAAE,KAAc,EAAE,EAAE;QACvD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;YAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACzB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,IAAa,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC;gBAC3D,MAAM,OAAO,GAAI,IAA8B,CAAC,OAAO,CAAC;gBACxD,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1D,CAAC;YACD,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAa,EAAE,GAAG,CAAC,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CAAU,CACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAqB,EAAE,MAAc,EAAE,KAAiB;IAClF,OAAO;QACL,MAAM;QACN,MAAM;QACN,KAAK;QACL,OAAO,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC;KACxD,CAAC;AACJ,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,KAAK,CAAC,KAAyB,EAAE,QAAgB,EAAE,GAAG,GAAG,GAAG;IAC1E,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IACpE,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACvD,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,OAAO,CAAC,IAAwB,EAAE,MAAM,GAAG,EAAE;IAC3D,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,OAAO,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACvE,CAAC"}