@vibesdotdev/external 0.0.0-stage → 1.0.0-rc.0

package/dist/tools/unified/schemas.js

@@ -0,0 +1,139 @@
+/**
+ * External Unified Tool Schemas
+ *
+ * Open envelope for runtime-discovered external integration actions.
+ */
+import * as z from 'zod/v4';
+import { FileOperationSchema, LineRangeSchema } from "../../schemas/file-access.js";
+import { HookTargetSchema } from "../../schemas/hooks.js";
+import { hookLifecycleEventSchema } from "../../plugins/schemas/manifest.js";
+// Action Schemas
+/** Track a file access event */
+export const FileAccessTrackInputSchema = z.object({
+    action: z.literal('file-access-track'),
+    sessionId: z.uuid().optional(),
+    filePath: z.string().min(1).max(1024),
+    operation: FileOperationSchema,
+    lineRange: LineRangeSchema.optional(),
+    symbolsAccessed: z.array(z.string()).optional(),
+    bytesRead: z.number().int().nonnegative().optional(),
+    bytesWritten: z.number().int().nonnegative().optional(),
+    diagnosticsCount: z.number().int().nonnegative().optional(),
+    activeTodoId: z.uuid().optional(),
+    toolName: z.string().max(100).optional(),
+    toolCallId: z.string().max(100).optional(),
+    metadata: z.record(z.string(), z.unknown()).optional()
+});
+/** List file access history */
+export const FileAccessListInputSchema = z.object({
+    action: z.literal('file-access-list'),
+    sessionId: z.uuid().optional(),
+    operation: FileOperationSchema.optional(),
+    filePath: z.string().optional(),
+    since: z.iso.datetime().optional(),
+    limit: z.number().int().positive().default(50),
+    includeStats: z.boolean().default(true)
+});
+/** Generate context preservation summary */
+export const ContextSummaryInputSchema = z.object({
+    action: z.literal('context-summary'),
+    sessionId: z.uuid().optional(),
+    maxFiles: z.number().int().min(1).max(100).default(20),
+    includeCodeContext: z.boolean().default(false),
+    includeTodos: z.boolean().default(true),
+    includeScratchpad: z.boolean().default(true),
+    includeKnowledge: z.boolean().default(false),
+    timeWindowHours: z.number().int().min(1).max(168).default(24),
+    format: z.enum(['json', 'markdown', 'compact']).default('json'),
+    customInstructions: z.string().max(2000).optional()
+});
+/** Generate integration hooks */
+export const HookGeneratorInputSchema = z.object({
+    action: z.literal('hook-generator'),
+    target: HookTargetSchema,
+    hookType: hookLifecycleEventSchema.optional(),
+    vibesPath: z.string().default('vibes'),
+    outputDir: z.string().optional(),
+    writeFiles: z.boolean().default(false)
+});
+/** Install integration hooks */
+export const InstallInputSchema = z.object({
+    action: z.literal('install'),
+    target: HookTargetSchema,
+    projectDir: z.string().optional(),
+    global: z.boolean().default(false),
+    vibesPath: z.string().default('vibes'),
+    dryRun: z.boolean().default(false),
+    hooks: z
+        .array(hookLifecycleEventSchema)
+        .default(['context.beforeCompact', 'tool.after', 'session.start', 'session.end'])
+});
+/**
+ * Relay a native external-host lifecycle event into the persistent consumer
+ * runtime. The CLI host recognizes this one operation before general CLI
+ * bootstrap, so each event reuses the daemon instead of creating another Vibes
+ * body. Raw provider input is normalized by the registered owner adapter here.
+ */
+export const HookCallActionInputSchema = z.object({
+    action: z.literal('hook-call'),
+    event: z.string().min(1).max(100),
+    target: HookTargetSchema,
+    stdin: z
+        .string()
+        .max(8 * 1024 * 1024)
+        .optional(),
+    disableBrain: z.boolean().default(false),
+    disablePrompts: z.boolean().default(false),
+    output: z.enum(['text', 'json', 'native']).default('text'),
+    prompt: z.string().max(100_000).optional()
+});
+/**
+ * Send an ephemeral message to another agent.
+ *
+ * `to` is deliberately forgiving, because the caller usually knows the FILE,
+ * not the agent:
+ *   - `path:<filePath>`   whoever recently touched this file (the ambient one)
+ *   - `session:<id>`      a specific agent
+ *   - `workspace`         everyone in this workspace
+ */
+/**
+ * Optional sender session for stdio clients that have no ambient stamp yet.
+ * Zod discriminated unions strip undeclared keys — without this field the
+ * handler never saw sessionId and always threw "No active session".
+ */
+const optionalSessionId = z
+    .string()
+    .uuid()
+    .optional()
+    .describe('Sender session id when ambient binding is unavailable (stdio reconnect). Never overrides an ambient scope-bound session.');
+export const SignalSendInputSchema = z.object({
+    action: z.literal('signal-send'),
+    to: z.string().min(1).describe('path:<filePath> | session:<sessionId> | workspace'),
+    body: z
+        .string()
+        .min(1)
+        .max(500)
+        .describe("The message. Capped — it spends another agent's context."),
+    sessionId: optionalSessionId
+});
+/** Read messages addressed to this agent right now, without waiting for an edit. */
+export const SignalInboxInputSchema = z.object({
+    action: z.literal('signal-inbox'),
+    limit: z.number().int().positive().max(20).optional(),
+    sessionId: optionalSessionId
+});
+export const ExternalInputSchema = z
+    .object({
+    action: z.string().trim().min(1)
+})
+    .passthrough();
+// Output Schema
+/**
+ * Generic output schema for external operations.
+ * Each action handler returns its own specific structure, but all include a message.
+ */
+export const ExternalOutputSchema = z.object({
+    message: z.string().describe('Human-readable result message'),
+    data: z.unknown().optional().describe('Action-specific output data')
+});
+//# sourceMappingURL=schemas.js.map

