pulseed 0.4.4 → 0.4.6

package/dist/tools/network/GitHubCliTool/GitHubCliTool.d.ts

@@ -0,0 +1,144 @@
+import { z } from "zod";
+import type { ITool, PermissionCheckResult, ToolCallContext, ToolMetadata, ToolResult } from "../../types.js";
+export declare const GitHubReadInputSchema: z.ZodObject<{
+    action: z.ZodEnum<["repo_view", "pr_view", "pr_checks", "pr_diff", "pr_comments", "run_list", "run_view", "run_logs", "issue_view"]>;
+    repo: z.ZodOptional<z.ZodString>;
+    pr: z.ZodOptional<z.ZodNumber>;
+    issue: z.ZodOptional<z.ZodNumber>;
+    run_id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    patch: z.ZodDefault<z.ZodBoolean>;
+    maxChars: z.ZodDefault<z.ZodNumber>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    action: "repo_view" | "pr_view" | "pr_checks" | "pr_diff" | "pr_comments" | "run_list" | "run_view" | "run_logs" | "issue_view";
+    timeoutMs: number;
+    patch: boolean;
+    limit: number;
+    maxChars: number;
+    repo?: string | undefined;
+    run_id?: string | number | undefined;
+    issue?: number | undefined;
+    pr?: number | undefined;
+}, {
+    action: "repo_view" | "pr_view" | "pr_checks" | "pr_diff" | "pr_comments" | "run_list" | "run_view" | "run_logs" | "issue_view";
+    repo?: string | undefined;
+    timeoutMs?: number | undefined;
+    patch?: boolean | undefined;
+    run_id?: string | number | undefined;
+    limit?: number | undefined;
+    issue?: number | undefined;
+    pr?: number | undefined;
+    maxChars?: number | undefined;
+}>;
+export type GitHubReadInput = z.infer<typeof GitHubReadInputSchema>;
+export declare const GitHubPrCreateInputSchema: z.ZodObject<{
+    repo: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
+    body: z.ZodDefault<z.ZodString>;
+    base: z.ZodOptional<z.ZodString>;
+    head: z.ZodOptional<z.ZodString>;
+    draft: z.ZodDefault<z.ZodBoolean>;
+    fill: z.ZodDefault<z.ZodBoolean>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    fill: boolean;
+    title: string;
+    timeoutMs: number;
+    body: string;
+    draft: boolean;
+    repo?: string | undefined;
+    head?: string | undefined;
+    base?: string | undefined;
+}, {
+    title: string;
+    fill?: boolean | undefined;
+    repo?: string | undefined;
+    timeoutMs?: number | undefined;
+    body?: string | undefined;
+    draft?: boolean | undefined;
+    head?: string | undefined;
+    base?: string | undefined;
+}>;
+export type GitHubPrCreateInput = z.infer<typeof GitHubPrCreateInputSchema>;
+export interface GitHubCliOutput {
+    command: string;
+    args: string[];
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+}
+export declare class GitHubReadTool implements ITool<GitHubReadInput, GitHubCliOutput> {
+    readonly metadata: ToolMetadata;
+    readonly inputSchema: z.ZodObject<{
+        action: z.ZodEnum<["repo_view", "pr_view", "pr_checks", "pr_diff", "pr_comments", "run_list", "run_view", "run_logs", "issue_view"]>;
+        repo: z.ZodOptional<z.ZodString>;
+        pr: z.ZodOptional<z.ZodNumber>;
+        issue: z.ZodOptional<z.ZodNumber>;
+        run_id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        limit: z.ZodDefault<z.ZodNumber>;
+        patch: z.ZodDefault<z.ZodBoolean>;
+        maxChars: z.ZodDefault<z.ZodNumber>;
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        action: "repo_view" | "pr_view" | "pr_checks" | "pr_diff" | "pr_comments" | "run_list" | "run_view" | "run_logs" | "issue_view";
+        timeoutMs: number;
+        patch: boolean;
+        limit: number;
+        maxChars: number;
+        repo?: string | undefined;
+        run_id?: string | number | undefined;
+        issue?: number | undefined;
+        pr?: number | undefined;
+    }, {
+        action: "repo_view" | "pr_view" | "pr_checks" | "pr_diff" | "pr_comments" | "run_list" | "run_view" | "run_logs" | "issue_view";
+        repo?: string | undefined;
+        timeoutMs?: number | undefined;
+        patch?: boolean | undefined;
+        run_id?: string | number | undefined;
+        limit?: number | undefined;
+        issue?: number | undefined;
+        pr?: number | undefined;
+        maxChars?: number | undefined;
+    }>;
+    description(): string;
+    call(input: GitHubReadInput, context: ToolCallContext): Promise<ToolResult>;
+    checkPermissions(input: GitHubReadInput): Promise<PermissionCheckResult>;
+    isConcurrencySafe(_input: GitHubReadInput): boolean;
+}
+export declare class GitHubPrCreateTool implements ITool<GitHubPrCreateInput, GitHubCliOutput> {
+    readonly metadata: ToolMetadata;
+    readonly inputSchema: z.ZodObject<{
+        repo: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        body: z.ZodDefault<z.ZodString>;
+        base: z.ZodOptional<z.ZodString>;
+        head: z.ZodOptional<z.ZodString>;
+        draft: z.ZodDefault<z.ZodBoolean>;
+        fill: z.ZodDefault<z.ZodBoolean>;
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        fill: boolean;
+        title: string;
+        timeoutMs: number;
+        body: string;
+        draft: boolean;
+        repo?: string | undefined;
+        head?: string | undefined;
+        base?: string | undefined;
+    }, {
+        title: string;
+        fill?: boolean | undefined;
+        repo?: string | undefined;
+        timeoutMs?: number | undefined;
+        body?: string | undefined;
+        draft?: boolean | undefined;
+        head?: string | undefined;
+        base?: string | undefined;
+    }>;
+    description(): string;
+    call(input: GitHubPrCreateInput, context: ToolCallContext): Promise<ToolResult>;
+    checkPermissions(input: GitHubPrCreateInput): Promise<PermissionCheckResult>;
+    isConcurrencySafe(_input: GitHubPrCreateInput): boolean;
+}
+//# sourceMappingURL=GitHubCliTool.d.ts.map

