@oni.bot/core 0.6.2 → 0.8.0

package/dist/errors.js

@@ -1,31 +1,187 @@
 // ============================================================
-// @oni.bot/core — Error Types v2
+// @oni.bot/core — Structured Error Types
 // ============================================================
+// ── Base class ────────────────────────────────────────────────
 export class ONIError extends Error {
-    constructor(message) { super(message); this.name = "ONIError"; }
+    code;
+    category;
+    recoverable;
+    suggestion;
+    context;
+    constructor(message, opts) {
+        super(message);
+        this.name = "ONIError";
+        this.code = opts?.code ?? "ONI_UNKNOWN";
+        this.category = opts?.category ?? "GRAPH";
+        this.recoverable = opts?.recoverable ?? false;
+        this.suggestion = opts?.suggestion ?? "";
+        this.context = opts?.context ?? {};
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            category: this.category,
+            message: this.message,
+            recoverable: this.recoverable,
+            suggestion: this.suggestion,
+            context: this.context,
+            stack: this.stack,
+        };
+    }
 }
+// ── Existing errors (backward-compatible constructors) ────────
 export class InvalidSkeletonError extends ONIError {
-    constructor(msg) { super(msg); this.name = "InvalidSkeletonError"; }
+    constructor(msg) {
+        super(msg, {
+            code: "ONI_GRAPH_INVALID",
+            category: "GRAPH",
+            recoverable: false,
+            suggestion: "Check your graph structure for missing nodes or invalid edges.",
+            context: {},
+        });
+        this.name = "InvalidSkeletonError";
+    }
 }
 export class RecursionLimitError extends ONIError {
     constructor(limit) {
-        super(`Recursion limit of ${limit} reached. Possible infinite loop in agent skeleton.`);
+        super(`Recursion limit of ${limit} reached. Possible infinite loop in agent skeleton.`, {
+            code: "ONI_RECURSION_LIMIT",
+            category: "GRAPH",
+            recoverable: false,
+            suggestion: "Increase recursionLimit in config or check for cycles in your graph.",
+            context: { limit },
+        });
         this.name = "RecursionLimitError";
     }
 }
 export class NodeNotFoundError extends ONIError {
-    constructor(name) { super(`Node "${name}" not found in skeleton.`); this.name = "NodeNotFoundError"; }
+    constructor(name) {
+        super(`Node "${name}" not found in skeleton.`, {
+            code: "ONI_NODE_MISSING",
+            category: "NODE",
+            recoverable: false,
+            suggestion: `Ensure node "${name}" has been added to the graph before referencing it.`,
+            context: { node: name },
+        });
+        this.name = "NodeNotFoundError";
+    }
 }
 export class EdgeConflictError extends ONIError {
-    constructor(from, to) { super(`Edge conflict: "${from}" → "${to}" already exists.`); this.name = "EdgeConflictError"; }
+    constructor(from, to) {
+        super(`Edge conflict: "${from}" → "${to}" already exists.`, {
+            code: "ONI_EDGE_CONFLICT",
+            category: "EDGE",
+            recoverable: false,
+            suggestion: "Remove the duplicate edge or use a conditional edge instead.",
+            context: { from, to },
+        });
+        this.name = "EdgeConflictError";
+    }
 }
 export class NodeExecutionError extends ONIError {
     constructor(node, cause) {
-        super(`Node "${node}" failed after all retry attempts: ${cause.message}`);
+        super(`Node "${node}" failed after all retry attempts: ${cause.message}`, {
+            code: "ONI_NODE_EXEC",
+            category: "NODE",
+            recoverable: false,
+            suggestion: "Inspect the cause error and consider adding a retry policy.",
+            context: { node },
+        });
         this.name = "NodeExecutionError";
         this.cause = cause;
     }
 }
