@anionex/dsh-computer-use 0.1.0

package/lib/confirmations.js

@@ -0,0 +1,99 @@
+/** One-use just-in-time confirmation tokens for sensitive Computer Use actions. */
+import { createHash, randomUUID } from 'node:crypto';
+import { approvalPolicy } from "./approval-policy.js";
+import { ComputerUseError } from "./errors.js";
+import { ComputerConfirmationToken, } from "./types.js";
+function stable(value) {
+    if (value === null || typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return `[${value.map(stable).join(',')}]`;
+    const record = value;
+    return `{${Object.keys(record).sort().filter(key => record[key] !== undefined).map(key => `${JSON.stringify(key)}:${stable(record[key])}`).join(',')}}`;
+}
+function actionHash(action) {
+    const { confirmationToken: _token, ...rest } = action;
+    return createHash('sha256').update(stable(rest)).digest('hex');
+}
+/** Issues, validates, consumes, and releases scoped sensitive-action tokens. */
+export class ComputerConfirmationManager {
+    ctx;
+    config;
+    records = new Map();
+    constructor(ctx, config) {
+        this.ctx = ctx;
+        this.config = config;
+    }
+    /** Request user approval and mint one token bound to the exact action. */
+    async confirm(agent, app, request, callId, signal) {
+        if (approvalPolicy(this.ctx, agent) === 'never') {
+            throw new ComputerUseError('COMPUTER_CONFIRMATION_REQUIRED', 'sensitive action confirmation is blocked because approval prompts are disabled in this Session (approval/policy: never); do not execute the action, and ask the user to switch the permission preset to one with approval ask or run it manually');
+        }
+        const outcome = await this.ctx.approval.request({
+            agent,
+            toolName: 'computer_confirm',
+            ...(callId === undefined ? {} : { callId }),
+            reason: `${request.reason} Target: ${request.target}.${request.dataSummary === undefined ? '' : ` Data: ${request.dataSummary}.`}`,
+            signal,
+        });
+        if (outcome === 'cancelled')
+            throw new ComputerUseError('COMPUTER_CANCELLED', 'sensitive action confirmation was cancelled');
+        if (outcome !== 'allowed-once') {
+            throw new ComputerUseError('COMPUTER_CONFIRMATION_REQUIRED', `sensitive action was not confirmed (${outcome})`);
+        }
+        const token = ComputerConfirmationToken(randomUUID());
+        const expiresAt = Date.now() + this.config().confirmationTtlMs;
+        let agentRecords = this.records.get(agent);
+        if (agentRecords === undefined) {
+            agentRecords = new Map();
+            this.records.set(agent, agentRecords);
+        }
+        agentRecords.set(token, {
+            app,
+            observationId: request.action.observationId,
+            actionHash: actionHash(request.action),
+            expiresAt,
+        });
+        return { token, observationId: request.action.observationId, app, expiresAt: new Date(expiresAt).toISOString() };
+    }
+    /** Require and consume the one matching token when an action is marked sensitive. */
+    consume(agent, app, action) {
+        if (action.sensitive !== true) {
+            if (action.confirmationToken !== undefined) {
+                throw new ComputerUseError('COMPUTER_CONFIRMATION_REQUIRED', 'confirmationToken is valid only when sensitive is true');
+            }
+            return;
+        }
+        const token = action.confirmationToken;
+        if (token === undefined) {
+            throw new ComputerUseError('COMPUTER_CONFIRMATION_REQUIRED', 'sensitive action requires a token from computer_confirm');
+        }
+        const agentRecords = this.records.get(agent);
+        const record = agentRecords?.get(token);
+        if (record === undefined) {
+            throw new ComputerUseError('COMPUTER_CONFIRMATION_REQUIRED', 'confirmation token is unknown, expired, or already consumed');
+        }
+        agentRecords?.delete(token);
+        if (record.expiresAt < Date.now()) {
+            throw new ComputerUseError('COMPUTER_CONFIRMATION_REQUIRED', 'confirmation token expired');
+        }
+        if (record.app.bundleId !== app.bundleId || record.app.pid !== app.pid
+            || record.observationId !== action.observationId || record.actionHash !== actionHash(action)) {
+            throw new ComputerUseError('COMPUTER_CONFIRMATION_REQUIRED', 'confirmation token does not match this app, observation, or action');
+        }
+    }
+    /** Invalidate one pending token after target identity changes before input. */
+    invalidate(agent, token) {
+        if (token !== undefined)
+            this.records.get(agent)?.delete(token);
+    }
+    /** Release every pending token owned by one Agent. */
+    releaseAgent(agent) {
+        this.records.delete(agent);
+    }
+    /** Release all pending tokens on provider teardown or generation replacement. */
+    clear() {
+        this.records.clear();
+    }
+}
+//# sourceMappingURL=confirmations.js.map

package/lib/confirmations.js.map

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

package/lib/diff.js

@@ -0,0 +1,58 @@
+/** Accessibility-tree diff projection for model-context efficiency. */
+function identity(element) {
+    const frame = element.frame === undefined
+        ? ''
+        : `${Math.round(element.frame.x)},${Math.round(element.frame.y)},${Math.round(element.frame.width)},${Math.round(element.frame.height)}`;
+    return [element.role, element.subrole ?? '', element.title ?? '', element.label ?? '', frame].join('|');
+}
+function summary(element, includeIndex) {
+    const parts = [includeIndex ? `[${element.index}]` : undefined, element.role];
+    if (element.title !== undefined)
+        parts.push(JSON.stringify(element.title));
+    else if (element.label !== undefined)
+        parts.push(JSON.stringify(element.label));
+    if (element.value !== undefined)
+        parts.push(`value=${JSON.stringify(element.value)}`);
+    if (element.enabled === false)
+        parts.push('disabled');
+    if (element.focused === true)
+        parts.push('focused');
+    if (element.selected === true)
+        parts.push('selected');
+    return parts.filter((part) => part !== undefined).join(' ');
+}
+function state(element) {
+    return JSON.stringify({
+        value: element.value,
+        enabled: element.enabled,
+        focused: element.focused,
+        selected: element.selected,
+        actions: element.actions,
+    });
+}
+/** Return a bounded full-to-full element diff whose current rows use current indexes. */
+export function diffElements(previous, current, maxBytes) {
+    const before = new Map(previous.map(element => [identity(element), element]));
+    const after = new Map(current.map(element => [identity(element), element]));
+    const lines = [];
+    for (const [key, element] of before) {
+        if (!after.has(key))
+            lines.push(`- ${summary(element, false)}`);
+    }
+    for (const [key, element] of after) {
+        const old = before.get(key);
+        if (old === undefined)
+            lines.push(`+ ${summary(element, true)}`);
+        else if (state(old) !== state(element))
+            lines.push(`~ ${summary(element, true)}`);
+    }
+    if (lines.length === 0)
+        return '(no accessibility changes)';
+    const text = lines.join('\n');
+    const bytes = Buffer.byteLength(text);
+    if (bytes <= maxBytes)
+        return text;
+    const suffix = '\n… diff truncated';
+    return `${Buffer.from(text).subarray(0, Math.max(0, maxBytes - Buffer.byteLength(suffix))).toString('utf8')}${suffix}`;
+}
+//# sourceMappingURL=diff.js.map

package/lib/diff.js.map

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

package/lib/errors.js

@@ -0,0 +1,22 @@
+/** Error with a stable model-visible code and bounded public details. */
+export class ComputerUseError extends Error {
+    code;
+    /**
+     * @param code - Stable failure category.
+     * @param message - Bounded correction-oriented description without UI secrets.
+     * @param options - Optional original cause retained outside the model-facing message.
+     */
+    constructor(code, message, options) {
+        super(`${code}: ${message}`, options);
+        this.name = 'ComputerUseError';
+        this.code = code;
+    }
+}
+/** Convert an unknown failure into the provider-failure category without leaking unbounded native text. */
+export function computerUseError(error, fallback) {
+    if (error instanceof ComputerUseError)
+        return error;
+    const message = error instanceof Error ? error.message : String(error);
+    return new ComputerUseError('COMPUTER_PROVIDER_FAILURE', `${fallback}: ${message.slice(0, 1000)}`, { cause: error });
+}
+//# sourceMappingURL=errors.js.map

package/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAiBA,yEAAyE;AACzE,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,IAAI,CAAsB;IAEnC;;;;OAIG;IACH,YAAY,IAA0B,EAAE,OAAe,EAAE,OAAsB;QAC7E,KAAK,CAAC,GAAG,IAAI,KAAK,OAAO,EAAE,EAAE,OAAO,CAAC,CAAA;QACrC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAA;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AAED,2GAA2G;AAC3G,MAAM,UAAU,gBAAgB,CAAC,KAAc,EAAE,QAAgB;IAC/D,IAAI,KAAK,YAAY,gBAAgB;QAAE,OAAO,KAAK,CAAA;IACnD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACtE,OAAO,IAAI,gBAAgB,CAAC,2BAA2B,EAAE,GAAG,QAAQ,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;AACtH,CAAC"}

package/lib/exposure.js

@@ -0,0 +1,231 @@
+/** Agent-scoped progressive exposure for Computer Use execution Tools. */
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import { COMPUTER_USE_SKILL_CONTENT, COMPUTER_USE_SKILL_NAME } from "./skill.js";
+/** One global bootstrap retained until the current Agent loads the Skill. */
+export const COMPUTER_USE_ACTIVATE = 'computer_use_activate';
+const VISION_TOOL_NAMES = [
+    'vision_glance',
+    'vision_ground',
+    'vision_detect',
+    'vision_crop',
+    'vision_long_screenshot_ocr',
+    'vision_toolkit_activate',
+];
+const COMMAND_PREFIX = /^(?:(?:[A-Za-z_][A-Za-z0-9_]*=\S+)\s+)*(?:(?:\S*\/)?(?:sudo|env|nohup|time|command|exec)\s+(?:(?:-\S+|[A-Za-z_][A-Za-z0-9_]*=\S+)\s+)*)?/iu;
+const OCR_COMMAND_PROBE = /^(?:which|type|command\s+-v)\b[^\n;&|]*\b(?:tesseract|screencapture)\b/iu;
+const OCR_EXECUTABLE = /^(?:\S*\/)?(?:tesseract|screencapture)(?:\s|$)/iu;
+const OCR_STACK_SETUP = /^(?:(?:\S*\/)?(?:brew|port|apt(?:-get)?|dnf|yum|pacman)\b[^\n]*(?:install|add)\b[^\n]*\btesseract(?:-ocr)?\b|(?:\S*\/)?(?:pip(?:3(?:\.\d+)*)?|uv\s+pip|poetry\s+add|pdm\s+add)\b[^\n]*(?:install|add)?[^\n]*\b(?:pytesseract|easyocr|ocrmypdf)\b)/iu;
+const SCRIPTED_OCR_EXECUTABLE = /^(?:\S*\/)?(?:python(?:3(?:\.\d+)*)?|swift)(?:\s|$)/iu;
+const SCRIPTED_OCR_MARKER = /(?:\bpytesseract\b|\beasyocr\b|\bocrmypdf\b|VNRecognizeTextRequest|\bimport\s+Vision\b)/iu;
+const SHELL_META = /(?:&&|\|\||[;|\n])/u;
+function renderJson(_args, value) {
+    return [{ type: 'text', text: JSON.stringify(value, null, 2) }];
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function adHocOcrCommand(value) {
+    if (!isRecord(value) || typeof value.command !== 'string')
+        return false;
+    const commands = value.command.split(SHELL_META)
+        .map(command => command.trimStart().replace(COMMAND_PREFIX, ''));
+    if (commands.some(command => OCR_COMMAND_PROBE.test(command)
+        || OCR_EXECUTABLE.test(command)
+        || OCR_STACK_SETUP.test(command)))
+        return true;
+    return SCRIPTED_OCR_MARKER.test(value.command)
+        && commands.some(command => SCRIPTED_OCR_EXECUTABLE.test(command));
+}
+function isSkillArguments(value) {
+    return isRecord(value) && value.name === COMPUTER_USE_SKILL_NAME;
+}
+function nativeSkillCall(raw) {
+    try {
+        return isSkillArguments(JSON.parse(raw));
+    }
+    catch {
+        return false;
+    }
+}
+function containsSkillContent(blocks) {
+    return blocks.some(block => isRecord(block)
+        && block.type === 'text'
+        && typeof block.text === 'string'
+        && block.text.includes(COMPUTER_USE_SKILL_CONTENT));
+}
+function isSkillResult(value) {
+    return isRecord(value)
+        && value.name === COMPUTER_USE_SKILL_NAME
+        && value.content === COMPUTER_USE_SKILL_CONTENT;
+}
+/** Whether durable Session history proves that the bundled Skill was loaded. */
+export function hasLoadedComputerUseSkill(session) {
+    const nativeCalls = new Set();
+    for (const event of session.events) {
+        if (event.type === 'user/message') {
+            const source = event.data.source;
+            if (source.kind === 'skill-invocation'
+                && source.name === COMPUTER_USE_SKILL_NAME
+                && containsSkillContent(event.data.content))
+                return true;
+            continue;
+        }
+        if (event.type === 'tool/call') {
+            if (event.data.name === 'skill' && nativeSkillCall(event.data.arguments))
+                nativeCalls.add(String(event.data.callId));
+            continue;
+        }
+        if (event.type === 'tool/result') {
+            const [block] = event.data.message.content;
+            if (block?.type === 'tool-result'
+                && block.isError !== true
+                && nativeCalls.has(String(block.toolCallId))
+                && containsSkillContent(block.content))
+                return true;
+            continue;
+        }
+        if (event.type === 'tool/code-dispatch'
+            && event.data.name === 'skill'
+            && event.data.isError === false
+            && isSkillArguments(event.data.arguments)
+            && containsSkillContent(event.data.content))
+            return true;
+    }
+    return false;
+}
+/** Owns one progressive Tool-exposure generation. */
+export class ComputerUseExposure {
+    ctx;
+    createTools;
+    activationTool;
+    states = new Map();
+    installed = false;
+    constructor(ctx, createTools) {
+        this.ctx = ctx;
+        this.createTools = createTools;
+        this.activationTool = defineTool({
+            name: COMPUTER_USE_ACTIVATE,
+            description: `Activate the macOS Computer Use execution tools for this Agent after loading the ${COMPUTER_USE_SKILL_NAME} Skill. The Skill tool normally activates them automatically; call this only after a direct Skill invocation when the tools are still absent. This bootstrap disappears after success.`,
+            parameters: {},
+            output: {
+                schema: {
+                    type: 'object',
+                    additionalProperties: false,
+                    properties: {
+                        activated: { type: 'boolean', required: true },
+                        tools: { type: 'array', items: { type: 'string' }, required: true },
+                    },
+                },
+                render: renderJson,
+            },
+            execute: (_args, exec) => {
+                if (exec.agent === undefined)
+                    throw new Error(`${COMPUTER_USE_ACTIVATE}: an Agent Session is required`);
+                if (!hasLoadedComputerUseSkill(exec.agent.session)) {
+                    throw new Error(`${COMPUTER_USE_ACTIVATE}: load the ${COMPUTER_USE_SKILL_NAME} Skill first`);
+                }
+                return Promise.resolve(this.activate(exec.agent));
+            },
+            presentCall: () => ({ card: 'generic', title: 'Activate Computer Use', kind: 'execute' }),
+        });
+    }
+    /** Install lifecycle listeners and adopt existing Agents. */
+    install() {
+        if (this.installed)
+            throw new Error('dsh-computer-use: progressive exposure is already installed');
+        this.installed = true;
+        const effects = [
+            this.ctx.on('agent/created', ({ agent }) => { this.attach(agent); }),
+            this.ctx.on('agent/disposed', ({ agent }) => { this.detach(agent); }),
+            this.ctx.tools.guard((exec) => {
+                if (exec.name !== 'bash'
+                    || exec.agent === undefined
+                    || !hasLoadedComputerUseSkill(exec.agent.session)
+                    || !adHocOcrCommand(exec.arguments)
+                    || !VISION_TOOL_NAMES.some(name => this.ctx.tools.get(name, exec.agent) !== undefined))
+                    return undefined;
+                return 'Computer Use screenshot analysis must use the installed Vision Toolkit instead of a shell-built OCR stack. If vision_glance is absent, call the skill tool with {"name":"vision-tools"}; then pass the existing screenshot Artifact path to vision_glance, vision_ground, vision_detect, vision_crop, or vision_long_screenshot_ocr.';
+            }),
+            this.ctx.on('tools/result', (exec, result) => {
+                if (result.isError === false
+                    && exec.name === 'skill'
+                    && exec.agent !== undefined
+                    && isSkillArguments(exec.arguments)
+                    && isSkillResult(result.value))
+                    this.activate(exec.agent);
+                return undefined;
+            }),
+        ];
+        try {
+            for (const agent of this.ctx.agents.list())
+                this.attach(agent);
+        }
+        catch (error) {
+            for (const dispose of effects.reverse())
+                dispose();
+            this.disposeStates();
+            this.installed = false;
+            throw error;
+        }
+        return () => {
+            if (!this.installed)
+                return;
+            this.installed = false;
+            for (const dispose of effects.reverse())
+                dispose();
+            this.disposeStates();
+        };
+    }
+    attach(agent) {
+        if (this.states.has(agent))
+            return;
+        this.states.set(agent, { active: false, toolDisposers: [], toolNames: [] });
+        if (hasLoadedComputerUseSkill(agent.session))
+            this.activate(agent);
+    }
+    activate(agent) {
+        this.attach(agent);
+        const state = this.states.get(agent);
+        if (state === undefined)
+            throw new Error(`dsh-computer-use: Agent ${String(agent.id)} has no exposure state`);
+        if (state.active)
+            return { activated: false, tools: [...state.toolNames] };
+        const definitions = this.createTools();
+        const toolDisposers = [];
+        let hideActivation;
+        try {
+            for (const definition of definitions)
+                toolDisposers.push(agent.ctx.tools.register(definition));
+            hideActivation = agent.ctx.tools.restrict({ deny: [COMPUTER_USE_ACTIVATE] });
+        }
+        catch (error) {
+            hideActivation?.();
+            for (const dispose of toolDisposers.reverse())
+                dispose();
+            throw error;
+        }
+        state.active = true;
+        state.hideActivation = hideActivation;
+        state.toolDisposers = toolDisposers;
+        state.toolNames = definitions.map(definition => definition.name);
+        return { activated: true, tools: [...state.toolNames] };
+    }
+    detach(agent) {
+        const state = this.states.get(agent);
+        if (state === undefined)
+            return;
+        this.states.delete(agent);
+        this.disposeState(state);
+    }
+    disposeStates() {
+        for (const state of this.states.values())
+            this.disposeState(state);
+        this.states.clear();
+    }
+    disposeState(state) {
+        state.hideActivation?.();
+        for (const dispose of state.toolDisposers.reverse())
+            dispose();
+    }
+}
+//# sourceMappingURL=exposure.js.map

package/lib/exposure.js.map

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

package/lib/index.js

@@ -0,0 +1,56 @@
+/** DSH Computer Use model-facing consumer and progressive Skill bundle. */
+import { Service } from '@deepseek-ai/cordis';
+import { Config } from "./config.js";
+import { ComputerUseExposure } from "./exposure.js";
+import { MacOSComputerUseProvider } from "./providers/macos.js";
+import { COMPUTER_USE_SKILL } from "./skill.js";
+import { createComputerUseTools } from "./tools.js";
+import { installComputerUseWeb } from "./web.js";
+export { Config } from "./config.js";
+export * from "./errors.js";
+export * from "./service.js";
+export * from "./types.js";
+/** Register the portable Skill, bootstrap, Agent-scoped Tools, and optional Web diagnostics. */
+export function installComputerUseConsumer(ctx) {
+    const exposure = new ComputerUseExposure(ctx, () => createComputerUseTools(ctx.computerUse));
+    let activation;
+    let skill;
+    let exposureDispose;
+    try {
+        activation = ctx.tools.register(exposure.activationTool);
+        skill = ctx.skills.register(COMPUTER_USE_SKILL);
+        exposureDispose = exposure.install();
+        installComputerUseWeb(ctx);
+    }
+    catch (error) {
+        exposureDispose?.();
+        skill?.();
+        activation?.();
+        throw error;
+    }
+    return () => {
+        exposureDispose?.();
+        activation?.();
+        skill?.();
+    };
+}
+/** macOS provider plus the portable Skill, scoped Tools, and optional Web diagnostics. */
+export class ComputerUseBundle extends MacOSComputerUseProvider {
+    static inject = ['subprocess', 'approval', 'settings', 'sessions', 'agents', 'tools', 'skills'];
+    static Config = Config;
+    consumerDispose;
+    constructor(ctx, config = {}) {
+        super(ctx, config);
+        ctx.effect(() => () => {
+            this.consumerDispose?.();
+            this.consumerDispose = undefined;
+        }, 'dsh-computer-use: consumer lifecycle');
+    }
+    /** Publish model-facing capabilities only after provider integrity and health pass. */
+    async [Service.init]() {
+        await super[Service.init]();
+        this.consumerDispose = installComputerUseConsumer(this.ctx);
+    }
+}
+export default ComputerUseBundle;
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAE3E,OAAO,EAAE,OAAO,EAAgB,MAAM,qBAAqB,CAAA;AAK3D,OAAO,EAAE,MAAM,EAA0B,MAAM,aAAa,CAAA;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAEhD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAE1B,gGAAgG;AAChG,MAAM,UAAU,0BAA0B,CAAC,GAAY;IACrD,MAAM,QAAQ,GAAG,IAAI,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,sBAAsB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAA;IAC5F,IAAI,UAAoC,CAAA;IACxC,IAAI,KAA+B,CAAA;IACnC,IAAI,eAAyC,CAAA;IAC7C,IAAI,CAAC;QACH,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAA;QACxD,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAA;QAC/C,eAAe,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAA;QACpC,qBAAqB,CAAC,GAAG,CAAC,CAAA;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,eAAe,EAAE,EAAE,CAAA;QACnB,KAAK,EAAE,EAAE,CAAA;QACT,UAAU,EAAE,EAAE,CAAA;QACd,MAAM,KAAK,CAAA;IACb,CAAC;IACD,OAAO,GAAG,EAAE;QACV,eAAe,EAAE,EAAE,CAAA;QACnB,UAAU,EAAE,EAAE,CAAA;QACd,KAAK,EAAE,EAAE,CAAA;IACX,CAAC,CAAA;AACH,CAAC;AAED,0FAA0F;AAC1F,MAAM,OAAO,iBAAkB,SAAQ,wBAAwB;IAC7D,MAAM,CAAU,MAAM,GAAG,CAAC,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAA;IACxG,MAAM,CAAU,MAAM,GAAG,MAAM,CAAA;IAEvB,eAAe,CAA0B;IAEjD,YAAY,GAAY,EAAE,SAA4B,EAAE;QACtD,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QAClB,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE;YACpB,IAAI,CAAC,eAAe,EAAE,EAAE,CAAA;YACxB,IAAI,CAAC,eAAe,GAAG,SAAS,CAAA;QAClC,CAAC,EAAE,sCAAsC,CAAC,CAAA;IAC5C,CAAC;IAED,uFAAuF;IACpE,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QACrC,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAA;QAC3B,IAAI,CAAC,eAAe,GAAG,0BAA0B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC7D,CAAC;;AAGH,eAAe,iBAAiB,CAAA"}