package/dist/tools/network/GitHubCliTool/GitHubCliTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubCliTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/network/GitHubCliTool/GitHubCliTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAM9G,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;EASpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,qBAAa,cAAe,YAAW,KAAK,CAAC,eAAe,EAAE,eAAe,CAAC;IAC5E,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAW7B;IAEF,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAAyB;IAE7C,WAAW,IAAI,MAAM;IAIf,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAgC3E,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAQ9E,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO;CAGpD;AAED,qBAAa,kBAAmB,YAAW,KAAK,CAAC,mBAAmB,EAAE,eAAe,CAAC;IACpF,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAW7B;IAEF,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;OAA6B;IAEjD,WAAW,IAAI,MAAM;IAIf,IAAI,CAAC,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IA2B/E,gBAAgB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAOlF,iBAAiB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO;CAGxD"}

package/dist/tools/network/GitHubCliTool/GitHubCliTool.js

@@ -0,0 +1,245 @@
+import { z } from "zod";
+import { execFileNoThrow } from "../../../base/utils/execFileNoThrow.js";
+const MAX_OUTPUT_CHARS = 20_000;
+const SAFE_REPO_RE = /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/;
+export const GitHubReadInputSchema = z.object({
+    action: z.enum([
+        "repo_view",
+        "pr_view",
+        "pr_checks",
+        "pr_diff",
+        "pr_comments",
+        "run_list",
+        "run_view",
+        "run_logs",
+        "issue_view",
+    ]),
+    repo: z.string().regex(SAFE_REPO_RE, "repo must be owner/name").optional(),
+    pr: z.number().int().positive().optional(),
+    issue: z.number().int().positive().optional(),
+    run_id: z.union([z.string().min(1), z.number().int().positive()]).optional(),
+    limit: z.number().int().min(1).max(100).default(20),
+    patch: z.boolean().default(true),
+    maxChars: z.number().int().min(100).max(100_000).default(MAX_OUTPUT_CHARS),
+    timeoutMs: z.number().int().min(1_000).max(120_000).default(30_000),
+});
+export const GitHubPrCreateInputSchema = z.object({
+    repo: z.string().regex(SAFE_REPO_RE, "repo must be owner/name").optional(),
+    title: z.string().min(1).max(300),
+    body: z.string().max(20_000).default(""),
+    base: z.string().min(1).max(200).optional(),
+    head: z.string().min(1).max(200).optional(),
+    draft: z.boolean().default(true),
+    fill: z.boolean().default(false),
+    timeoutMs: z.number().int().min(1_000).max(120_000).default(30_000),
+});
+export class GitHubReadTool {
+    metadata = {
+        name: "github_read",
+        aliases: ["gh_read", "github_pr_read", "github_ci_read"],
+        permissionLevel: "read_only",
+        isReadOnly: true,
+        isDestructive: false,
+        shouldDefer: true,
+        alwaysLoad: false,
+        maxConcurrency: 3,
+        maxOutputChars: MAX_OUTPUT_CHARS,
+        tags: ["github", "pr", "ci", "network", "agentloop"],
+    };
+    inputSchema = GitHubReadInputSchema;
+    description() {
+        return "Read GitHub repository, PR, issue, and Actions status through the gh CLI. Requires gh to be installed and authenticated.";
+    }
+    async call(input, context) {
+        const startTime = Date.now();
+        const validationError = validateGitHubReadInput(input);
+        if (validationError) {
+            return failure(validationError, startTime);
+        }
+        const args = buildGitHubReadArgs(input);
+        const result = await execFileNoThrow("gh", args, { cwd: context.cwd, timeoutMs: input.timeoutMs });
+        const stdout = truncate(result.stdout, input.maxChars);
+        const stderr = truncate(result.stderr, input.maxChars);
+        const data = {
+            command: "gh",
+            args,
+            stdout,
+            stderr,
+            exitCode: result.exitCode,
+        };
+        const succeeded = result.exitCode === 0;
+        return {
+            success: succeeded,
+            data,
+            summary: succeeded
+                ? `gh ${args.slice(0, 3).join(" ")} succeeded${stdout ? `: ${stdout.slice(0, 200)}` : ""}`
+                : `gh ${args.slice(0, 3).join(" ")} failed: ${stderr.slice(0, 300)}`,
+            error: succeeded ? undefined : stderr.slice(0, 500),
+            durationMs: Date.now() - startTime,
+            artifacts: input.repo ? [`github:${input.repo}`] : undefined,
+        };
+    }
+    async checkPermissions(input) {
+        const validationError = validateGitHubReadInput(input);
+        if (validationError) {
+            return { status: "denied", reason: validationError };
+        }
+        return { status: "allowed" };
+    }
+    isConcurrencySafe(_input) {
+        return true;
+    }
+}
+export class GitHubPrCreateTool {
+    metadata = {
+        name: "github_pr_create",
+        aliases: ["gh_pr_create", "create_github_pr"],
+        permissionLevel: "write_remote",
+        isReadOnly: false,
+        isDestructive: false,
+        shouldDefer: true,
+        alwaysLoad: false,
+        maxConcurrency: 1,
+        maxOutputChars: MAX_OUTPUT_CHARS,
+        tags: ["github", "pr", "network", "agentloop"],
+    };
+    inputSchema = GitHubPrCreateInputSchema;
+    description() {
+        return "Create a GitHub pull request through the gh CLI. Defaults to draft PRs.";
+    }
+    async call(input, context) {
+        const startTime = Date.now();
+        const args = buildGitHubPrCreateArgs(input);
+        const result = await execFileNoThrow("gh", args, { cwd: context.cwd, timeoutMs: input.timeoutMs });
+        const stdout = truncate(result.stdout, MAX_OUTPUT_CHARS);
+        const stderr = truncate(result.stderr, MAX_OUTPUT_CHARS);
+        const data = {
+            command: "gh",
+            args,
+            stdout,
+            stderr,
+            exitCode: result.exitCode,
+        };
+        const succeeded = result.exitCode === 0;
+        return {
+            success: succeeded,
+            data,
+            summary: succeeded
+                ? `GitHub PR created${stdout ? `: ${stdout.slice(0, 200)}` : ""}`
+                : `GitHub PR creation failed: ${stderr.slice(0, 300)}`,
+            error: succeeded ? undefined : stderr.slice(0, 500),
+            durationMs: Date.now() - startTime,
+            artifacts: input.repo ? [`github:${input.repo}`] : undefined,
+        };
+    }
+    async checkPermissions(input) {
+        if (input.fill && input.body.trim().length > 0) {
+            return { status: "denied", reason: "Use either fill=true or an explicit body, not both." };
+        }
+        return { status: "needs_approval", reason: "Creating a GitHub pull request changes remote repository state." };
+    }
+    isConcurrencySafe(_input) {
+        return false;
+    }
+}
+function validateGitHubReadInput(input) {
+    if ((input.action === "run_view" || input.action === "run_logs") && input.run_id === undefined) {
+        return `${input.action} requires run_id`;
+    }
+    if (input.action === "issue_view" && input.issue === undefined) {
+        return "issue_view requires issue";
+    }
+    return null;
+}
+function buildGitHubReadArgs(input) {
+    switch (input.action) {
+        case "repo_view": {
+            const args = ["repo", "view"];
+            if (input.repo)
+                args.push(input.repo);
+            args.push("--json", "nameWithOwner,description,url,defaultBranchRef,isPrivate,viewerPermission");
+            return args;
+        }
+        case "pr_view": {
+            return withRepo([
+                "pr", "view", ...optionalNumber(input.pr),
+                "--json", "number,title,state,author,headRefName,baseRefName,url,isDraft,mergeStateStatus,reviewDecision,statusCheckRollup",
+            ], input.repo);
+        }
+        case "pr_checks": {
+            return withRepo(["pr", "checks", ...optionalNumber(input.pr)], input.repo);
+        }
+        case "pr_diff": {
+            return withRepo(["pr", "diff", ...optionalNumber(input.pr), ...(input.patch ? ["--patch"] : [])], input.repo);
+        }
+        case "pr_comments": {
+            return withRepo([
+                "pr", "view", ...optionalNumber(input.pr),
+                "--comments",
+                "--json", "number,title,url,comments,reviews",
+            ], input.repo);
+        }
+        case "run_list": {
+            return withRepo([
+                "run", "list",
+                "--limit", String(input.limit),
+                "--json", "databaseId,displayTitle,status,conclusion,workflowName,headBranch,event,createdAt,url",
+            ], input.repo);
+        }
+        case "run_view": {
+            return withRepo([
+                "run", "view", String(input.run_id),
+                "--json", "databaseId,displayTitle,status,conclusion,workflowName,headBranch,headSha,event,createdAt,updatedAt,url",
+            ], input.repo);
+        }
+        case "run_logs": {
+            return withRepo(["run", "view", String(input.run_id), "--log-failed"], input.repo);
+        }
+        case "issue_view": {
+            return withRepo([
+                "issue", "view", String(input.issue),
+                "--comments",
+                "--json", "number,title,state,author,body,comments,url",
+            ], input.repo);
+        }
+    }
+}
+function buildGitHubPrCreateArgs(input) {
+    const args = ["pr", "create", "--title", input.title];
+    if (input.fill) {
+        args.push("--fill");
+    }
+    else {
+        args.push("--body", input.body);
+    }
+    if (input.base)
+        args.push("--base", input.base);
+    if (input.head)
+        args.push("--head", input.head);
+    if (input.draft)
+        args.push("--draft");
+    return withRepo(args, input.repo);
+}
+function optionalNumber(value) {
+    return value === undefined ? [] : [String(value)];
+}
+function withRepo(args, repo) {
+    if (!repo)
+        return args;
+    return [...args, "--repo", repo];
+}
+function truncate(value, maxChars) {
+    if (value.length <= maxChars)
+        return value;
+    return `${value.slice(0, maxChars)}\n[truncated ${value.length - maxChars} chars]`;
+}
+function failure(message, startTime) {
+    return {
+        success: false,
+        data: null,
+        summary: message,
+        error: message,
+        durationMs: Date.now() - startTime,
+    };
+}
+//# sourceMappingURL=GitHubCliTool.js.map