package/dist/tools/unified/schemas.js.map

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

package/dist/utils/fs-absence.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Filesystem-probe failure classification.
+ *
+ * A probe ("does this path exist / can it be read") may only treat ABSENCE as
+ * an answer. Every other failure (permissions, IO, corruption) is a real
+ * error and must propagate to the caller. The errno is read through the
+ * runtime's value-free failure facts, never from the failure's text.
+ */
+import { type CaughtFailure } from '@vibesdotdev/kernel';
+/** The POSIX errno a caught filesystem failure carries, if any. */
+export declare function errnoOf(failure: CaughtFailure): string | undefined;
+/** True when the failure means "the path (or a parent directory) is not there". */
+export declare function isAbsentPath(failure: CaughtFailure): boolean;
+/** True when a probe failed because the path is absent or not accessible to this user. */
+export declare function isUnreachablePath(failure: CaughtFailure): boolean;
+/** {@link isAbsentPath} for a raw catch binding. */
+export declare function isAbsentPathError(error: unknown): boolean;
+/** {@link isUnreachablePath} for a raw catch binding. */
+export declare function isUnreachablePathError(error: unknown): boolean;
+/** {@link errnoOf} for a raw catch binding. */
+export declare function errnoCode(error: unknown): string | undefined;
+//# sourceMappingURL=fs-absence.d.ts.map

package/dist/utils/fs-absence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-absence.d.ts","sourceRoot":"","sources":["../../src/utils/fs-absence.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAyC,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEhG,mEAAmE;AACnE,wBAAgB,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAElE;AAED,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAG5D;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAEjE;AAKD,oDAAoD;AACpD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEzD;AAED,yDAAyD;AACzD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE9D;AAED,+CAA+C;AAC/C,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAE5D"}

package/dist/utils/fs-absence.js

