@sudocode-ai/local-server 0.1.0

package/dist/execution/output/types.d.ts

@@ -0,0 +1,421 @@
+/**
+ * Output Processing Layer Types
+ *
+ * Core types for the Output Processing Layer (Layer 5) that handles
+ * real-time parsing and processing of coding agent output.
+ *
+ * Currently optimized for Claude Code's stream-json format, but designed
+ * with extension points for future multi-agent support (Aider, Gemini, Codex, etc.)
+ *
+ * @module execution/output/types
+ */
+/**
+ * MessageType - Types of messages in agent output
+ *
+ * These types represent common semantic operations across coding agents.
+ * Agent-specific adapters map their output to these standard types.
+ */
+export type MessageType = "text" | "tool_use" | "tool_result" | "usage" | "error" | "unknown";
+/**
+ * FileOperation - Type of file operation performed
+ *
+ * Extended to support operations from various agents:
+ * - read: File read operations
+ * - write: File write (create or overwrite)
+ * - edit: In-place file edits (e.g., Aider's inline edits)
+ * - delete: File deletion
+ * - create: Explicit file creation (vs overwrite)
+ */
+export type FileOperation = "read" | "write" | "edit" | "delete" | "create";
+/**
+ * ToolCallStatus - Status of a tool invocation
+ */
+export type ToolCallStatus = "pending" | "success" | "error";
+/**
+ * OutputMessage - Discriminated union for all message types
+ *
+ * Represents a parsed message from agent output.
+ * Uses a discriminated union pattern for type-safe message handling.
+ *
+ * The `metadata` field on each variant provides an extension point for
+ * agent-specific data without breaking the core type structure.
+ */
+export type OutputMessage = {
+    type: "text";
+    content: string;
+    timestamp: Date;
+    /** Agent-specific metadata (e.g., formatting, styling) */
+    metadata?: Record<string, any>;
+} | {
+    type: "tool_use";
+    id: string;
+    name: string;
+    input: Record<string, any>;
+    timestamp: Date;
+    /** Agent-specific metadata (e.g., execution context, permissions) */
+    metadata?: Record<string, any>;
+} | {
+    type: "tool_result";
+    toolUseId: string;
+    result: any;
+    isError: boolean;
+    timestamp: Date;
+    /** Agent-specific metadata (e.g., exit codes, duration) */
+    metadata?: Record<string, any>;
+} | {
+    type: "usage";
+    tokens: {
+        input: number;
+        output: number;
+        cache: number;
+    };
+    timestamp: Date;
+    /** Agent-specific metadata (e.g., model name, pricing tier) */
+    metadata?: Record<string, any>;
+} | {
+    type: "error";
+    message: string;
+    details?: any;
+    timestamp: Date;
+    /** Agent-specific metadata (e.g., error codes, stack traces) */
+    metadata?: Record<string, any>;
+} | {
+    type: "unknown";
+    raw: string;
+    timestamp: Date;
+    /** Agent-specific metadata (e.g., original format, parsing hints) */
+    metadata?: Record<string, any>;
+};
+/**
+ * FileChange - Track file modifications during execution
+ */
+export interface FileChange {
+    /**
+     * Path to the file that was changed
+     */
+    path: string;
+    /**
+     * Type of operation performed on the file
+     */
+    operation: FileOperation;
+    /**
+     * When the change occurred
+     */
+    timestamp: Date;
+    /**
+     * Tool call ID that caused this change (optional)
+     */
+    toolCallId?: string;
+    /**
+     * Additional change details (e.g., line numbers, diffs)
+     * Useful for agents that provide inline diff information
+     */
+    changes?: {
+        linesAdded?: number;
+        linesDeleted?: number;
+        diff?: string;
+    };
+    /**
+     * Agent-specific metadata (e.g., Git integration, review status)
+     */
+    metadata?: Record<string, any>;
+}
+/**
+ * ToolCall - Represents a tool invocation and its result
+ */
+export interface ToolCall {
+    /**
+     * Unique identifier for this tool call
+     */
+    id: string;
+    /**
+     * Name of the tool (e.g., 'Bash', 'Read', 'Write', 'Edit')
+     */
+    name: string;
+    /**
+     * Input parameters passed to the tool
+     */
+    input: Record<string, any>;
+    /**
+     * Current status of the tool call
+     */
+    status: ToolCallStatus;
+    /**
+     * Result from the tool execution (if completed)
+     */
+    result?: any;
+    /**
+     * Error message (if status is 'error')
+     */
+    error?: string;
+    /**
+     * When the tool was invoked
+     */
+    timestamp: Date;
+    /**
+     * When the tool completed (if finished)
+     */
+    completedAt?: Date;
+}
+/**
+ * UsageMetrics - Token usage and cost tracking
+ */
+export interface UsageMetrics {
+    /**
+     * Input tokens consumed
+     */
+    inputTokens: number;
+    /**
+     * Output tokens generated
+     */
+    outputTokens: number;
+    /**
+     * Cache tokens used (optional, for agents that support caching)
+     */
+    cacheTokens: number;
+    /**
+     * Total tokens (input + output)
+     */
+    totalTokens: number;
+    /**
+     * Estimated cost in USD (if available)
+     */
+    cost?: number;
+    /**
+     * Provider/model information for multi-agent scenarios
+     */
+    provider?: string;
+    model?: string;
+}
+/**
+ * ProcessingMetrics - Aggregate statistics from output processing
+ */
+export interface ProcessingMetrics {
+    /**
+     * Total number of messages processed
+     */
+    totalMessages: number;
+    /**
+     * All tool calls tracked during execution
+     */
+    toolCalls: ToolCall[];
+    /**
+     * All file changes detected during execution
+     */
+    fileChanges: FileChange[];
+    /**
+     * Token usage and cost metrics
+     */
+    usage: UsageMetrics;
+    /**
+     * Errors encountered during execution
+     */
+    errors: Array<{
+        message: string;
+        timestamp: Date;
+        details?: any;
+    }>;
+    /**
+     * When processing started
+     */
+    startedAt: Date;
+    /**
+     * When processing last updated
+     */
+    lastUpdate: Date;
+    /**
+     * When processing ended (if finished)
+     */
+    endedAt?: Date;
+}
+/**
+ * ExecutionSummary - High-level summary of execution
+ *
+ * Provides an aggregate view of the execution including counts,
+ * success rates, and cost information. Useful for dashboards and reporting.
+ */
+export interface ExecutionSummary {
+    /**
+     * Total number of messages processed
+     */
+    totalMessages: number;
+    /**
+     * Tool call counts grouped by tool name
+     * Example: { "Bash": 5, "Read": 3, "Write": 2 }
+     */
+    toolCallsByType: Record<string, number>;
+    /**
+     * File operation counts grouped by operation type
+     * Example: { "read": 3, "write": 2, "edit": 1 }
+     */
+    fileOperationsByType: Record<string, number>;
+    /**
+     * Success rate of tool calls (percentage 0-100)
+     */
+    successRate: number;
+    /**
+     * Total tokens used
+     */
+    totalTokens: {
+        input: number;
+        output: number;
+        cache: number;
+    };
+    /**
+     * Total cost in USD
+     */
+    totalCost: number;
+    /**
+     * Processing duration in milliseconds
+     */
+    duration: number;
+    /**
+     * When processing started
+     */
+    startTime: Date;
+    /**
+     * When processing ended (if finished)
+     */
+    endTime?: Date;
+}
+/**
+ * ToolCallHandler - Callback invoked when a tool is called
+ */
+export type ToolCallHandler = (toolCall: ToolCall) => void;
+/**
+ * FileChangeHandler - Callback invoked when a file is changed
+ */
+export type FileChangeHandler = (change: FileChange) => void;
+/**
+ * ProgressHandler - Callback invoked when metrics are updated
+ */
+export type ProgressHandler = (metrics: ProcessingMetrics) => void;
+/**
+ * ErrorHandler - Callback invoked when an error occurs
+ */
+export type ErrorHandler = (error: {
+    message: string;
+    timestamp: Date;
+    details?: any;
+}) => void;
+/**
+ * MessageHandler - Callback invoked when a text message is received
+ */
+export type MessageHandler = (message: OutputMessage) => void;
+/**
+ * UsageHandler - Callback invoked when usage metrics are updated
+ */
+export type UsageHandler = (usage: UsageMetrics) => void;
+/**
+ * IOutputProcessor - Interface for output processing implementations
+ *
+ * Defines the contract for parsing coding agent output in real-time,
+ * extracting structured data, and providing event-driven updates.
+ *
+ * Current implementations focus on Claude Code's stream-json format,
+ * but the interface is designed to support future agent adapters.
+ */
+export interface IOutputProcessor {
+    /**
+     * Process a single line of output
+     *
+     * The format depends on the agent (stream-json, JSON, text, etc.)
+     *
+     * @param line - Raw output line from the agent
+     * @returns Promise that resolves when line is processed
+     */
+    processLine(line: string): Promise<void>;
+    /**
+     * Get current processing metrics
+     *
+     * @returns Current aggregate metrics
+     */
+    getMetrics(): ProcessingMetrics;
+    /**
+     * Get all tool calls recorded during processing
+     *
+     * @returns Array of all tool calls
+     */
+    getToolCalls(): ToolCall[];
+    /**
+     * Get all file changes detected during processing
+     *
+     * @returns Array of all file changes
+     */
+    getFileChanges(): FileChange[];
+    /**
+     * Register a callback for tool call events
+     *
+     * @param handler - Function to call when a tool is invoked
+     */
+    onToolCall(handler: ToolCallHandler): void;
+    /**
+     * Register a callback for file change events
+     *
+     * @param handler - Function to call when a file is modified
+     */
+    onFileChange(handler: FileChangeHandler): void;
+    /**
+     * Register a callback for progress update events
+     *
+     * @param handler - Function to call when metrics are updated
+     */
+    onProgress(handler: ProgressHandler): void;
+    /**
+     * Register a callback for error events
+     *
+     * @param handler - Function to call when an error occurs
+     */
+    onError(handler: ErrorHandler): void;
+    /**
+     * Register a callback for message events
+     *
+     * @param handler - Function to call when a text message is received
+     */
+    onMessage(handler: MessageHandler): void;
+    /**
+     * Register a callback for usage metric updates
+     *
+     * @param handler - Function to call when usage metrics are updated
+     */
+    onUsage(handler: UsageHandler): void;
+}
+/**
+ * IAgentAdapter - Interface for agent-specific output parsing
+ *
+ * This interface is the extension point for supporting multiple coding agents.
+ * Each agent (Claude Code, Aider, Gemini, Codex) can have its own adapter
+ * that translates agent-specific output to OutputMessage[].
+ *
+ * Future implementation will move agent-specific parsing logic into adapters,
+ * keeping the core IOutputProcessor implementation agent-agnostic.
+ *
+ * @example
+ * ```typescript
+ * class ClaudeCodeAdapter implements IAgentAdapter {
+ *   name = 'claude-code';
+ *   parse(line: string): OutputMessage[] {
+ *     // Parse Claude's stream-json format
+ *   }
+ * }
+ * ```
+ */
+export interface IAgentAdapter {
+    /**
+     * Unique identifier for this agent
+     * Examples: 'claude-code', 'aider', 'gemini-code-assist', 'codex-cli'
+     */
+    readonly name: string;
+    /**
+     * Parse a line of agent output into structured messages
+     *
+     * @param line - Raw output line from the agent
+     * @returns Array of parsed messages (may be empty for unparseable lines)
+     */
+    parse(line: string): OutputMessage[];
+}
+/**
+ * Default usage metrics (empty state)
+ */
+export declare const DEFAULT_USAGE_METRICS: UsageMetrics;
+//# sourceMappingURL=types.d.ts.map

