@ai-setting/roy-plugin-task-show 0.1.0

package/dist/plugin.d.ts

@@ -0,0 +1,107 @@
+/**
+ * @fileoverview TaskShowPlugin — the roy-agent plugin entry point.
+ *
+ * Lifecycle (mirrors `ReminderPlugin` / `TaskTagPlugin`):
+ *   1. Constructor accepts a config (defaults merged in).
+ *   2. `init(env)` registers hooks on the global hook manager:
+ *        - `tool:after.execute`           → record each tool call
+ *        - `task:after.update`            → freeze session + emit URL
+ *   3. `dispose()` stops the HTTP service & releases listeners.
+ *
+ * The plugin is intentionally lean: all the heavy lifting lives in
+ * `collector.ts`, `server.ts`, and `url-injector.ts`. That keeps this file
+ * readable and makes the surface area easy to test.
+ */
+import type { PluginEnvLike, TaskShowConfig } from "./types.js";
+import { ToolCallCollector } from "./collector.js";
+/**
+ * Public, friendly type used in README + tests.
+ *
+ * It deliberately matches `BasePlugin` from `@ai-setting/roy-agent-core`
+ * (init/dispose/hooks-style), so this plugin can be loaded both by the
+ * official loader and by hand-rolled test harnesses.
+ */
+export interface TaskShowPluginInterface {
+    readonly name: string;
+    readonly version: string;
+    readonly description: string;
+    init(env: PluginEnvLike): void | Promise<void>;
+    dispose(): void | Promise<void>;
+    /** accessor for tests / health checks */
+    getServerPort(): number | null;
+    /** accessor for tests / health checks */
+    getCollector(): ToolCallCollector;
+    /** accessor for tests that want to bypass the hook manager entirely */
+    getConfig(): TaskShowConfig;
+}
+/**
+ * Main plugin class. Decorated with the static `roy-agent` metadata block
+ * via a side-table so we don't have to import the host's BasePlugin.
+ */
+export declare class TaskShowPlugin implements TaskShowPluginInterface {
+    readonly name = "roy-plugin-task-show";
+    readonly version = "0.1.0";
+    readonly description = "Visually trace a task's tool-call chain on a local HTTP service and inject the URL into the last tool result.";
+    private readonly cfg;
+    private readonly collector;
+    private readonly server;
+    private env;
+    private disposed;
+    /** Last successful `tool:after.execute` result, used to inject the URL on task completion. */
+    private lastResultByTask;
+    /** cached list of hook points we registered, so dispose() can be defensive even if the env lacks unregister. */
+    private registered;
+    constructor(config?: Partial<TaskShowConfig>);
+    /**
+     * Called by the loader (or by tests) with the host's `PluginEnv`. We use
+     * the host's `registerHook` if available, otherwise fall back to the
+     * global hook manager from `@ai-setting/roy-agent-core`.
+     */
+    init(env: PluginEnvLike): Promise<void>;
+    /**
+     * Best-effort dispose. We tolerate the absence of `dispose` on the env.
+     */
+    dispose(): Promise<void>;
+    getServerPort(): number | null;
+    getCollector(): ToolCallCollector;
+    getConfig(): TaskShowConfig;
+    /**
+     * Public function exposed so unit tests can simulate the
+     * `tool:after.execute` payload without going through the global hook
+     * manager.
+     */
+    onToolAfterExecute(ctx: any, metadata?: Record<string, unknown>): Promise<void>;
+    /**
+     * Public function exposed for tests; mirrors the `task:after.update`
+     * payload.
+     */
+    onTaskAfterUpdate(ctx: any): Promise<void>;
+    /**
+     * Manual injection hook — useful when a custom caller has a known task
+     * id + ToolResult at hand (e.g. tests).
+     */
+    injectFor(taskId: number, result: any): boolean;
+    /**
+     * Compute the URL the page would be served at. Helpful in tests where
+     * `init()` was skipped.
+     */
+    getVisualizationUrl(taskId: number): string;
+    /**
+     * Subscribe to the hook points we care about. We try to use the env's
+     * `registerHook` first (the modern, type-safe plugin API), then fall back
+     * to the global hook manager if available.
+     */
+    private registerHooks;
+    private registerViaGlobalManager;
+}
+/**
+ * Convenience factory — used when loaded as a bare ES module (the typical
+ * loader pattern in `coder-harness` / `task-tag`).
+ */
+export declare function createTaskShowPlugin(config?: Partial<TaskShowConfig>): TaskShowPlugin;
+/**
+ * Default export. The loader imports `default` or `TaskShowPlugin` from this
+ * module — both routes are wired here.
+ */
+export default TaskShowPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EAEf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAgCnD;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,IAAI,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,OAAO,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,yCAAyC;IACzC,aAAa,IAAI,MAAM,GAAG,IAAI,CAAC;IAC/B,yCAAyC;IACzC,YAAY,IAAI,iBAAiB,CAAC;IAClC,uEAAuE;IACvE,SAAS,IAAI,cAAc,CAAC;CAC7B;AAED;;;GAGG;AACH,qBAAa,cAAe,YAAW,uBAAuB;IAC5D,QAAQ,CAAC,IAAI,0BAA0B;IACvC,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,WAAW,mHAC8F;IAElH,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAiB;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,GAAG,CAA8B;IACzC,OAAO,CAAC,QAAQ,CAAS;IACzB,8FAA8F;IAC9F,OAAO,CAAC,gBAAgB,CAA0B;IAClD,gHAAgH;IAChH,OAAO,CAAC,UAAU,CAAyC;gBAE/C,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAgB5C;;;;OAIG;IACG,IAAI,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB7C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B,aAAa,IAAI,MAAM,GAAG,IAAI;IAK9B,YAAY,IAAI,iBAAiB;IAIjC,SAAS,IAAI,cAAc;IAQ3B;;;;OAIG;IACG,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCrF;;;OAGG;IACG,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IA2ChD;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO;IAU/C;;;OAGG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAQ3C;;;;OAIG;IACH,OAAO,CAAC,aAAa;YA2BP,wBAAwB;CA+BvC;AA+BD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAErF;AAED;;;GAGG;AACH,eAAe,cAAc,CAAC"}