@@ -0,0 +1,37 @@
+/**
+ * Filesystem-probe failure classification.
+ *
+ * A probe ("does this path exist / can it be read") may only treat ABSENCE as
+ * an answer. Every other failure (permissions, IO, corruption) is a real
+ * error and must propagate to the caller. The errno is read through the
+ * runtime's value-free failure facts, never from the failure's text.
+ */
+import { CaughtFailureSchema, valueFreeFailure } from '@vibesdotdev/kernel';
+/** The POSIX errno a caught filesystem failure carries, if any. */
+export function errnoOf(failure) {
+    return valueFreeFailure(failure).code;
+}
+/** True when the failure means "the path (or a parent directory) is not there". */
+export function isAbsentPath(failure) {
+    const code = errnoOf(failure);
+    return code === 'ENOENT' || code === 'ENOTDIR';
+}
+/** True when a probe failed because the path is absent or not accessible to this user. */
+export function isUnreachablePath(failure) {
+    return isAbsentPath(failure) || errnoOf(failure) === 'EACCES';
+}
+// Raw-binding forms, kept only until launch/consumer/store.ts (frozen under the providers
+// review) parses its catch binding; deleted once its last caller switches.
+/** {@link isAbsentPath} for a raw catch binding. */
+export function isAbsentPathError(error) {
+    return isAbsentPath(CaughtFailureSchema.parse(error));
+}
+/** {@link isUnreachablePath} for a raw catch binding. */
+export function isUnreachablePathError(error) {
+    return isUnreachablePath(CaughtFailureSchema.parse(error));
+}
+/** {@link errnoOf} for a raw catch binding. */
+export function errnoCode(error) {
+    return errnoOf(CaughtFailureSchema.parse(error));
+}
+//# sourceMappingURL=fs-absence.js.map

package/dist/utils/fs-absence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-absence.js","sourceRoot":"","sources":["../../src/utils/fs-absence.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAsB,MAAM,qBAAqB,CAAC;AAEhG,mEAAmE;AACnE,MAAM,UAAU,OAAO,CAAC,OAAsB;IAC7C,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;AACvC,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,YAAY,CAAC,OAAsB;IAClD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,CAAC;AAChD,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,iBAAiB,CAAC,OAAsB;IACvD,OAAO,YAAY,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;AAC/D,CAAC;AAED,0FAA0F;AAC1F,2EAA2E;AAE3E,oDAAoD;AACpD,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC/C,OAAO,YAAY,CAAC,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACpD,OAAO,iBAAiB,CAAC,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,SAAS,CAAC,KAAc;IACvC,OAAO,OAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AAClD,CAAC"}

package/dist/utils/runtime-fs.d.ts

@@ -0,0 +1,37 @@
+/**
+ * File access for External through the handed runtime's `filesystem/adapter`.
+ *
+ * External never imports a host filesystem: every read, write and listing
+ * goes through the adapter the runtime selects. The helpers here answer the
+ * absence questions External asks (an optional config, a hooks directory)
+ * and pass every other failure through unchanged.
+ */
+import { type FileSystemAdapterInterface, type FileSystemStatCheckedResult } from '@vibesdotdev/filesystem';
+import { CapabilityError, type RuntimeRef, type CaughtFailure } from '@vibesdotdev/kernel';
+export type ExternalFileSystem = FileSystemAdapterInterface;
+/**
+ * The handed runtime's unbound host filesystem. External reads and writes host
+ * resources (a harness's `~/.codex/config.toml`, `~/.claude/hooks`) that sit
+ * outside any bound workspace, so it asks for the unbound adapter
+ * (`binding: false`) rather than the workspace-rooted one.
+ */
+export declare function externalFileSystem(runtime: RuntimeRef): Promise<ExternalFileSystem>;
+type ExternalPathStatRefusal = Pick<CapabilityError, 'code' | 'reason' | 'message'>;
+/** Shared host-error policy; the catching caller keeps the cause in its own typed refusal. */
+export declare function externalPathStatRefusal(cause: CaughtFailure): ExternalPathStatRefusal;
+/** Inspect an External path: only confirmed absence is absent; host failures stay typed and value-free. */
+export declare function statExternalPathChecked(fs: ExternalFileSystem, path: string): Promise<FileSystemStatCheckedResult>;
+/** The UTF-8 text at `path`, or `null` when nothing is there; any other failure propagates. */
+export declare function readTextIfPresent(fs: ExternalFileSystem, path: string): Promise<string | null>;
+/** Entry names in the directory at `path`, or `[]` when it is absent; any other failure propagates. */
+export declare function listNamesIfPresent(fs: ExternalFileSystem, path: string): Promise<string[]>;
+/**
+ * Set a file's permission bits through the runtime execution kind: `chmod`
+ * located on PATH and run as an argv array (no shell). The filesystem
+ * capability has no mode setter yet. A win32 host has no POSIX mode bits, so
+ * this is a no-op there. A missing `chmod` or a non-zero exit is refused
+ * `UNAVAILABLE` `file-mode-unset`, never ignored.
+ */
+export declare function setFileMode(runtime: RuntimeRef, path: string, mode: number): Promise<void>;
+export {};
+//# sourceMappingURL=runtime-fs.d.ts.map