package/dist/execution/output/types.d.ts.map

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

package/dist/execution/process/builders/claude.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Claude Code Configuration Builder
+ *
+ * Utility for building ProcessConfig specific to Claude Code CLI.
+ * Provides type-safe configuration for Claude Code's flags and options.
+ *
+ * @module execution/process/builders/claude
+ */
+import type { ProcessConfig } from '../types.js';
+/**
+ * Configuration options specific to Claude Code CLI
+ */
+export interface ClaudeCodeConfig {
+    /**
+     * Path to Claude Code CLI executable
+     * @default 'claude'
+     */
+    claudePath?: string;
+    /**
+     * Working directory for the process
+     */
+    workDir: string;
+    /**
+     * Run in non-interactive print mode
+     * @default false
+     */
+    print?: boolean;
+    /**
+     * Output format (stream-json recommended for parsing)
+     * @default 'text'
+     */
+    outputFormat?: 'stream-json' | 'json' | 'text';
+    /**
+     * Enable verbose output (required for stream-json with print mode)
+     * @default false
+     */
+    verbose?: boolean;
+    /**
+     * Skip permission prompts
+     * @default false
+     */
+    dangerouslySkipPermissions?: boolean;
+    /**
+     * Permission mode setting
+     */
+    permissionMode?: string;
+    /**
+     * Environment variables to pass to the process
+     */
+    env?: Record<string, string>;
+    /**
+     * Maximum execution time in milliseconds
+     */
+    timeout?: number;
+    /**
+     * Maximum idle time before cleanup (pool only)
+     */
+    idleTimeout?: number;
+    /**
+     * Retry configuration for failed spawns
+     */
+    retry?: {
+        maxAttempts: number;
+        backoffMs: number;
+    };
+}
+/**
+ * Build a generic ProcessConfig from Claude Code specific configuration
+ *
+ * @param config - Claude Code specific configuration
+ * @returns Generic ProcessConfig that can be used with any ProcessManager
+ *
+ * @example
+ * ```typescript
+ * const config = buildClaudeConfig({
+ *   workDir: '/path/to/project',
+ *   print: true,
+ *   outputFormat: 'stream-json',
+ *   dangerouslySkipPermissions: true,
+ * });
+ *
+ * const process = await manager.acquireProcess(config);
+ * ```
+ */
+export declare function buildClaudeConfig(config: ClaudeCodeConfig): ProcessConfig;
+//# sourceMappingURL=claude.d.ts.map