package/dist/plugin.js

@@ -0,0 +1,332 @@
+/**
+ * @fileoverview TaskShowPlugin — the roy-agent plugin entry point.
+ *
+ * Lifecycle (mirrors `ReminderPlugin` / `TaskTagPlugin`):
+ *   1. Constructor accepts a config (defaults merged in).
+ *   2. `init(env)` registers hooks on the global hook manager:
+ *        - `tool:after.execute`           → record each tool call
+ *        - `task:after.update`            → freeze session + emit URL
+ *   3. `dispose()` stops the HTTP service & releases listeners.
+ *
+ * The plugin is intentionally lean: all the heavy lifting lives in
+ * `collector.ts`, `server.ts`, and `url-injector.ts`. That keeps this file
+ * readable and makes the surface area easy to test.
+ */
+import { DEFAULT_CONFIG } from "./types.js";
+import { ToolCallCollector } from "./collector.js";
+import { TaskShowServer } from "./server.js";
+import { buildVisualizationUrl, injectVisualizationUrl, } from "./url-injector.js";
+// ============================================================================
+// Logger
+// ============================================================================
+const TAG = "roy-plugin-task-show";
+function info(msg) {
+    if (process.env?.TASK_SHOW_DEBUG) {
+        // eslint-disable-next-line no-console
+        console.log(`[${TAG}] ${msg}`);
+    }
+}
+function warn(msg) {
+    // eslint-disable-next-line no-console
+    console.warn(`[${TAG}] ${msg}`);
+}
+function error(msg) {
+    // eslint-disable-next-line no-console
+    console.error(`[${TAG}] ${msg}`);
+}
+/**
+ * Main plugin class. Decorated with the static `roy-agent` metadata block
+ * via a side-table so we don't have to import the host's BasePlugin.
+ */
+export class TaskShowPlugin {
+    name = "roy-plugin-task-show";
+    version = "0.1.0";
+    description = "Visually trace a task's tool-call chain on a local HTTP service and inject the URL into the last tool result.";
+    cfg;
+    collector;
+    server;
+    env = null;
+    disposed = false;
+    /** Last successful `tool:after.execute` result, used to inject the URL on task completion. */
+    lastResultByTask = new Map();
+    /** cached list of hook points we registered, so dispose() can be defensive even if the env lacks unregister. */
+    registered = [];
+    constructor(config) {
+        this.cfg = { ...DEFAULT_CONFIG, ...(config ?? {}) };
+        this.collector = new ToolCallCollector(this.cfg, {
+            onChange: () => info("collector snapshot changed"),
+        });
+        this.server = new TaskShowServer({
+            cfg: this.cfg,
+            collector: this.collector,
+            publicDir: this.cfg.publicDir,
+            // Pass metaUrl best-effort — we want to resolve `public/` relative to
+            // the dist directory in production.
+            metaUrl: typeof import.meta !== "undefined" ? import.meta.url : undefined,
+            logger: { info, warn, error },
+        });
+    }
+    /**
+     * Called by the loader (or by tests) with the host's `PluginEnv`. We use
+     * the host's `registerHook` if available, otherwise fall back to the
+     * global hook manager from `@ai-setting/roy-agent-core`.
+     */
+    async init(env) {
+        if (this.disposed)
+            throw new Error(`${this.name} already disposed`);
+        if (this.env)
+            throw new Error(`${this.name} already initialized`);
+        this.env = env;
+        // Start the HTTP service first so we can compute per-task URLs as soon
+        // as hooks fire.
+        if (this.cfg.autoStart) {
+            try {
+                const serverInfo = await this.server.start();
+                info(`plugin ready at ${serverInfo.url}`);
+            }
+            catch (err) {
+                error(`failed to start HTTP server: ${err}`);
+                throw err;
+            }
+        }
+        this.registerHooks(env);
+        info(`registered ${this.registered.length} hooks`);
+    }
+    /**
+     * Best-effort dispose. We tolerate the absence of `dispose` on the env.
+     */
+    async dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        try {
+            await this.server.stop();
+        }
+        catch (err) {
+            warn(`server.stop failed: ${err}`);
+        }
+        this.collector.clear();
+        this.lastResultByTask.clear();
+        this.env = null;
+        this.registered = [];
+    }
+    getServerPort() {
+        const info = this.server.getInfo();
+        return info?.port ?? null;
+    }
+    getCollector() {
+        return this.collector;
+    }
+    getConfig() {
+        return { ...this.cfg };
+    }
+    // ---------------------------------------------------------------------
+    // Hook handlers (exposed for tests)
+    // ---------------------------------------------------------------------
+    /**
+     * Public function exposed so unit tests can simulate the
+     * `tool:after.execute` payload without going through the global hook
+     * manager.
+     */
+    async onToolAfterExecute(ctx, metadata) {
+        if (this.disposed)
+            return;
+        if (!ctx)
+            return;
+        const tool = ctx.tool ?? ctx.toolDef ?? null;
+        const args = ctx.args ?? ctx.arguments ?? {};
+        const result = ctx.result ?? ctx.toolResult ?? null;
+        const toolName = tool?.name ?? ctx.toolName ?? "unknown";
+        const success = !result?.error && (result?.success ?? true);
+        const error = result?.error;
+        const startTs = metadata?.start_ts ?? ctx.start_ts ?? Date.now();
+        const durationMs = typeof ctx.durationMs === "number"
+            ? ctx.durationMs
+            : Math.max(0, Date.now() - Number(startTs));
+        const outputPreview = previewOutput(result?.output ?? "");
+        const taskId = this.collector.recordToolCall({
+            toolName,
+            args,
+            success,
+            outputPreview,
+            error: typeof error === "string" ? error : undefined,
+            durationMs,
+            timestamp: Date.now(),
+            iteration: ctx.iteration,
+            metadata: result?.metadata,
+            ctx,
+        });
+        // Stash the result so we can inject the URL on completion.
+        if (result && typeof result === "object") {
+            this.lastResultByTask.set(taskId, result);
+        }
+    }
+    /**
+     * Public function exposed for tests; mirrors the `task:after.update`
+     * payload.
+     */
+    async onTaskAfterUpdate(ctx) {
+        if (this.disposed)
+            return;
+        if (!ctx)
+            return;
+        // The hook payload may be either the host's `TaskUpdateContext` OR a
+        // duck-typed object. We try several shapes.
+        const data = (ctx.data ?? ctx);
+        const taskId = data?.task?.id ?? data?.taskId ?? data?.id;
+        const status = data?.task?.status ??
+            data?.status ??
+            "completed";
+        const title = data?.task?.title ?? data?.title;
+        if (typeof taskId !== "number")
+            return;
+        // Always finalize the session so the index page reflects the new state.
+        const finalized = this.collector.finalizeOnTaskUpdate({
+            taskId,
+            newStatus: status,
+            title,
+            timestamp: Date.now(),
+        });
+        if (!finalized)
+            return;
+        // Inject the URL ONLY when the task is terminal (not "running").
+        if (!isTerminalStatus(status))
+            return;
+        const lastResult = this.lastResultByTask.get(taskId);
+        if (!lastResult) {
+            // Some tasks may complete without any tool call (e.g. pure response).
+            info(`task ${taskId} completed without any recorded tool call — skipping URL injection`);
+            return;
+        }
+        const outcome = injectVisualizationUrl({
+            ctx: { result: lastResult },
+            cfg: this.cfg,
+            taskId,
+        });
+        if (outcome.mutated) {
+            info(`injected visualization URL ${outcome.url} into last tool result for task ${taskId}`);
+        }
+    }
+    /**
+     * Manual injection hook — useful when a custom caller has a known task
+     * id + ToolResult at hand (e.g. tests).
+     */
+    injectFor(taskId, result) {
+        if (!result || typeof result.output !== "string")
+            return false;
+        const out = injectVisualizationUrl({
+            ctx: { result },
+            cfg: this.cfg,
+            taskId,
+        });
+        return out.mutated;
+    }
+    /**
+     * Compute the URL the page would be served at. Helpful in tests where
+     * `init()` was skipped.
+     */
+    getVisualizationUrl(taskId) {
+        return buildVisualizationUrl(this.cfg, taskId);
+    }
+    // ---------------------------------------------------------------------
+    // Internals
+    // ---------------------------------------------------------------------
+    /**
+     * Subscribe to the hook points we care about. We try to use the env's
+     * `registerHook` first (the modern, type-safe plugin API), then fall back
+     * to the global hook manager if available.
+     */
+    registerHooks(env) {
+        if (typeof env.registerHook === "function") {
+            env.registerHook({
+                point: "tool:after.execute",
+                priority: 50,
+                name: `${this.name}:tool-after`,
+                handler: async (ctx) => this.onToolAfterExecute(ctx),
+            });
+            this.registered.push({ point: "tool:after.execute", name: `${this.name}:tool-after` });
+            env.registerHook({
+                point: "task:after.update",
+                priority: 60,
+                name: `${this.name}:task-after`,
+                handler: async (ctx) => this.onTaskAfterUpdate(ctx),
+            });
+            this.registered.push({ point: "task:after.update", name: `${this.name}:task-after` });
+            return;
+        }
+        // Fallback: directly import the global hook manager. We import dynamically
+        // so this code works even if `@ai-setting/roy-agent-core` is not yet linked.
+        void this.registerViaGlobalManager().catch((err) => {
+            warn(`global hook manager registration failed: ${err}`);
+        });
+    }
+    async registerViaGlobalManager() {
+        let mgr;
+        try {
+            mgr = await import("@ai-setting/roy-agent-core");
+        }
+        catch {
+            // The plugin can still operate in pure-test mode where no global hook
+            // manager exists. We log and bail.
+            warn("@ai-setting/roy-agent-core not found — hook manager registration skipped");
+            return;
+        }
+        const globalHookManager = mgr.globalHookManager;
+        if (!globalHookManager) {
+            warn("@ai-setting/roy-agent-core does not export globalHookManager — skipping");
+            return;
+        }
+        globalHookManager.register("tool:after.execute", {
+            name: `${this.name}:tool-after`,
+            priority: 50,
+            execute: async (ctx) => this.onToolAfterExecute(ctx),
+        });
+        this.registered.push({ point: "tool:after.execute", name: `${this.name}:tool-after` });
+        globalHookManager.register("task:after.update", {
+            name: `${this.name}:task-after`,
+            priority: 60,
+            execute: async (ctx) => this.onTaskAfterUpdate(ctx),
+        });
+        this.registered.push({ point: "task:after.update", name: `${this.name}:task-after` });
+    }
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+const TERMINAL_STATUSES = new Set([
+    "completed",
+    "failed",
+    "cancelled",
+]);
+function isTerminalStatus(status) {
+    return TERMINAL_STATUSES.has(status);
+}
+/**
+ * Truncate an output string to a useful preview length. We keep the tail
+ * because errors and "TRUNCATED ..." notes are more informative than the
+ * beginning of a huge blob.
+ */
+function previewOutput(output) {
+    if (typeof output !== "string")
+        return "";
+    const MAX = 512;
+    if (output.length <= MAX)
+        return output;
+    // Keep both ends for context.
+    const head = output.slice(0, MAX / 2);
+    const tail = output.slice(-MAX / 2);
+    return `${head}\n…[truncated ${output.length - MAX} chars]…\n${tail}`;
+}
+/**
+ * Convenience factory — used when loaded as a bare ES module (the typical
+ * loader pattern in `coder-harness` / `task-tag`).
+ */
+export function createTaskShowPlugin(config) {
+    return new TaskShowPlugin(config);
+}
+/**
+ * Default export. The loader imports `default` or `TaskShowPlugin` from this
+ * module — both routes are wired here.
+ */
+export default TaskShowPlugin;
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @fileoverview Tiny standalone HTTP server for the visualization frontend.
+ *
+ * We deliberately avoid Express/Fastify to keep the dependency tree of this
+ * plugin at zero. Routes:
+ *   GET /                       → index of recent task sessions
+ *   GET /task/:taskId           → detail page (mermaid flow + tables)
+ *   GET /api/sessions           → JSON list of sessions
+ *   GET /api/sessions/:taskId   → JSON detail of one session
+ *   GET /static/*               → static frontend assets (CSS/JS)
+ *
+ * The server is started/stopped via `TaskShowServer.start()` /
+ * `.stop()`. Multiple instances cooperate by random port fallback — if the
+ * configured port is busy we let the OS pick a free one and log the actual
+ * port.
+ */
+import * as http from "node:http";
+import type { TaskShowConfig } from "./types.js";
+import type { ToolCallCollector } from "./collector.js";
+/** Public-facing server info (returned to whoever called `start`). */
+export interface ServerInfo {
+    host: string;
+    port: number;
+    url: string;
+    server: http.Server;
+    /** True if the original port was busy and we had to pick a free one. */
+    portRewritten: boolean;
+}
+export declare class TaskShowServer {
+    private server;
+    private readonly cfg;
+    private readonly collector;
+    private readonly publicRoot;
+    private readonly logger;
+    constructor(opts: {
+        cfg: TaskShowConfig;
+        collector: ToolCallCollector;
+        /** Absolute or relative path to the directory with public/index.html. */
+        publicDir?: string;
+        logger?: {
+            info: (m: string) => void;
+            warn: (m: string) => void;
+            error: (m: string) => void;
+        };
+        metaUrl?: string;
+    });
+    /**
+     * Start the listener. The promise resolves once the server is bound — but
+     * the caller can race against `getInfo()` immediately afterwards.
+     */
+    start(): Promise<ServerInfo>;
+    /**
+     * Read-only accessor used by the plugin entry point to compute the per-task
+     * URL after the server has been bound.
+     */
+    getInfo(): {
+        host: string;
+        port: number;
+        url: string;
+    } | null;
+    /**
+     * Stop the listener; safe to call multiple times.
+     */
+    stop(): Promise<void>;
+    private handle;
+    /**
+     * Render the index page (lists known tasks).
+     */
+    private sendIndex;
+    /**
+     * Send a 404 page that still includes nav + helpful hint.
+     */
+    private sendNotFound;
+    private serveStatic;
+    private json;
+    private text;
+    private sendHtml;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,KAAK,EAEV,cAAc,EACf,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAMxD,sEAAsE;AACtE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;IACpB,wEAAwE;IACxE,aAAa,EAAE,OAAO,CAAC;CACxB;AAcD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAiB;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuF;gBAElG,IAAI,EAAE;QAChB,GAAG,EAAE,cAAc,CAAC;QACpB,SAAS,EAAE,iBAAiB,CAAC;QAC7B,yEAAyE;QACzE,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE;YAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;YAAC,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;YAAC,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;SAAE,CAAC;QAC9F,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;IAOD;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;IA0D5B;;;OAGG;IACH,OAAO,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAW7D;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAyBP,MAAM;IAuEpB;;OAEG;IACH,OAAO,CAAC,SAAS;IAKjB;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,WAAW;IAuBnB,OAAO,CAAC,IAAI;IAQZ,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,QAAQ;CAMjB"}