package/dist/utils/runtime-fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-fs.d.ts","sourceRoot":"","sources":["../../src/utils/runtime-fs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAe,KAAK,0BAA0B,EAAE,KAAK,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACzH,OAAO,EAAE,eAAe,EAA4D,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKrJ,MAAM,MAAM,kBAAkB,GAAG,0BAA0B,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAEnF;AAED,KAAK,uBAAuB,GAAG,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAC;AAEpF,8FAA8F;AAC9F,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,aAAa,GAAG,uBAAuB,CAkBrF;AAED,2GAA2G;AAC3G,wBAAsB,uBAAuB,CAAC,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC,CASxH;AAED,+FAA+F;AAC/F,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQpG;AAED,uGAAuG;AACvG,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOhG;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhG"}

package/dist/utils/runtime-fs.js

@@ -0,0 +1,100 @@
+/**
+ * File access for External through the handed runtime's `filesystem/adapter`.
+ *
+ * External never imports a host filesystem: every read, write and listing
+ * goes through the adapter the runtime selects. The helpers here answer the
+ * absence questions External asks (an optional config, a hooks directory)
+ * and pass every other failure through unchanged.
+ */
+import { resolveFileSystemAdapter } from '@vibesdotdev/filesystem/client';
+import { statChecked } from '@vibesdotdev/filesystem';
+import { CapabilityError, CaughtFailureSchema, isCapabilityError, valueFreeFailure } from '@vibesdotdev/kernel';
+import { runCapture } from '@vibesdotdev/kernel/execution';
+import { resolveExternalCommand } from "../detection/command-probe.js";
+import { hostPlatformKey } from "../external-tool/path-template.js";
+/**
+ * The handed runtime's unbound host filesystem. External reads and writes host
+ * resources (a harness's `~/.codex/config.toml`, `~/.claude/hooks`) that sit
+ * outside any bound workspace, so it asks for the unbound adapter
+ * (`binding: false`) rather than the workspace-rooted one.
+ */
+export function externalFileSystem(runtime) {
+    return resolveFileSystemAdapter(runtime, { binding: false });
+}
+/** Shared host-error policy; the catching caller keeps the cause in its own typed refusal. */
+export function externalPathStatRefusal(cause) {
+    const failure = valueFreeFailure(cause);
+    if (failure.code === 'ELOOP') {
+        return {
+            message: 'The external path has too many symbolic links to resolve.',
+            code: 'INVALID_INPUT', reason: 'external-path-symlink-loop'
+        };
+    }
+    if (failure.code === 'EACCES' || failure.code === 'EPERM') {
+        return {
+            message: 'Access to the external path was denied.',
+            code: 'PERMISSION_DENIED', reason: 'external-path-permission-denied'
+        };
+    }
+    return {
+        message: 'The external path could not be inspected.',
+        code: 'INTERNAL', reason: 'external-path-stat-failed'
+    };
+}
+/** Inspect an External path: only confirmed absence is absent; host failures stay typed and value-free. */
+export async function statExternalPathChecked(fs, path) {
+    try {
+        return await statChecked(fs, path);
+    }
+    catch (error) {
+        const caught = CaughtFailureSchema.parse(error);
+        if (isCapabilityError(caught))
+            throw caught;
+        const refusal = externalPathStatRefusal(caught);
+        throw new CapabilityError(refusal.message, refusal.code, { reason: refusal.reason, cause: caught });
+    }
+}
+/** The UTF-8 text at `path`, or `null` when nothing is there; any other failure propagates. */
+export async function readTextIfPresent(fs, path) {
+    try {
+        const content = await fs.readFile(path, 'utf-8');
+        return content instanceof Uint8Array ? new TextDecoder().decode(content) : content;
+    }
+    catch (error) {
+        if (valueFreeFailure(CaughtFailureSchema.parse(error)).code === 'ENOENT')
+            return null;
+        throw error;
+    }
+}
+/** Entry names in the directory at `path`, or `[]` when it is absent; any other failure propagates. */
+export async function listNamesIfPresent(fs, path) {
+    try {
+        return (await fs.list(path)).map((entry) => entry.name);
+    }
+    catch (error) {
+        if (valueFreeFailure(CaughtFailureSchema.parse(error)).code === 'ENOENT')
+            return [];
+        throw error;
+    }
+}
+/**
+ * Set a file's permission bits through the runtime execution kind: `chmod`
+ * located on PATH and run as an argv array (no shell). The filesystem
+ * capability has no mode setter yet. A win32 host has no POSIX mode bits, so
+ * this is a no-op there. A missing `chmod` or a non-zero exit is refused
+ * `UNAVAILABLE` `file-mode-unset`, never ignored.
+ */
+export async function setFileMode(runtime, path, mode) {
+    if (hostPlatformKey(runtime) === 'win32')
+        return;
+    const chmod = await resolveExternalCommand(runtime, 'chmod');
+    const result = chmod ? await runCapture(runtime, chmod, [mode.toString(8), path], { envMode: 'replace' }) : undefined;
+    if (result?.exitCode === 0)
+        return;
+    throw new CapabilityError('A written file could not be given its permission bits.', 'UNAVAILABLE', {
+        reason: 'file-mode-unset',
+        retryable: false,
+        details: { path, mode: mode.toString(8), ...(result ? { exitCode: result.exitCode } : { chmod: 'not-on-path' }) }
+    });
+}
+//# sourceMappingURL=runtime-fs.js.map

