@cursor/july 0.1.1

package/dist/channels/github/types.d.ts

@@ -0,0 +1,385 @@
+import type { AgentCloudOptions, AuthContext, AuthPolicy, ChannelEventHandlers, ChannelStartArgs, HostContext } from "../../types.js";
+import type { GitHubApiOptions } from "./api.js";
+import type { GitHubHandle, GitHubThread } from "./binding.js";
+import type { GitHubProgressConfig } from "./defaults.js";
+import type { GitHubChannelState } from "./state.js";
+/** A credential value: a literal or a lazy resolver fetched on demand. */
+export type GitHubCredentialValue = string | (() => string | undefined | Promise<string | undefined>);
+/**
+ * GitHub webhook + API credentials. Every field falls back to an env var
+ * (or `gh auth token` for API calls), so you can drop the `credentials`
+ * block entirely once these are set:
+ *
+ * ```bash
+ * GITHUB_WEBHOOK_SECRET=...        # verifies the webhook signature
+ * GITHUB_APP_ID=...                # App JWT path (preferred in production)
+ * GITHUB_APP_PRIVATE_KEY=...
+ * GITHUB_APP_INSTALLATION_ID=...   # host / non-webhook App auth
+ * GITHUB_APP_SLUG=...              # supplies botName when it is not set in config
+ * GITHUB_TOKEN=...                 # local PAT fallback (or GH_TOKEN / `gh auth`)
+ * ```
+ *
+ * API auth prefers App installation tokens when App credentials are set,
+ * then falls back to `GITHUB_TOKEN` / `GH_TOKEN` / `gh auth token` for local
+ * testing.
+ */
+export interface GitHubChannelCredentials {
+    /**
+     * Webhook secret used to verify `X-Hub-Signature-256` before parsing the
+     * payload. Falls back to `GITHUB_WEBHOOK_SECRET`.
+     */
+    webhookSecret?: GitHubCredentialValue;
+    /**
+     * Explicit bearer token for GitHub REST calls. Prefer this only when you
+     * intentionally override ambient auth (e.g. tests). Falls back to App
+     * installation tokens, then `GITHUB_TOKEN` / `GH_TOKEN` / `gh auth token`.
+     */
+    token?: GitHubCredentialValue;
+    /**
+     * Pre-resolved installation access token (Connect-style). Same effect as
+     * {@link token} for API calls; skips App JWT exchange.
+     */
+    installationToken?: GitHubCredentialValue;
+    /** GitHub App id for installation-token minting. Falls back to `GITHUB_APP_ID`. */
+    appId?: GitHubCredentialValue | number;
+    /** GitHub App private key (PEM). Falls back to `GITHUB_APP_PRIVATE_KEY`. */
+    privateKey?: GitHubCredentialValue;
+}
+/** @deprecated Prefer {@link GitHubChannelCredentials}. */
+export type GitHubCredentials = GitHubChannelCredentials;
+export type GitHubPullRequestAction = "opened" | "reopened" | "synchronize" | "ready_for_review" | "edited" | "closed" | "labeled" | "unlabeled" | "assigned" | "unassigned" | "review_requested" | "review_request_removed" | "converted_to_draft";
+export type GitHubIssueAction = "opened" | "edited" | "closed" | "reopened" | "labeled" | "unlabeled" | "assigned" | "unassigned";
+export type GitHubConversationKind = "issue" | "pull_request" | "review_thread";
+export type GitHubCiAction = "created" | "completed" | "rerequested" | "requested_action";
+export type GitHubCiConclusion = "success" | "failure" | "neutral" | "cancelled" | "timed_out" | "action_required" | "stale" | "skipped" | null;
+export type GitHubCiStatus = "queued" | "in_progress" | "completed" | "waiting" | "requested" | "pending" | string;
+/** Normalized actor on a delivery. */
+export interface GitHubUser {
+    login: string;
+    id?: number;
+    type?: "User" | "Bot" | "Organization" | string;
+}
+/** Normalized repository on a delivery. */
+export interface GitHubRepositoryRef {
+    fullName: string;
+    url: string;
+    owner: string;
+    name: string;
+    id?: number;
+}
+/**
+ * Wire shape of the `pull_request` webhook payload, narrowed to the fields
+ * the channel consumes.
+ */
+export type GitHubPullRequestPayload = {
+    action: string;
+    repository: {
+        id?: number;
+        full_name: string;
+        html_url: string;
+        name?: string;
+        owner?: {
+            login?: string;
+        };
+    };
+    pull_request: {
+        number: number;
+        html_url: string;
+        title: string;
+        body?: string | null;
+        draft?: boolean;
+        user?: {
+            login?: string;
+            id?: number;
+            type?: string;
+        } | null;
+        head: {
+            ref: string;
+            sha: string;
+        };
+        base: {
+            ref: string;
+            sha?: string;
+        };
+    };
+    sender?: {
+        login?: string;
+        id?: number;
+        type?: string;
+    } | null;
+    installation?: {
+        id?: number;
+    } | null;
+};
+/** Normalized `pull_request` event handed to {@link GitHubPullRequestHook}. */
+export interface GitHubPullRequestEvent {
+    action: GitHubPullRequestAction | string;
+    number: number;
+    url: string;
+    title: string;
+    body?: string;
+    headRef: string;
+    headSha: string;
+    baseRef: string;
+    baseSha?: string;
+    draft: boolean;
+    authorLogin?: string;
+}
+/** Normalized `issues` event. */
+export interface GitHubIssueEvent {
+    action: GitHubIssueAction | string;
+    number: number;
+    url: string;
+    title: string;
+    body?: string;
+    authorLogin?: string;
+}
+/** Normalized comment on an issue, PR timeline, or review thread. */
+export interface GitHubComment {
+    id: number;
+    body: string;
+    url: string;
+    htmlUrl: string;
+    author?: GitHubUser;
+    /** Present for inline review comments. */
+    path?: string;
+    line?: number | null;
+    pullRequestReviewId?: number | null;
+    /** Root or parent review comment when this comment is a thread reply. */
+    inReplyToId?: number;
+}
+/** Shared CI fields across check_suite / check_run / workflow_run. */
+export interface GitHubCiPullRequestRef {
+    number: number;
+    url?: string;
+}
+export interface GitHubCiAppRef {
+    slug?: string;
+    name?: string;
+}
+export interface GitHubCiBase {
+    action: GitHubCiAction | string;
+    status?: GitHubCiStatus;
+    conclusion?: GitHubCiConclusion;
+    headSha: string;
+    app: GitHubCiAppRef;
+    pullRequests: GitHubCiPullRequestRef[];
+}
+export interface GitHubCheckSuiteEvent extends GitHubCiBase {
+    checkSuiteId: number;
+}
+export interface GitHubCheckRunEvent extends GitHubCiBase {
+    checkRunId: number;
+    name?: string;
+    checkSuiteId?: number;
+}
+export interface GitHubWorkflowRunEvent extends GitHubCiBase {
+    workflowRunId: number;
+    name?: string;
+    workflowId?: number;
+    htmlUrl?: string;
+}
+/**
+ * Legacy commit `status` webhook (Statuses API). Distinct from Checks /
+ * Actions events — use {@link GitHubChannelOptions.onStatus}.
+ */
+export interface GitHubStatusEvent {
+    state: "pending" | "success" | "failure" | "error" | string;
+    context: string;
+    description?: string | null;
+    targetUrl?: string | null;
+    sha: string;
+    name?: string;
+    branches: Array<{
+        name: string;
+        commit?: {
+            sha?: string;
+        };
+    }>;
+    commit?: {
+        sha?: string;
+        htmlUrl?: string;
+    };
+    raw: unknown;
+}
+/**
+ * Raw webhook envelope for {@link GitHubChannelOptions.onEvent}. Prefer
+ * typed hooks (`onComment`, `onPullRequest`, …) when possible.
+ */
+export interface GitHubRawEvent {
+    eventName: string;
+    deliveryId?: string;
+    action?: string;
+    payload: unknown;
+}
+/**
+ * Per-delivery context shared by every inbound hook: where the event landed,
+ * who triggered it, delivery-scoped GitHub helpers (`github` / `thread`), and
+ * shared host services (`host`) for MCP / host GitHub / Slack.
+ */
+export interface GitHubEventContext {
+    /** `X-GitHub-Delivery` header, when present. */
+    deliveryId?: string;
+    /** `X-GitHub-Event` header. */
+    eventName: string;
+    repository: GitHubRepositoryRef;
+    /** The thread the session is anchored to. */
+    conversation: {
+        kind: GitHubConversationKind;
+        number: number;
+        url: string;
+    };
+    /** Login of the actor that triggered the delivery. */
+    senderLogin?: string;
+    sender?: GitHubUser;
+    /** Installation id from the webhook payload, when present. */
+    installationId?: number;
+    /** Authenticated GitHub helpers (`getOctokit`, `request`, `createStatus`). */
+    github: GitHubHandle;
+    /** Post / react on the conversation thread. */
+    thread: GitHubThread;
+    /** Shared host services (MCP / host GitHub / Slack). Same as tool `ctx.host`. */
+    host: HostContext;
+}
+/**
+ * A hook's decision to handle an inbound event. Return `null` from the hook
+ * to ignore the delivery instead.
+ */
+export type GitHubDispatch = GitHubTurnDispatch | GitHubTaskDispatch;
+/** Start (or resume) a model turn for the event. */
+export interface GitHubTurnDispatch {
+    /** Who the turn runs as. Use `defaultGitHubAuth(ctx)` to derive it from the actor. */
+    auth: AuthContext | null;
+    /** Extra prompt lines appended to the default event message. */
+    context?: readonly string[];
+    /** Optional message override (comment hooks use the comment body by default). */
+    message?: string;
+    /** Optional session title override. */
+    title?: string;
+}
+/**
+ * Run a host-side handler for the event instead of a model turn. The task
+ * runs in the background (`waitUntil`) after the webhook is acknowledged
+ * with a 202, so it can outlive GitHub's ~10s delivery timeout.
+ */
+export interface GitHubTaskDispatch {
+    task: () => void | Promise<void>;
+}
+export type GitHubDispatchResult = GitHubDispatch | null | Promise<GitHubDispatch | null>;
+/**
+ * Inbound `pull_request` hook. Return `{ auth }` to dispatch a turn,
+ * `{ task }` to run a host-side handler, or `null` to ignore the delivery.
+ * Without this hook the channel keeps the agent-serve default action gate
+ * (opened / reopened / synchronize / ready_for_review). Eve has no default —
+ * declare the hook for Eve-style opt-in dispatch.
+ */
+export type GitHubPullRequestHook = (ctx: GitHubEventContext, pullRequest: GitHubPullRequestEvent) => GitHubDispatchResult;
+/**
+ * Invoked for every `@mention` of the bot in an issue/PR timeline comment or
+ * an inline review comment; `ctx.conversation.kind` distinguishes the surface.
+ * Return `{ auth }` to dispatch or `null` to ignore. Replaces the default
+ * mention gate when declared.
+ */
+export type GitHubCommentHook = (ctx: GitHubEventContext, comment: GitHubComment) => GitHubDispatchResult;
+/** Opt-in `issues` webhook hook. No default dispatch. */
+export type GitHubIssueHook = (ctx: GitHubEventContext, issue: GitHubIssueEvent) => GitHubDispatchResult;
+/** Opt-in `check_suite` webhook hook. No default dispatch. */
+export type GitHubCheckSuiteHook = (ctx: GitHubEventContext, checkSuite: GitHubCheckSuiteEvent) => GitHubDispatchResult;
+/** Opt-in `check_run` webhook hook. No default dispatch. */
+export type GitHubCheckRunHook = (ctx: GitHubEventContext, checkRun: GitHubCheckRunEvent) => GitHubDispatchResult;
+/** Opt-in `workflow_run` webhook hook. No default dispatch. */
+export type GitHubWorkflowRunHook = (ctx: GitHubEventContext, workflowRun: GitHubWorkflowRunEvent) => GitHubDispatchResult;
+/**
+ * Opt-in legacy commit `status` webhook hook. No default dispatch. Turns are
+ * only started when the hook returns a dispatch *and* a PR can be resolved
+ * from the payload (otherwise use `{ task }` for host-side work).
+ */
+export type GitHubStatusHook = (ctx: GitHubEventContext, status: GitHubStatusEvent) => GitHubDispatchResult;
+/**
+ * Catch-all for any webhook event (including ones with typed hooks). Runs
+ * after the typed handler path when the typed hook is absent or returns
+ * undefined-as-no-handler; for events with no typed hook, this is the only
+ * dispatch path. Return `null` to ignore.
+ */
+export type GitHubEventHook = (ctx: GitHubEventContext, event: GitHubRawEvent) => GitHubDispatchResult;
+export type GitHubCloudOptionsResolver = (ctx: GitHubEventContext, pullRequest: GitHubPullRequestEvent) => AgentCloudOptions | undefined | Promise<AgentCloudOptions | undefined>;
+export interface GitHubChannelOptions {
+    /**
+     * Bot / App slug used by the default `@mention` gate on comments.
+     * Falls back to `GITHUB_APP_SLUG`.
+     */
+    botName?: string;
+    /**
+     * Webhook + API credentials. When the resolved webhook secret is set, the
+     * channel verifies `X-Hub-Signature-256` before parsing the payload.
+     * API calls prefer App installation tokens, then local PAT / `gh auth`.
+     */
+    credentials?: GitHubChannelCredentials;
+    /** Optional GitHub API transport overrides (`apiBaseUrl`, `fetch`). */
+    api?: GitHubApiOptions;
+    /**
+     * Route auth chain. Defaults to strict loopback auth without a webhook
+     * secret, and allow-all with one because the GitHub HMAC is the request
+     * auth.
+     */
+    auth?: AuthPolicy[];
+    /** Route path under `/v1/channels/<name>`. Defaults to `/`. */
+    path?: string;
+    /**
+     * Webhook events advertised to `agent-serve github forward` (published as
+     * `meta.githubWebhookEvents`). Defaults to the set derived from the declared
+     * hooks. Set this to pin an exact list — e.g. to include events only handled
+     * through {@link onEvent} such as `pull_request_review`.
+     */
+    webhookEvents?: readonly string[];
+    /**
+     * Decide whether an inbound `pull_request` event starts a turn. Return
+     * `{ auth: defaultGitHubAuth(ctx) }` to dispatch, `null` to ignore.
+     * Without this hook the channel dispatches on opened, reopened,
+     * synchronize, and ready_for_review (agent-serve default; Eve is opt-in).
+     */
+    onPullRequest?: GitHubPullRequestHook;
+    /**
+     * `@mention` gate for `issue_comment` and `pull_request_review_comment`.
+     * Without this hook, comments that `@mention` {@link botName} dispatch.
+     */
+    onComment?: GitHubCommentHook;
+    /** Opt-in `issues` webhook handler. No default dispatch. */
+    onIssue?: GitHubIssueHook;
+    /** Opt-in `check_suite` webhook handler. No default dispatch. */
+    onCheckSuite?: GitHubCheckSuiteHook;
+    /** Opt-in `check_run` webhook handler. No default dispatch. */
+    onCheckRun?: GitHubCheckRunHook;
+    /** Opt-in `workflow_run` webhook handler. No default dispatch. */
+    onWorkflowRun?: GitHubWorkflowRunHook;
+    /** Opt-in legacy commit `status` webhook handler. No default dispatch. */
+    onStatus?: GitHubStatusHook;
+    /**
+     * Catch-all webhook handler. Invoked for events without a typed hook, and
+     * as a fallback when a typed hook is not declared. Prefer typed hooks when
+     * the event is known.
+     */
+    onEvent?: GitHubEventHook;
+    /**
+     * Override / extend default stream-event handlers (eyes reaction, reply
+     * posting). Handlers you provide replace the matching defaults.
+     */
+    events?: ChannelEventHandlers<GitHubChannelState>;
+    /** Acknowledgement progress surfaces (reactions). */
+    progress?: GitHubProgressConfig;
+    /**
+     * When false, skip posting assistant / error comments back to GitHub.
+     * Defaults to true.
+     */
+    deliverReplies?: boolean;
+    /**
+     * Per-session cloud options. Pass `true` to attach the PR repo using the
+     * pull request URL, or a resolver for custom cloud options.
+     */
+    cloud?: boolean | AgentCloudOptions | GitHubCloudOptionsResolver;
+    /** Called once when the server mounts this channel. */
+    onStart?: (args: ChannelStartArgs) => void | Promise<void>;
+    /** Called when the server shuts down. */
+    onStop?: () => void | Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/channels/github/types.d.ts.map

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

package/dist/channels/github/types.js

@@ -0,0 +1 @@
+export {};

package/dist/channels/slack/api.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Slack Web API helpers used by the channel pack (`@slack/web-api`).
+ */
+import type { HostContext } from "../../types.js";
+import { type SlackLog } from "./log.js";
+import type { StreamTaskChunk } from "./stream.js";
+import type { SlackApiTransport, SlackBinding, SlackBotToken, SlackCredentials, SlackSuggestedPrompt, SoftSlackResult } from "./types.js";
+/** Whether a bot token slot holds an API transport instead of a token. */
+export declare function isSlackApiTransport(token: SlackBotToken | undefined): token is SlackApiTransport;
+export declare function resolveBotToken(credentials: SlackCredentials | undefined): Promise<string>;
+/** Resolve the Socket Mode app-level token (`xapp-…`). */
+export declare function resolveAppToken(credentials: SlackCredentials | undefined): Promise<string>;
+/** Channel-local continuation key: `<slackChannelId>:<threadTs>`. */
+export declare function slackContinuationKey(channelId: string, threadTs: string): string;
+/**
+ * Call a Slack Web API method. Platform errors (`ok: false`) are returned as
+ * the response body (not thrown) so callers can soft-fail cleanly. When the
+ * bot token slot holds a {@link SlackApiTransport} (e.g. the Cursor account
+ * proxy), the call is executed by the transport instead of `@slack/web-api`.
+ */
+export declare function callSlackApi(args: {
+    botToken: SlackBotToken | undefined;
+    operation: string;
+    body: Record<string, unknown>;
+}): Promise<Record<string, unknown>>;
+/**
+ * Soft-fail wrapper: never throws for Slack API errors. Network/throw
+ * errors become `{ ok: false, error }`. Unsupported feature errors set
+ * `unsupported: true`.
+ */
+export declare function callSlackApiSoft(args: {
+    botToken: SlackBotToken | undefined;
+    operation: string;
+    body: Record<string, unknown>;
+}): Promise<SoftSlackResult>;
+export declare function truncateTypingStatus(status: string, max?: number): string;
+export declare function truncateTitle(title: string, max?: number): string;
+export declare function setThreadStatus(args: {
+    botToken: SlackBotToken | undefined;
+    channelId: string;
+    threadTs: string;
+    status: string;
+    loadingMessages?: string[];
+}): Promise<SoftSlackResult>;
+export declare function setThreadTitle(args: {
+    botToken: SlackBotToken | undefined;
+    channelId: string;
+    threadTs: string;
+    title: string;
+}): Promise<SoftSlackResult>;
+export declare function setSuggestedPrompts(args: {
+    botToken: SlackBotToken | undefined;
+    channelId: string;
+    threadTs: string;
+    prompts: SlackSuggestedPrompt[];
+    title?: string;
+}): Promise<SoftSlackResult>;
+export declare function startChatStream(args: {
+    botToken: SlackBotToken | undefined;
+    channel: string;
+    thread_ts?: string;
+    markdown_text?: string;
+}): Promise<SoftSlackResult<{
+    ts: string;
+    channel: string;
+}>>;
+export declare function appendChatStream(args: {
+    botToken: SlackBotToken | undefined;
+    channel: string;
+    ts: string;
+    markdown_text?: string;
+    chunks?: StreamTaskChunk[];
+}): Promise<SoftSlackResult>;
+export declare function stopChatStream(args: {
+    botToken: SlackBotToken | undefined;
+    channel: string;
+    ts: string;
+    markdown_text?: string;
+    blocks?: unknown[];
+}): Promise<SoftSlackResult>;
+export declare function postMessage(args: {
+    botToken: SlackBotToken | undefined;
+    channel: string;
+    text: string;
+    threadTs?: string;
+    blocks?: unknown[];
+}): Promise<{
+    ts: string;
+}>;
+/** Replace an existing message (e.g. strip Approve/Deny after a decision). */
+export declare function updateMessage(args: {
+    botToken: SlackBotToken | undefined;
+    channel: string;
+    ts: string;
+    text: string;
+    blocks?: unknown[];
+}): Promise<SoftSlackResult>;
+/**
+ * Delete a message (`chat.delete`). Soft-fails — used best-effort to remove an
+ * orphaned skeleton before falling back to a fresh post, so a failed delete
+ * never blocks delivery of the reply.
+ */
+export declare function deleteMessage(args: {
+    botToken: SlackBotToken | undefined;
+    channel: string;
+    ts: string;
+}): Promise<SoftSlackResult>;
+export declare function buildSlackBinding(args: {
+    botToken: SlackBotToken | undefined;
+    channelId: string;
+    threadTs: string;
+    teamId?: string;
+    host: HostContext;
+    onThreadTsChanged?: (threadTs: string) => void;
+    log?: SlackLog;
+}): SlackBinding;
+//# sourceMappingURL=api.d.ts.map

package/dist/channels/slack/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AASlD,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EACV,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,0EAA0E;AAC1E,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,GAAG,SAAS,GAC/B,KAAK,IAAI,iBAAiB,CAM5B;AAED,wBAAsB,eAAe,CACnC,WAAW,EAAE,gBAAgB,GAAG,SAAS,GACxC,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED,0DAA0D;AAC1D,wBAAsB,eAAe,CACnC,WAAW,EAAE,gBAAgB,GAAG,SAAS,GACxC,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED,qEAAqE;AACrE,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAkBD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAcnC;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,GAAG,OAAO,CAAC,eAAe,CAAC,CAmB3B;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAOzE;AAWD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAOjE;AAMD,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B,GAAG,OAAO,CAAC,eAAe,CAAC,CAyB3B;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,eAAe,CAAC,CAU3B;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,eAAe,CAAC,CAiB3B;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,eAAe,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAyB5D;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B,GAAG,OAAO,CAAC,eAAe,CAAC,CAgB3B;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACpB,GAAG,OAAO,CAAC,eAAe,CAAC,CAgB3B;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACpB,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CA2D1B;AAED,8EAA8E;AAC9E,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACpB,GAAG,OAAO,CAAC,eAAe,CAAC,CA2C3B;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;CACZ,GAAG,OAAO,CAAC,eAAe,CAAC,CAY3B;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;IAClB,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,GAAG,CAAC,EAAE,QAAQ,CAAC;CAChB,GAAG,YAAY,CAsGf"}