+// ── New errors ────────────────────────────────────────────────
+export class NodeTimeoutError extends ONIError {
+    constructor(node, timeoutMs) {
+        super(`Node "${node}" timed out after ${timeoutMs}ms.`, {
+            code: "ONI_NODE_TIMEOUT",
+            category: "NODE",
+            recoverable: true,
+            suggestion: "Increase the node timeout or optimize the node's execution time.",
+            context: { node, timeoutMs },
+        });
+        this.name = "NodeTimeoutError";
+    }
+}
+export class CircuitBreakerOpenError extends ONIError {
+    constructor(node, resetAfterMs) {
+        super(`Circuit breaker for node "${node}" is open. Resets after ${resetAfterMs}ms.`, {
+            code: "ONI_NODE_CIRCUIT_OPEN",
+            category: "NODE",
+            recoverable: true,
+            suggestion: "Wait for the circuit breaker to reset or fix the underlying failures.",
+            context: { node, resetAfterMs },
+        });
+        this.name = "CircuitBreakerOpenError";
+    }
+}
+export class SwarmDeadlockError extends ONIError {
+    constructor(agents) {
+        super(`Swarm deadlock detected among agents: ${agents.join(", ")}.`, {
+            code: "ONI_SWARM_DEADLOCK",
+            category: "SWARM",
+            recoverable: false,
+            suggestion: "Review agent handoff logic to break the circular dependency.",
+            context: { agents },
+        });
+        this.name = "SwarmDeadlockError";
+    }
+}
+export class ModelRateLimitError extends ONIError {
+    constructor(provider, retryAfterMs) {
+        const retryMsg = retryAfterMs != null
+            ? ` Retry after ${retryAfterMs}ms.`
+            : "";
+        super(`Rate limit hit for model provider "${provider}".${retryMsg}`, {
+            code: "ONI_MODEL_RATE_LIMIT",
+            category: "MODEL",
+            recoverable: true,
+            suggestion: "Wait and retry, or switch to a different model provider.",
+            context: { provider, ...(retryAfterMs != null ? { retryAfterMs } : {}) },
+        });
+        this.name = "ModelRateLimitError";
+    }
+}
+export class ModelContextLengthError extends ONIError {
+    constructor(provider, maxTokens) {
+        super(`Context length exceeded for provider "${provider}" (max ${maxTokens} tokens).`, {
+            code: "ONI_MODEL_CONTEXT",
+            category: "MODEL",
+            recoverable: false,
+            suggestion: "Reduce the input size, trim messages, or use a model with a larger context window.",
+            context: { provider, maxTokens },
+        });
+        this.name = "ModelContextLengthError";
+    }
+}
+export class CheckpointCorruptError extends ONIError {
+    constructor(threadId, detail) {
+        super(`Checkpoint for thread "${threadId}" is corrupt: ${detail}`, {
+            code: "ONI_CHECKPOINT_CORRUPT",
+            category: "CHECKPOINT",
+            recoverable: false,
+            suggestion: "Delete the corrupt checkpoint and restart from a known-good state.",
+            context: { threadId, detail },
+        });
+        this.name = "CheckpointCorruptError";
+    }
+}
+export class StoreKeyNotFoundError extends ONIError {
+    constructor(namespace, key) {
+        const ns = namespace.join(".");
+        super(`Key "${key}" not found in store namespace [${ns}].`, {
+            code: "ONI_STORE_KEY",
+            category: "STORE",
+            recoverable: false,
+            suggestion: "Verify the namespace and key exist before accessing them.",
+            context: { namespace, key },
+        });
+        this.name = "StoreKeyNotFoundError";
+    }
+}
+// ── ONIInterrupt (not an Error — unchanged) ───────────────────
 /** Thrown at interrupt checkpoints — caught externally to pause/resume */
 export class ONIInterrupt {
     node;

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,iCAAiC;AACjC,+DAA+D;AAE/D,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC;CACzE;AACD,MAAM,OAAO,oBAAqB,SAAQ,QAAQ;IAChD,YAAY,GAAW,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC,CAAC,CAAC;CAC7E;AACD,MAAM,OAAO,mBAAoB,SAAQ,QAAQ;IAC/C,YAAY,KAAa;QACvB,KAAK,CAAC,sBAAsB,KAAK,qDAAqD,CAAC,CAAC;QACxF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AACD,MAAM,OAAO,iBAAkB,SAAQ,QAAQ;IAC7C,YAAY,IAAY,IAAI,KAAK,CAAC,SAAS,IAAI,0BAA0B,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC,CAAC,CAAC;CAC/G;AACD,MAAM,OAAO,iBAAkB,SAAQ,QAAQ;IAC7C,YAAY,IAAY,EAAE,EAAU,IAAI,KAAK,CAAC,mBAAmB,IAAI,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC,CAAC,CAAC;CACxI;AACD,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IAC9C,YAAY,IAAY,EAAE,KAAY;QACpC,KAAK,CAAC,SAAS,IAAI,sCAAsC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1E,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,0EAA0E;AAC1E,MAAM,OAAO,YAAY;IAGL;IACA;IACA;IAJT,cAAc,GAAG,IAAI,CAAC;IAC/B,YACkB,IAAc,EACd,MAA0B,EAC1B,KAAe;QAFf,SAAI,GAAJ,IAAI,CAAU;QACd,WAAM,GAAN,MAAM,CAAoB;QAC1B,UAAK,GAAL,KAAK,CAAU;IAC9B,CAAC;CACL"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/graph.d.ts

@@ -4,6 +4,7 @@ import type { HITLSession } from "./hitl/index.js";
 import type { BaseStore } from "./store/index.js";
 import type { GuardrailsConfig } from "./guardrails/types.js";
 import type { EventListeners } from "./events/types.js";
+import type { TracerLike } from "./telemetry.js";
 export interface ONISkeletonV3<S> extends ONISkeleton<S> {
     /**
      * Resume a paused execution by providing a response to an interrupt.
@@ -17,6 +18,10 @@ export interface ONISkeletonV3<S> extends ONISkeleton<S> {
     getPendingInterrupts(config: {
         threadId: string;
     }): HITLSession<S>[];
+    /** Get dead letters for a thread (only available when deadLetterQueue is enabled) */
+    getDeadLetters?(config: {
+        threadId: string;
+    }): import("./dlq.js").DeadLetter[];
 }
 export declare class StateGraph<S extends Record<string, unknown>> {
     private nodes;
@@ -28,6 +33,12 @@ export declare class StateGraph<S extends Record<string, unknown>> {
     addNode(name: string, fn: NodeFn<S>, opts?: {
         retry?: RetryPolicy;
         cache?: boolean | CachePolicy;
+        timeout?: number;
+        circuitBreaker?: {
+            threshold: number;
+            resetAfter: number;
+            fallback?: (state: S, error: Error) => import("./types.js").NodeReturn<S>;
+        };
     }): this;
     addSubgraph(name: string, subgraph: ONISkeleton<S>, opts?: {
         retry?: RetryPolicy;
@@ -46,6 +57,12 @@ export interface CompileOptions<S> {
     store?: BaseStore;
     guardrails?: GuardrailsConfig;
     listeners?: EventListeners;
+    defaults?: {
+        nodeTimeout?: number;
+    };
+    deadLetterQueue?: boolean;
+    /** OTel-compatible tracer for distributed tracing. Pass any Tracer that satisfies TracerLike. */
+    tracer?: TracerLike;
 }
 export interface ONIMessage {
     role: "user" | "assistant" | "system" | "tool";

package/dist/graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,QAAQ,EAAE,KAAK,MAAM,EAC1B,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EACpD,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAGzD,MAAM,YAAY,CAAC;AAGpB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAMjD,MAAM,WAAW,aAAa,CAAC,CAAC,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;IACtD;;;OAGG;IACH,MAAM,CACJ,MAAM,EAAI;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAChD,KAAK,EAAK,OAAO,GAChB,OAAO,CAAC,CAAC,CAAC,CAAC;IAEd,sDAAsD;IACtD,oBAAoB,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IAErE,qFAAqF;IACrF,cAAc,CAAC,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,UAAU,EAAE,UAAU,EAAE,CAAC;CAChF;AAMD,qBAAa,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvD,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;gBAEhC,MAAM,EAAE;QAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;KAAE;IAIlD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE;QAC1C,KAAK,CAAC,EAAE,WAAW,CAAC;QACpB,KAAK,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;QAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,cAAc,CAAC,EAAE;YACf,SAAS,EAAE,MAAM,CAAC;YAClB,UAAU,EAAE,MAAM,CAAC;YACnB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;SAC3E,CAAC;KACH,GAAG,IAAI;IAeR,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,IAAI;IAOzF,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI;IAIzC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,GAAG,QAAQ,EAAE,GAAG,IAAI;IAUxD,mBAAmB,CACjB,IAAI,EAAE,QAAQ,EACd,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,SAAS,KAAK,QAAQ,GAAG,QAAQ,EAAE,EAClE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GACjC,IAAI;IAKP,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,OAAO,GAAE,cAAc,CAAC,CAAC,CAAM,GAAG,aAAa,CAAC,CAAC,CAAC;IAwD1D,SAAS,IAAI,MAAM;CAepB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,YAAY,CAAC,EAAK,eAAe,CAAC,CAAC,CAAC,CAAC;IACrC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAG,MAAM,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAY,SAAS,CAAC;IAC5B,UAAU,CAAC,EAAO,gBAAgB,CAAC;IACnC,SAAS,CAAC,EAAQ,cAAc,CAAC;IACjC,QAAQ,CAAC,EAAE;QACT,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iGAAiG;IACjG,MAAM,CAAC,EAAW,UAAU,CAAC;CAC9B;AAMD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAW,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IACxD,OAAO,EAAQ,MAAM,CAAC;IACtB,IAAI,CAAC,EAAU,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAI,WAAW,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzD;AAED,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC;AAEtD,qBAAa,YAAa,SAAQ,UAAU,CAAC,YAAY,CAAC;;CAIzD;AAQD,OAAO,QAAQ,YAAY,CAAC;IAC1B,UAAU,UAAU,CAAC,CAAC;QACpB,QAAQ,IAAI,OAAO,cAAc,EAAE,eAAe,CAAC;QACnD,iBAAiB,IAAI,MAAM,CAAC;KAC7B;CACF"}

package/dist/graph.js

@@ -4,6 +4,7 @@
 // ============================================================
 import { START, END, appendList, } from "./types.js";
 import { InvalidSkeletonError, EdgeConflictError, NodeNotFoundError } from "./errors.js";
+import { DeadLetterQueue } from "./dlq.js";
 import { ONIPregelRunner } from "./pregel.js";
 // ----------------------------------------------------------------
 // StateGraph
@@ -20,7 +21,13 @@ export class StateGraph {
             throw new InvalidSkeletonError(`"${name}" is reserved.`);
         if (this.nodes.has(name))
             throw new InvalidSkeletonError(`Node "${name}" already registered.`);
-        this.nodes.set(name, { name, fn, retry: opts?.retry, cache: opts?.cache });
+        this.nodes.set(name, {
+            name, fn,
+            retry: opts?.retry,
+            cache: opts?.cache,
+            timeout: opts?.timeout,
+            circuitBreaker: opts?.circuitBreaker,
+        });
         return this;
     }
     addSubgraph(name, subgraph, opts) {
@@ -61,7 +68,8 @@ export class StateGraph {
     }
     compile(options = {}) {
         this.validate();
-        const runner = new ONIPregelRunner(this.nodes, this.edges, this.channels, { interruptBefore: options.interruptBefore, interruptAfter: options.interruptAfter }, options.checkpointer ?? null, options.store ?? null, options.guardrails, options.listeners);
+        const dlq = options.deadLetterQueue ? new DeadLetterQueue() : null;
+        const runner = new ONIPregelRunner(this.nodes, this.edges, this.channels, { interruptBefore: options.interruptBefore, interruptAfter: options.interruptAfter }, options.checkpointer ?? null, options.store ?? null, options.guardrails, options.listeners, options.defaults, dlq, options.tracer ?? null);
         const skeleton = {
             invoke: (input, config) => runner.invoke(input, config),
             stream: (input, config) => runner.stream(input, config),
@@ -82,6 +90,9 @@ export class StateGraph {
             getPendingInterrupts(cfg) {
                 return runner.getPendingInterrupts(cfg.threadId);
             },
+            getDeadLetters(cfg) {
+                return runner.getDeadLetters(cfg.threadId);
+            },
         };
         // Attach runner as internal property for subgraph Command.PARENT support
         skeleton._runner = runner;

package/dist/graph.js.map

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

package/dist/harness/agent-loop.d.ts

@@ -0,0 +1,8 @@
+import type { AgentLoopConfig, LoopMessage } from "./types.js";
+export declare function agentLoop(prompt: string, config: AgentLoopConfig): AsyncGenerator<LoopMessage>;
+export declare function wrapWithAgentLoop<S extends Record<string, unknown> & {
+    task?: string;
+    context?: string;
+    agentResults?: Record<string, string>;
+}>(config: AgentLoopConfig): (state: S) => Promise<Partial<S>>;
+//# sourceMappingURL=agent-loop.d.ts.map

package/dist/harness/agent-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-loop.d.ts","sourceRoot":"","sources":["../../src/harness/agent-loop.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EAIZ,MAAM,YAAY,CAAC;AAKpB,wBAAuB,SAAS,CAC9B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,eAAe,GACtB,cAAc,CAAC,WAAW,CAAC,CAoU7B;AAID,wBAAgB,iBAAiB,CAC/B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC,EACD,MAAM,EAAE,eAAe,GAAG,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAsB5D"}