package/dist/tools/network/GitHubCliTool/GitHubCliTool.js.map

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

package/dist/tools/network/HttpFetchTool/HttpFetchTool.d.ts

@@ -26,7 +26,22 @@ export interface HttpFetchOutput {
     body: string;
     ok: boolean;
 }
+export interface ValidatedDestination {
+    address: string;
+    family: 4 | 6;
+}
+export interface HttpFetchTransportRequest {
+    url: URL;
+    method: "GET" | "HEAD";
+    headers?: Record<string, string>;
+    timeoutMs: number;
+    maxResponseBytes: number;
+    destination: ValidatedDestination;
+}
+export type HttpFetchTransport = (request: HttpFetchTransportRequest) => Promise<HttpFetchOutput>;
+export declare function defaultHttpFetchTransport(request: HttpFetchTransportRequest): Promise<HttpFetchOutput>;
 export declare class HttpFetchTool implements ITool<HttpFetchInput, HttpFetchOutput> {
+    private readonly transport;
     readonly metadata: ToolMetadata;
     readonly inputSchema: z.ZodObject<{
         url: z.ZodString;
@@ -47,6 +62,7 @@ export declare class HttpFetchTool implements ITool<HttpFetchInput, HttpFetchOut
         timeoutMs?: number | undefined;
         maxResponseBytes?: number | undefined;
     }>;
+    constructor(transport?: HttpFetchTransport);
     description(): string;
     call(input: HttpFetchInput, _context: ToolCallContext): Promise<ToolResult>;
     checkPermissions(input: HttpFetchInput): Promise<PermissionCheckResult>;

package/dist/tools/network/HttpFetchTool/HttpFetchTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HttpFetchTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/network/HttpFetchTool/HttpFetchTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI9G,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;EAM/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,WAAW,eAAe;IAAG,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAC;CAAE;AAEpH,qBAAa,aAAc,YAAW,KAAK,CAAC,cAAc,EAAE,eAAe,CAAC;IAC1E,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAK7B;IACF,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;OAAwB;IAE5C,WAAW,IAAI,MAAM;IAIf,IAAI,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAyB3E,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAO7E,iBAAiB,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO;CACpD"}
+{"version":3,"file":"HttpFetchTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/network/HttpFetchTool/HttpFetchTool.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI9G,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;EAM/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,WAAW,eAAe;IAAG,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAC;CAAE;AAIpH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,oBAAoB,CAAC;CACnC;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,yBAAyB,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;AAyIlG,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,eAAe,CAAC,CA2DtG;AAED,qBAAa,aAAc,YAAW,KAAK,CAAC,cAAc,EAAE,eAAe,CAAC;IAS9D,OAAO,CAAC,QAAQ,CAAC,SAAS;IARtC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAK7B;IACF,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;OAAwB;gBAEf,SAAS,GAAE,kBAA8C;IAEtF,WAAW,IAAI,MAAM;IAIf,IAAI,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAyC3E,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAU7E,iBAAiB,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO;CACpD"}