package/dist/utils/runtime-fs.js.map

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

package/dist/utils/toml.d.ts

@@ -0,0 +1,26 @@
+/**
+ * TOML reader for host config files (Codex, Grok) and installer/recipe edits.
+ *
+ * Reads the TOML 1.0 forms host configs use: tables and arrays of tables,
+ * dotted and quoted keys, basic/literal strings (single- and multi-line),
+ * integers (decimal, hex, octal, binary, `_` separators), floats (incl.
+ * `inf`/`nan`), booleans, date-times (kept as their source text), arrays
+ * spanning lines with comments and trailing commas, and inline tables.
+ *
+ * A document that is not valid TOML is refused `INVALID_INPUT` `toml-invalid`
+ * with the 1-based line in `details.line`; the refusal never carries the
+ * document's text, so a config holding a credential cannot leak through it.
+ * Keys are defined as own data properties, so `__proto__`, `constructor` or
+ * `prototype` in a document are ordinary keys and never reach a prototype.
+ */
+/** A TOML value as read. Date-times are their source text. */
+export type TomlValue = string | number | boolean | TomlValue[] | TomlTable;
+/** A TOML table: string keys to TOML values. */
+export interface TomlTable {
+    [key: string]: TomlValue;
+}
+/** Whether `value` is a TOML table (not an array). */
+export declare function isTomlTable(value: TomlValue | undefined): value is TomlTable;
+/** Read a TOML document, or refuse it `INVALID_INPUT` `toml-invalid` (value-free, with `details.line`). */
+export declare function parseTomlDocument(content: string): TomlTable;
+//# sourceMappingURL=toml.d.ts.map

package/dist/utils/toml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toml.d.ts","sourceRoot":"","sources":["../../src/utils/toml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,8DAA8D;AAC9D,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,EAAE,GAAG,SAAS,CAAC;AAE5E,gDAAgD;AAChD,MAAM,WAAW,SAAS;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CACzB;AAcD,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,KAAK,IAAI,SAAS,CAE5E;AA+VD,2GAA2G;AAC3G,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAE5D"}