@herdctl/core 0.0.1

package/dist/runner/errors.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Error classes for runner module
+ *
+ * Provides typed errors with descriptive messages for SDK and execution failures.
+ * All errors include context such as job ID and agent name for debugging.
+ */
+/**
+ * Base error class for all runner errors
+ */
+export declare class RunnerError extends Error {
+    /** The job ID associated with this error, if available */
+    readonly jobId?: string;
+    /** The agent name associated with this error, if available */
+    readonly agentName?: string;
+    constructor(message: string, options?: {
+        jobId?: string;
+        agentName?: string;
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when SDK initialization fails
+ *
+ * Common causes:
+ * - Missing API key (ANTHROPIC_API_KEY not set)
+ * - Invalid API key
+ * - Network connectivity issues
+ * - SDK configuration errors
+ */
+export declare class SDKInitializationError extends RunnerError {
+    /** The underlying error code if available */
+    readonly code?: string;
+    constructor(message: string, options?: {
+        jobId?: string;
+        agentName?: string;
+        cause?: Error;
+        code?: string;
+    });
+    /**
+     * Check if this error is due to a missing API key
+     */
+    isMissingApiKey(): boolean;
+    /**
+     * Check if this error is due to network connectivity
+     */
+    isNetworkError(): boolean;
+}
+/**
+ * Error thrown during SDK streaming execution
+ *
+ * Represents errors that occur while receiving messages from the SDK,
+ * such as connection drops, rate limits, or API errors.
+ */
+export declare class SDKStreamingError extends RunnerError {
+    /** The underlying error code if available */
+    readonly code?: string;
+    /** Number of messages received before the error */
+    readonly messagesReceived?: number;
+    constructor(message: string, options?: {
+        jobId?: string;
+        agentName?: string;
+        cause?: Error;
+        code?: string;
+        messagesReceived?: number;
+    });
+    /**
+     * Check if this error is due to rate limiting
+     */
+    isRateLimited(): boolean;
+    /**
+     * Check if this error is a connection error
+     */
+    isConnectionError(): boolean;
+    /**
+     * Check if this error is recoverable (could retry)
+     */
+    isRecoverable(): boolean;
+}
+/**
+ * Error thrown when the SDK returns a malformed or unexpected response
+ *
+ * This error helps identify issues with SDK responses that don't match
+ * expected formats, allowing graceful handling instead of crashes.
+ */
+export declare class MalformedResponseError extends RunnerError {
+    /** The raw response that caused the error */
+    readonly rawResponse?: unknown;
+    /** Description of what was expected */
+    readonly expected?: string;
+    constructor(message: string, options?: {
+        jobId?: string;
+        agentName?: string;
+        cause?: Error;
+        rawResponse?: unknown;
+        expected?: string;
+    });
+}
+/**
+ * Build a descriptive error message with context
+ */
+export declare function buildErrorMessage(baseMessage: string, context?: {
+    jobId?: string;
+    agentName?: string;
+}): string;
+/**
+ * Determine the exit reason based on error type
+ */
+export type ErrorExitReason = "error" | "timeout" | "cancelled" | "max_turns";
+/**
+ * Classify an error to determine the appropriate exit reason
+ */
+export declare function classifyError(error: Error): ErrorExitReason;
+/**
+ * Wrap an unknown error in an appropriate RunnerError type
+ */
+export declare function wrapError(error: unknown, context: {
+    jobId?: string;
+    agentName?: string;
+    phase?: "init" | "streaming";
+}): RunnerError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/runner/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/runner/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,0DAA0D;IAC1D,SAAgB,KAAK,CAAC,EAAE,MAAM,CAAC;IAC/B,8DAA8D;IAC9D,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAGjC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAQlE;AAMD;;;;;;;;GAQG;AACH,qBAAa,sBAAuB,SAAQ,WAAW;IACrD,6CAA6C;IAC7C,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;gBAG5B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAOhF;;OAEG;IACH,eAAe,IAAI,OAAO;IAW1B;;OAEG;IACH,cAAc,IAAI,OAAO;CAQ1B;AAMD;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;IAChD,6CAA6C;IAC7C,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,mDAAmD;IACnD,SAAgB,gBAAgB,CAAC,EAAE,MAAM,CAAC;gBAGxC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,KAAK,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B;IAQH;;OAEG;IACH,aAAa,IAAI,OAAO;IAUxB;;OAEG;IACH,iBAAiB,IAAI,OAAO;IAS5B;;OAEG;IACH,aAAa,IAAI,OAAO;CAGzB;AAMD;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,WAAW;IACrD,6CAA6C;IAC7C,SAAgB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtC,uCAAuC;IACvC,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAGhC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,KAAK,CAAC;QACd,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB;CAOJ;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C,MAAM,CAYR;AAMD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC;AAE9E;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe,CA4B3D;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,CAAA;CAAE,GAC5E,WAAW,CAmDb"}

package/dist/runner/errors.js

@@ -0,0 +1,212 @@
+/**
+ * Error classes for runner module
+ *
+ * Provides typed errors with descriptive messages for SDK and execution failures.
+ * All errors include context such as job ID and agent name for debugging.
+ */
+// =============================================================================
+// Base Error Class
+// =============================================================================
+/**
+ * Base error class for all runner errors
+ */
+export class RunnerError extends Error {
+    /** The job ID associated with this error, if available */
+    jobId;
+    /** The agent name associated with this error, if available */
+    agentName;
+    constructor(message, options) {
+        super(message);
+        this.name = "RunnerError";
+        this.jobId = options?.jobId;
+        this.agentName = options?.agentName;
+        this.cause = options?.cause;
+    }
+}
+// =============================================================================
+// SDK Initialization Errors
+// =============================================================================
+/**
+ * Error thrown when SDK initialization fails
+ *
+ * Common causes:
+ * - Missing API key (ANTHROPIC_API_KEY not set)
+ * - Invalid API key
+ * - Network connectivity issues
+ * - SDK configuration errors
+ */
+export class SDKInitializationError extends RunnerError {
+    /** The underlying error code if available */
+    code;
+    constructor(message, options) {
+        super(message, options);
+        this.name = "SDKInitializationError";
+        this.code = options?.code ?? options?.cause?.code;
+    }
+    /**
+     * Check if this error is due to a missing API key
+     */
+    isMissingApiKey() {
+        const msg = this.message.toLowerCase();
+        return (msg.includes("api key") ||
+            msg.includes("api_key") ||
+            msg.includes("authentication") ||
+            msg.includes("unauthorized") ||
+            this.code === "ENOKEY");
+    }
+    /**
+     * Check if this error is due to network connectivity
+     */
+    isNetworkError() {
+        return (this.code === "ECONNREFUSED" ||
+            this.code === "ENOTFOUND" ||
+            this.code === "ETIMEDOUT" ||
+            this.code === "ECONNRESET");
+    }
+}
+// =============================================================================
+// SDK Streaming Errors
+// =============================================================================
+/**
+ * Error thrown during SDK streaming execution
+ *
+ * Represents errors that occur while receiving messages from the SDK,
+ * such as connection drops, rate limits, or API errors.
+ */
+export class SDKStreamingError extends RunnerError {
+    /** The underlying error code if available */
+    code;
+    /** Number of messages received before the error */
+    messagesReceived;
+    constructor(message, options) {
+        super(message, options);
+        this.name = "SDKStreamingError";
+        this.code = options?.code ?? options?.cause?.code;
+        this.messagesReceived = options?.messagesReceived;
+    }
+    /**
+     * Check if this error is due to rate limiting
+     */
+    isRateLimited() {
+        const msg = this.message.toLowerCase();
+        return (msg.includes("rate limit") ||
+            msg.includes("too many requests") ||
+            this.code === "ERATELIMIT" ||
+            this.code === "429");
+    }
+    /**
+     * Check if this error is a connection error
+     */
+    isConnectionError() {
+        return (this.code === "ECONNREFUSED" ||
+            this.code === "ECONNRESET" ||
+            this.code === "EPIPE" ||
+            this.code === "ETIMEDOUT");
+    }
+    /**
+     * Check if this error is recoverable (could retry)
+     */
+    isRecoverable() {
+        return this.isRateLimited() || this.isConnectionError();
+    }
+}
+// =============================================================================
+// Malformed Response Error
+// =============================================================================
+/**
+ * Error thrown when the SDK returns a malformed or unexpected response
+ *
+ * This error helps identify issues with SDK responses that don't match
+ * expected formats, allowing graceful handling instead of crashes.
+ */
+export class MalformedResponseError extends RunnerError {
+    /** The raw response that caused the error */
+    rawResponse;
+    /** Description of what was expected */
+    expected;
+    constructor(message, options) {
+        super(message, options);
+        this.name = "MalformedResponseError";
+        this.rawResponse = options?.rawResponse;
+        this.expected = options?.expected;
+    }
+}
+// =============================================================================
+// Error Context Builder
+// =============================================================================
+/**
+ * Build a descriptive error message with context
+ */
+export function buildErrorMessage(baseMessage, context) {
+    const parts = [baseMessage];
+    if (context?.agentName) {
+        parts.push(`Agent: ${context.agentName}`);
+    }
+    if (context?.jobId) {
+        parts.push(`Job: ${context.jobId}`);
+    }
+    return parts.join(" | ");
+}
+/**
+ * Classify an error to determine the appropriate exit reason
+ */
+export function classifyError(error) {
+    const msg = error.message.toLowerCase();
+    // Check for timeout
+    if (msg.includes("timeout") ||
+        msg.includes("timed out") ||
+        error.code === "ETIMEDOUT") {
+        return "timeout";
+    }
+    // Check for cancellation
+    if (msg.includes("abort") ||
+        msg.includes("cancel") ||
+        error.name === "AbortError") {
+        return "cancelled";
+    }
+    // Check for max turns
+    if (msg.includes("max turns") || msg.includes("max_turns") || msg.includes("turn limit") || msg.includes("maximum turns")) {
+        return "max_turns";
+    }
+    // Default to generic error
+    return "error";
+}
+/**
+ * Wrap an unknown error in an appropriate RunnerError type
+ */
+export function wrapError(error, context) {
+    // Already a RunnerError
+    if (error instanceof RunnerError) {
+        return error;
+    }
+    // Convert to Error if needed
+    const baseError = error instanceof Error ? error : new Error(String(error));
+    // Determine error type based on phase and characteristics
+    const message = baseError.message.toLowerCase();
+    const phase = context.phase ?? "streaming";
+    if (phase === "init") {
+        return new SDKInitializationError(buildErrorMessage(baseError.message, context), {
+            jobId: context.jobId,
+            agentName: context.agentName,
+            cause: baseError,
+        });
+    }
+    // Check for malformed response indicators
+    if (message.includes("unexpected") ||
+        message.includes("invalid json") ||
+        message.includes("parse error") ||
+        message.includes("malformed")) {
+        return new MalformedResponseError(buildErrorMessage(baseError.message, context), {
+            jobId: context.jobId,
+            agentName: context.agentName,
+            cause: baseError,
+        });
+    }
+    // Default to streaming error for runtime errors
+    return new SDKStreamingError(buildErrorMessage(baseError.message, context), {
+        jobId: context.jobId,
+        agentName: context.agentName,
+        cause: baseError,
+    });
+}
+//# sourceMappingURL=errors.js.map

package/dist/runner/errors.js.map

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

package/dist/runner/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Agent Runner module
+ *
+ * Provides functionality to execute agents using the Claude Agent SDK
+ * with proper configuration, permissions, MCP server support, and output handling.
+ */
+export type { RunnerOptions, RunnerOptionsWithCallbacks, RunnerResult, RunnerErrorDetails, SDKMessage, MessageCallback, SDKQueryOptions, SDKMcpServerConfig, SDKSystemPrompt, ProcessedMessage, } from "./types.js";
+export { RunnerError, SDKInitializationError, SDKStreamingError, MalformedResponseError, buildErrorMessage, classifyError, wrapError, type ErrorExitReason, } from "./errors.js";
+export { toSDKOptions, transformMcpServers, transformMcpServer, buildSystemPrompt, type ToSDKOptionsParams, } from "./sdk-adapter.js";
+export { processSDKMessage, isTerminalMessage, extractSummary, } from "./message-processor.js";
+export { JobExecutor, executeJob, type JobExecutorLogger, type JobExecutorOptions, type SDKQueryFunction, } from "./job-executor.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/runner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runner/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,aAAa,EACb,0BAA0B,EAC1B,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,EACb,SAAS,EACT,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,kBAAkB,GACxB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,GACf,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,WAAW,EACX,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC"}

package/dist/runner/index.js

@@ -0,0 +1,15 @@
+/**
+ * Agent Runner module
+ *
+ * Provides functionality to execute agents using the Claude Agent SDK
+ * with proper configuration, permissions, MCP server support, and output handling.
+ */
+// Export error types and utilities
+export { RunnerError, SDKInitializationError, SDKStreamingError, MalformedResponseError, buildErrorMessage, classifyError, wrapError, } from "./errors.js";
+// Export SDK adapter functions
+export { toSDKOptions, transformMcpServers, transformMcpServer, buildSystemPrompt, } from "./sdk-adapter.js";
+// Export message processor functions
+export { processSDKMessage, isTerminalMessage, extractSummary, } from "./message-processor.js";
+// Export job executor
+export { JobExecutor, executeJob, } from "./job-executor.js";
+//# sourceMappingURL=index.js.map

package/dist/runner/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runner/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,mCAAmC;AACnC,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,EACb,SAAS,GAEV,MAAM,aAAa,CAAC;AAErB,+BAA+B;AAC/B,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,GAElB,MAAM,kBAAkB,CAAC;AAE1B,qCAAqC;AACrC,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,GACf,MAAM,wBAAwB,CAAC;AAEhC,sBAAsB;AACtB,OAAO,EACL,WAAW,EACX,UAAU,GAIX,MAAM,mBAAmB,CAAC"}

package/dist/runner/job-executor.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Job executor for running agents with streaming output to job logs
+ *
+ * Manages the lifecycle of agent execution including:
+ * - Creating job records before execution
+ * - Streaming all SDK messages to job output in real-time
+ * - Updating job status and metadata on completion
+ */
+import type { RunnerOptionsWithCallbacks, RunnerResult, SDKMessage } from "./types.js";
+/**
+ * Logger interface for job executor
+ */
+export interface JobExecutorLogger {
+    warn: (message: string) => void;
+    error: (message: string) => void;
+    info?: (message: string) => void;
+}
+/**
+ * Options for job executor
+ */
+export interface JobExecutorOptions {
+    /** Logger for warnings and errors */
+    logger?: JobExecutorLogger;
+}
+/**
+ * SDK query function type (for dependency injection)
+ */
+export type SDKQueryFunction = (params: {
+    prompt: string;
+    options?: Record<string, unknown>;
+    abortController?: AbortController;
+}) => AsyncIterable<SDKMessage>;
+/**
+ * Executes agents with streaming output to job logs
+ *
+ * This class manages the complete lifecycle of agent execution:
+ * 1. Creates a job record before starting
+ * 2. Updates job status to 'running'
+ * 3. Streams all SDK messages to job output in real-time
+ * 4. Updates job with final status on completion
+ *
+ * @example
+ * ```typescript
+ * const executor = new JobExecutor(sdkQuery);
+ *
+ * const result = await executor.execute({
+ *   agent: resolvedAgent,
+ *   prompt: "Fix the bug in auth.ts",
+ *   stateDir: "/path/to/.herdctl",
+ *   triggerType: "manual",
+ * });
+ *
+ * console.log(`Job ${result.jobId} completed: ${result.success}`);
+ * ```
+ */
+export declare class JobExecutor {
+    private sdkQuery;
+    private logger;
+    /**
+     * Create a new job executor
+     *
+     * @param sdkQuery - The SDK query function to use for agent execution
+     * @param options - Optional configuration
+     */
+    constructor(sdkQuery: SDKQueryFunction, options?: JobExecutorOptions);
+    /**
+     * Execute an agent and stream output to job log
+     *
+     * @param options - Runner options including agent config and prompt
+     * @returns Result of the execution including job ID and status
+     */
+    execute(options: RunnerOptionsWithCallbacks): Promise<RunnerResult>;
+}
+/**
+ * Execute an agent with streaming output to job log
+ *
+ * This is a convenience function that creates a JobExecutor and runs
+ * a single execution. For multiple executions, prefer creating a
+ * JobExecutor instance directly.
+ *
+ * @param sdkQuery - The SDK query function
+ * @param options - Runner options including agent config and prompt
+ * @param executorOptions - Optional executor configuration
+ * @returns Result of the execution
+ *
+ * @example
+ * ```typescript
+ * import { query } from "@anthropic-ai/claude-agent-sdk";
+ *
+ * const result = await executeJob(query, {
+ *   agent: resolvedAgent,
+ *   prompt: "Fix the bug",
+ *   stateDir: "/path/to/.herdctl",
+ * });
+ * ```
+ */
+export declare function executeJob(sdkQuery: SDKQueryFunction, options: RunnerOptionsWithCallbacks, executorOptions?: JobExecutorOptions): Promise<RunnerResult>;
+//# sourceMappingURL=job-executor.d.ts.map

package/dist/runner/job-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-executor.d.ts","sourceRoot":"","sources":["../../src/runner/job-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAEV,0BAA0B,EAC1B,YAAY,EAEZ,UAAU,EACX,MAAM,YAAY,CAAC;AAgCpB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC,KAAK,aAAa,CAAC,UAAU,CAAC,CAAC;AAgBhC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,MAAM,CAAoB;IAElC;;;;;OAKG;gBACS,QAAQ,EAAE,gBAAgB,EAAE,OAAO,GAAE,kBAAuB;IAKxE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,YAAY,CAAC;CAuR1E;AAMD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,0BAA0B,EACnC,eAAe,GAAE,kBAAuB,GACvC,OAAO,CAAC,YAAY,CAAC,CAGvB"}