package/dist/execution/process/builders/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../../src/execution/process/builders/claude.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,YAAY,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;IAE/C;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAErC;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,KAAK,CAAC,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,aAAa,CAqCzE"}

package/dist/execution/process/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Process Layer - Public API
+ *
+ * Barrel export for the Process Layer (Layer 1) of the execution system.
+ * Exports all public types, interfaces, and implementations.
+ *
+ * @module execution/process
+ */
+export type { ProcessStatus, ProcessConfig, ManagedProcess, OutputHandler, ErrorHandler, ProcessMetrics, } from './types.js';
+export type { IProcessManager } from './manager.js';
+export { SimpleProcessManager } from './simple-manager.js';
+export { generateId, formatDuration, isValidSignal, formatProcessError, } from './utils.js';
+export { buildClaudeConfig } from './builders/claude.js';
+export type { ClaudeCodeConfig } from './builders/claude.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/execution/process/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/execution/process/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EACV,aAAa,EACb,aAAa,EACb,cAAc,EACd,aAAa,EACb,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG3D,OAAO,EACL,UAAU,EACV,cAAc,EACd,aAAa,EACb,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/execution/process/manager.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Process Manager Interface
+ *
+ * Defines the contract for all process managers in the Process Layer.
+ * Process managers handle spawning, monitoring, and terminating Claude Code processes.
+ *
+ * @module execution/process/manager
+ */
+import type { ManagedProcess, ProcessConfig, ProcessMetrics, OutputHandler, ErrorHandler } from './types.js';
+/**
+ * Core abstraction for managing Claude Code CLI processes
+ *
+ * This interface defines the contract that all process manager implementations
+ * must follow. It provides methods for:
+ * - Process lifecycle management (acquire, release, terminate)
+ * - Process communication (I/O)
+ * - Monitoring and metrics
+ *
+ * @example
+ * ```typescript
+ * const manager: IProcessManager = new SimpleProcessManager();
+ * const process = await manager.acquireProcess({
+ *   claudePath: 'claude',
+ *   workDir: '/path/to/project',
+ *   args: {
+ *     print: true,
+ *     outputFormat: 'stream-json',
+ *     dangerouslySkipPermissions: true,
+ *   },
+ * });
+ * ```
+ */
+export interface IProcessManager {
+    /**
+     * Acquire a new Claude Code process
+     *
+     * Spawns a new process with the given configuration and returns a managed
+     * process handle. The process will be tracked until it exits or is terminated.
+     *
+     * @param config - Configuration for the process
+     * @returns Promise resolving to the managed process
+     * @throws Error if process fails to spawn
+     */
+    acquireProcess(config: ProcessConfig): Promise<ManagedProcess>;
+    /**
+     * Release a process (terminate it gracefully)
+     *
+     * Sends SIGTERM to the process and waits for it to exit. If it doesn't exit
+     * within a grace period, SIGKILL is sent.
+     *
+     * @param processId - ID of the process to release
+     * @returns Promise that resolves when process is terminated
+     */
+    releaseProcess(processId: string): Promise<void>;
+    /**
+     * Terminate a process with a specific signal
+     *
+     * Sends the specified signal to the process. Uses graceful shutdown with
+     * SIGTERM by default, followed by SIGKILL if needed.
+     *
+     * @param processId - ID of the process to terminate
+     * @param signal - Signal to send (defaults to SIGTERM)
+     * @returns Promise that resolves when process is terminated
+     */
+    terminateProcess(processId: string, signal?: NodeJS.Signals): Promise<void>;
+    /**
+     * Send input to a process's stdin
+     *
+     * @param processId - ID of the process
+     * @param input - Input string to send
+     * @returns Promise that resolves when input is written
+     * @throws Error if process is not found
+     */
+    sendInput(processId: string, input: string): Promise<void>;
+    /**
+     * Close stdin stream for a process
+     *
+     * Signals EOF to the process. This is useful for programs like Claude Code
+     * in --print mode that wait for stdin to close before processing input.
+     *
+     * @param processId - ID of the process
+     * @throws Error if process is not found
+     */
+    closeInput(processId: string): void;
+    /**
+     * Register a handler for process output (stdout/stderr)
+     *
+     * The handler will be called whenever the process produces output.
+     * Multiple handlers can be registered for the same process.
+     *
+     * @param processId - ID of the process
+     * @param handler - Handler function to call on output
+     */
+    onOutput(processId: string, handler: OutputHandler): void;
+    /**
+     * Register a handler for process errors
+     *
+     * The handler will be called when the process encounters an error.
+     *
+     * @param processId - ID of the process
+     * @param handler - Handler function to call on error
+     */
+    onError(processId: string, handler: ErrorHandler): void;
+    /**
+     * Get a managed process by ID
+     *
+     * @param processId - ID of the process
+     * @returns The managed process or null if not found
+     */
+    getProcess(processId: string): ManagedProcess | null;
+    /**
+     * Get all currently active processes
+     *
+     * @returns Array of all active managed processes
+     */
+    getActiveProcesses(): ManagedProcess[];
+    /**
+     * Get aggregate metrics for all processes
+     *
+     * @returns Process metrics summary
+     */
+    getMetrics(): ProcessMetrics;
+    /**
+     * Shutdown the process manager
+     *
+     * Terminates all active processes and cleans up resources.
+     * This should be called before the application exits.
+     *
+     * @returns Promise that resolves when all processes are terminated
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/execution/process/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/execution/process/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACd,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,eAAe;IAK9B;;;;;;;;;OASG;IACH,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAE/D;;;;;;;;OAQG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD;;;;;;;;;OASG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAM5E;;;;;;;OAOG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D;;;;;;;;OAQG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpC;;;;;;;;OAQG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAE1D;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAMxD;;;;;OAKG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;IAErD;;;;OAIG;IACH,kBAAkB,IAAI,cAAc,EAAE,CAAC;IAEvC;;;;OAIG;IACH,UAAU,IAAI,cAAc,CAAC;IAM7B;;;;;;;OAOG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B"}