langfx.js 0.1.0-alpha.0

package/dist/agentic.js

@@ -0,0 +1,265 @@
+import { abortable, cancellationScope, checkCancelled } from './cancellation.js';
+import { CancelledError, SessionClosedError } from './errors.js';
+import { query } from './query.js';
+let serial = 0;
+function trace(kind, name, parentId) {
+    return { id: `invocation-${++serial}`, parentId, kind, name, status: 'running', startedAt: Date.now(), endedAt: undefined, result: undefined, error: undefined, usage: undefined, metadata: Object.freeze({}), logs: [], progress: undefined, children: [] };
+}
+function snapshot(node) {
+    return Object.freeze({ ...node, logs: Object.freeze([...node.logs]), children: Object.freeze(node.children.map(snapshot)) });
+}
+function flatten(node) {
+    return node.children.flatMap(child => [child, ...flatten(child)]);
+}
+export class Session {
+    store;
+    node;
+    scope;
+    lm;
+    bound = false;
+    active = true;
+    operations = new Set();
+    constructor(options = {}) {
+        const limit = options.maxTraceNodes ?? 10_000;
+        if (!Number.isInteger(limit) || limit < 1)
+            throw new RangeError('maxTraceNodes must be a positive integer.');
+        const logLimit = options.maxLogEntries ?? 10_000;
+        if (!Number.isInteger(logLimit) || logLimit < 0)
+            throw new RangeError('maxLogEntries must be a non-negative integer.');
+        this.lm = options.lm;
+        this.node = trace('session', 'Session');
+        this.scope = cancellationScope([options.signal], options.maxExecutionTime);
+        this.store = { root: this.node, closed: false, nodes: 1, limit, logLimit, logCount: 0, logSequence: 0, observers: new Set(), observerErrors: [], pending: new Set() };
+    }
+    get signal() { return this.scope.signal; }
+    /** Root session metadata, matching Python Session.metadata. */
+    get metadata() { return this.store.root.metadata; }
+    /** Snapshot of the invocation owned by this Session view. */
+    get currentInvocation() { return snapshot(this.node); }
+    get root() { return snapshot(this.store.root); }
+    get allActions() { return flatten(this.root).filter(node => node.kind === 'action'); }
+    get allQueries() { return flatten(this.root).filter(node => node.kind === 'query'); }
+    get allLogs() {
+        const root = this.root;
+        return Object.freeze([root, ...flatten(root)].flatMap(node => node.logs).sort((a, b) => a.sequence - b.sequence));
+    }
+    get observerErrors() { return [...this.store.observerErrors]; }
+    get usageSummary() { return this.summarizeUsage(false); }
+    get cachedUsageSummary() { return this.summarizeUsage(true); }
+    summarizeUsage(cached) {
+        let promptTokens = 0, completionTokens = 0, totalTokens = 0, unknownQueries = 0;
+        for (const node of this.allQueries) {
+            if (cached && !node.cacheHit)
+                continue;
+            const usage = cached ? node.cachedUsage : node.usage;
+            if (!usage)
+                unknownQueries++;
+            else {
+                promptTokens += usage.promptTokens;
+                completionTokens += usage.completionTokens;
+                totalTokens += usage.totalTokens;
+            }
+        }
+        return { known: { promptTokens, completionTokens, totalTokens }, unknownQueries };
+    }
+    subscribe(observer) {
+        this.assertOpen();
+        this.store.observers.add(observer);
+        return () => { this.store.observers.delete(observer); };
+    }
+    /** Shallow-merge metadata into this view's invocation, never its parent. */
+    addMetadata(metadata) {
+        this.assertOpen();
+        if (!metadata || typeof metadata !== 'object' || Array.isArray(metadata))
+            throw new TypeError('Metadata must be a record.');
+        this.node.metadata = Object.freeze({ ...this.node.metadata, ...metadata });
+        this.dispatch(Object.freeze({ type: 'metadata', invocation: snapshot(this.node) }));
+    }
+    debug(message, options = {}) { this.log('debug', message, options); }
+    info(message, options = {}) { this.log('info', message, options); }
+    warning(message, options = {}) { this.log('warning', message, options); }
+    error(message, options = {}) { this.log('error', message, options); }
+    fatal(message, options = {}) { this.log('fatal', message, options); }
+    updateProgress(title, metadata = {}) {
+        this.assertOpen();
+        if (typeof title !== 'string')
+            throw new TypeError('Progress title must be a string.');
+        const progress = Object.freeze({ title, timestamp: Date.now(), metadata: Object.freeze({ ...metadata }) });
+        this.node.progress = progress;
+        this.dispatch(Object.freeze({ type: 'progress', invocation: snapshot(this.node), progress }));
+    }
+    log(level, message, options) {
+        this.assertOpen();
+        if (typeof message !== 'string')
+            throw new TypeError('Log message must be a string.');
+        const keep = options.keep ?? true;
+        if (keep && this.store.logCount >= this.store.logLimit)
+            throw new RangeError('Session log limit reached. Use keep: false or increase maxLogEntries.');
+        const entry = Object.freeze({ sequence: ++this.store.logSequence, invocationId: this.node.id, timestamp: Date.now(), level, message, metadata: Object.freeze({ ...options.metadata }) });
+        if (keep) {
+            this.node.logs.push(entry);
+            this.store.logCount++;
+        }
+        this.dispatch(Object.freeze({ type: 'log', invocation: snapshot(this.node), entry }));
+    }
+    async query(prompt, schemaOrOptions = {}, options) {
+        const isSchema = typeof schemaOrOptions === 'function' || 'schema' in schemaOrOptions || 'parse' in schemaOrOptions;
+        const schema = isSchema ? schemaOrOptions : undefined;
+        const config = (isSchema ? options : schemaOrOptions) ?? {};
+        return this.execute('query', 'query', async (view) => {
+            const lm = config.lm ?? view.lm;
+            if (!lm)
+                throw new TypeError('Session.query requires a LanguageModel.');
+            const full = { ...config, lm, signal: view.signal, returnsMessage: true };
+            const response = schema ? await query(prompt, schema, full) : await query(prompt, full);
+            view.node.usage = response.metadata['usage'];
+            view.node.cacheHit = response.metadata['cacheHit'] === true;
+            if (response.metadata['cachedUsage'])
+                view.node.cachedUsage = response.metadata['cachedUsage'];
+            return config.returnsMessage ? response : response.result;
+        }, config);
+    }
+    async concurrentMap(inputs, fn, options = {}) {
+        const concurrency = options.maxConcurrency ?? 4;
+        if (!Number.isInteger(concurrency) || concurrency < 1)
+            throw new RangeError('maxConcurrency must be a positive integer.');
+        return this.execute('parallel', 'concurrentMap', async (group) => {
+            const batch = cancellationScope([group.signal]);
+            const results = new Array(inputs.length);
+            let cursor = 0;
+            let failed = false;
+            let failure;
+            const worker = async () => {
+                while (!failed && cursor < inputs.length) {
+                    const index = cursor++;
+                    try {
+                        results[index] = await group.execute('branch', String(index), branch => fn(inputs[index], branch), { signal: batch.signal });
+                    }
+                    catch (error) {
+                        if (!failed) {
+                            failed = true;
+                            failure = error;
+                            batch.abort(error);
+                        }
+                    }
+                }
+            };
+            try {
+                await Promise.all(Array.from({ length: Math.min(concurrency, inputs.length) }, worker));
+                if (failed)
+                    throw failure;
+                return results;
+            }
+            finally {
+                batch.dispose();
+            }
+        });
+    }
+    /** @internal Action.invoke is the public action lifecycle entry point. */
+    async runAction(action, options = {}) {
+        return this.execute('action', action.name, view => action.call(view), options);
+    }
+    async dispose() {
+        if (this.bound)
+            throw new TypeError('Dispose the owning Session, not an invocation-bound view.');
+        if (!this.store.closed) {
+            this.store.closed = true;
+            this.scope.abort(new CancelledError('Session disposed.'));
+            await Promise.allSettled([...this.store.pending]);
+            this.node.status = this.node.children.some(child => child.status === 'cancelled') ? 'cancelled'
+                : this.node.children.some(child => child.status === 'failed') ? 'failed' : 'completed';
+            this.node.endedAt = Date.now();
+            this.emit('end', this.node);
+            this.store.observers.clear();
+            this.scope.dispose();
+            this.active = false;
+        }
+    }
+    assertOpen() {
+        if (this.store.closed || !this.active)
+            throw new SessionClosedError('Session or invocation has ended.');
+        checkCancelled(this.signal);
+    }
+    async execute(kind, name, work, options = {}) {
+        this.assertOpen();
+        if (this.store.nodes >= this.store.limit)
+            throw new RangeError('Session trace limit reached. Start a new session or increase maxTraceNodes.');
+        const scope = cancellationScope([this.signal, options.signal], options.maxExecutionTime);
+        const node = trace(kind, name, this.node.id);
+        this.store.nodes++;
+        this.node.children.push(node);
+        const view = new Session();
+        view.scope.dispose();
+        view.store = this.store;
+        view.node = node;
+        view.scope = scope;
+        view.lm = options.lm ?? this.lm;
+        view.bound = true;
+        this.emit('start', node);
+        const task = (async () => {
+            try {
+                checkCancelled(scope.signal);
+                const result = await abortable(Promise.resolve().then(() => { view.assertOpen(); return work(view); }), scope.signal);
+                checkCancelled(scope.signal);
+                node.result = result;
+                node.status = 'completed';
+                return result;
+            }
+            catch (error) {
+                node.error = error;
+                node.status = error instanceof CancelledError ? 'cancelled' : 'failed';
+                throw error;
+            }
+            finally {
+                view.active = false;
+                scope.abort(new CancelledError('Invocation ended.'));
+                scope.dispose();
+                await Promise.allSettled([...view.operations]);
+                node.endedAt = Date.now();
+                this.emit('end', node);
+            }
+        })();
+        this.store.pending.add(task);
+        this.operations.add(task);
+        try {
+            return await task;
+        }
+        finally {
+            this.store.pending.delete(task);
+            this.operations.delete(task);
+        }
+    }
+    emit(type, node) {
+        this.dispatch(Object.freeze({ type, invocation: snapshot(node) }));
+    }
+    dispatch(event) {
+        for (const observer of [...this.store.observers]) {
+            const report = (error) => {
+                if (this.store.observerErrors.length === 100)
+                    this.store.observerErrors.shift();
+                this.store.observerErrors.push(error);
+            };
+            try {
+                void Promise.resolve(observer(event)).catch(report);
+            }
+            catch (error) {
+                report(error);
+            }
+        }
+    }
+}
+export class Action {
+    get name() { return this.constructor.name; }
+    async invoke(session, options = {}) {
+        const owned = session === undefined;
+        const current = session ?? new Session(options);
+        try {
+            return await current.runAction(this, options);
+        }
+        finally {
+            if (owned)
+                await current.dispose();
+        }
+    }
+}
+//# sourceMappingURL=agentic.js.map

package/dist/agentic.js.map

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

package/dist/cache.d.ts

@@ -0,0 +1,32 @@
+import type { SamplingResult } from './language-model.js';
+/** Async storage contract. Implementations must return independent result snapshots. */
+export declare abstract class Cache {
+    abstract get(key: string): Promise<SamplingResult | undefined>;
+    abstract put(key: string, result: SamplingResult): Promise<void>;
+    abstract delete(key: string): Promise<void>;
+    abstract clear(): Promise<void>;
+}
+export interface InMemoryCacheOptions {
+    readonly maxEntries?: number;
+    /** Total UTF-16 code units across serialized keys and values. Default 8 MiB. */
+    readonly maxChars?: number;
+    /** Seconds from insertion; default 300. Zero disables retention. */
+    readonly ttl?: number;
+}
+export declare class InMemoryCache extends Cache {
+    private readonly entries;
+    private chars;
+    private readonly maxEntries;
+    private readonly maxChars;
+    private readonly ttl;
+    constructor(options?: InMemoryCacheOptions);
+    get size(): number;
+    get(key: string): Promise<SamplingResult | undefined>;
+    put(key: string, result: SamplingResult): Promise<void>;
+    delete(key: string): Promise<void>;
+    clear(): Promise<void>;
+    private remove;
+    private prune;
+}
+/** Tagged, sorted encoding avoids ambiguous keys and never serializes credentials from model objects. */
+export declare function canonical(value: unknown): string;

package/dist/cache.js

@@ -0,0 +1,135 @@
+import { AIMessage, ComplexMessage, Image, Message, Modality, SystemMessage, ToolMessage, UserMessage } from './message.js';
+import { ToolCall } from './tool-call.js';
+/** Async storage contract. Implementations must return independent result snapshots. */
+export class Cache {
+}
+export class InMemoryCache extends Cache {
+    entries = new Map();
+    chars = 0;
+    maxEntries;
+    maxChars;
+    ttl;
+    constructor(options = {}) {
+        super();
+        this.maxEntries = options.maxEntries ?? 1000;
+        this.maxChars = options.maxChars ?? 8_388_608;
+        this.ttl = options.ttl ?? 300;
+        for (const value of [this.maxEntries, this.maxChars])
+            if (!Number.isSafeInteger(value) || value < 1)
+                throw new RangeError('Cache limits must be positive safe integers.');
+        if (!Number.isFinite(this.ttl) || this.ttl < 0)
+            throw new RangeError('Cache ttl must be finite non-negative seconds.');
+    }
+    get size() { this.prune(); return this.entries.size; }
+    async get(key) {
+        this.prune();
+        const entry = this.entries.get(key);
+        if (!entry)
+            return undefined;
+        this.entries.delete(key);
+        this.entries.set(key, entry);
+        return decode(JSON.parse(entry.value));
+    }
+    async put(key, result) {
+        this.remove(key);
+        this.prune();
+        if (this.ttl === 0)
+            return;
+        let value;
+        try {
+            value = canonical(result);
+        }
+        catch {
+            return;
+        } // Unsupported custom metadata is not retained.
+        const size = key.length + value.length;
+        if (size > this.maxChars)
+            return;
+        this.entries.set(key, { value, expires: Date.now() + this.ttl * 1000, size });
+        this.chars += size;
+        while (this.entries.size > this.maxEntries || this.chars > this.maxChars)
+            this.remove(this.entries.keys().next().value);
+    }
+    async delete(key) { this.remove(key); }
+    async clear() { this.entries.clear(); this.chars = 0; }
+    remove(key) { const entry = this.entries.get(key); if (entry) {
+        this.chars -= entry.size;
+        this.entries.delete(key);
+    } }
+    prune() { const now = Date.now(); for (const [key, entry] of this.entries)
+        if (entry.expires <= now)
+            this.remove(key); }
+}
+/** Tagged, sorted encoding avoids ambiguous keys and never serializes credentials from model objects. */
+export function canonical(value) { return JSON.stringify(encode(value, new Set(), 0)); }
+function encode(value, seen, depth) {
+    if (depth > 64)
+        throw new TypeError('Cache data exceeds nesting limit.');
+    if (value === undefined)
+        return ['undefined'];
+    if (value === null || typeof value === 'string' || typeof value === 'boolean')
+        return ['scalar', value];
+    if (typeof value === 'number' && Number.isFinite(value))
+        return ['number', Object.is(value, -0) ? '-0' : value];
+    if (!value || typeof value !== 'object' || seen.has(value))
+        throw new TypeError('Unsupported cache data.');
+    seen.add(value);
+    const child = (v) => encode(v, seen, depth + 1);
+    try {
+        if (value instanceof Message) {
+            if (![Message, AIMessage, UserMessage, SystemMessage, ToolMessage, ComplexMessage].includes(value.constructor))
+                throw new TypeError('Custom messages bypass caching.');
+            return ['message', value.role, child(value.parts), child(value.metadata), child(value.result), child(value.source)];
+        }
+        if (value instanceof Image || value.constructor === Modality) {
+            if (value.source.kind === 'blob')
+                throw new TypeError('Blob media bypasses caching.');
+            return [value instanceof Image ? 'image' : 'modality', value.mimeType, child(value.source)];
+        }
+        if (value instanceof ToolCall)
+            return ['toolCall', value.id, value.name, child(value.args)];
+        if (value instanceof Uint8Array)
+            return ['bytes', Array.from(value)];
+        if (Array.isArray(value))
+            return ['array', Array.from(value, child)];
+        if (Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null)
+            throw new TypeError('Non-data cache value.');
+        if (Object.getOwnPropertySymbols(value).length)
+            throw new TypeError('Symbol cache keys are unsupported.');
+        return ['object', Object.keys(value).sort().map(key => {
+                const descriptor = Object.getOwnPropertyDescriptor(value, key);
+                if (!('value' in descriptor))
+                    throw new TypeError('Cache values cannot contain accessors.');
+                return [key, child(descriptor.value)];
+            })];
+    }
+    finally {
+        seen.delete(value);
+    }
+}
+// Decode only our own in-memory encoding, never external/persisted data.
+function decode(input) {
+    switch (input[0]) {
+        case 'undefined': return undefined;
+        case 'scalar': return input[1];
+        case 'number': return input[1] === '-0' ? -0 : input[1];
+        case 'array': return input[1].map(decode);
+        case 'object': return Object.fromEntries(input[1].map(([key, value]) => [key, decode(value)]));
+        case 'bytes': return new Uint8Array(input[1]);
+        case 'image': return new Image(input[1], decode(input[2]));
+        case 'modality': return new Modality(input[1], decode(input[2]));
+        case 'toolCall': return new ToolCall(input[1], input[2], decode(input[3]));
+        case 'message': {
+            const parts = decode(input[2]), metadata = decode(input[3]), result = decode(input[4]), source = decode(input[5]);
+            const options = { metadata, result, ...(source ? { source } : {}) };
+            if (input[1] === 'assistant')
+                return new AIMessage(parts, options);
+            if (input[1] === 'user')
+                return new UserMessage(parts, options);
+            if (input[1] === 'system')
+                return new SystemMessage(parts, options);
+            return new ToolMessage(parts, metadata.toolCallId, options);
+        }
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

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

package/dist/cancellation.d.ts

@@ -0,0 +1,9 @@
+export declare function checkCancelled(signal?: AbortSignal): void;
+/** A caller-owned cancellation scope; always dispose after use. */
+export declare function cancellationScope(signals: readonly (AbortSignal | undefined)[], seconds?: number): {
+    signal: AbortSignal;
+    abort: (reason?: unknown) => void;
+    dispose(): void;
+};
+/** Observe cancellation without leaving late rejections unhandled. */
+export declare function abortable<T>(work: Promise<T>, signal: AbortSignal): Promise<T>;

package/dist/cancellation.js

@@ -0,0 +1,70 @@
+import { ActionTimeoutError, CancelledError } from './errors.js';
+export function checkCancelled(signal) {
+    if (signal?.aborted) {
+        throw signal.reason instanceof CancelledError
+            ? signal.reason
+            : new CancelledError('Operation cancelled.', { cause: signal.reason });
+    }
+}
+/** A caller-owned cancellation scope; always dispose after use. */
+export function cancellationScope(signals, seconds) {
+    if (seconds !== undefined && (!Number.isFinite(seconds) || seconds < 0)) {
+        throw new RangeError('maxExecutionTime must be a finite non-negative number of seconds.');
+    }
+    const controller = new AbortController();
+    const removers = [];
+    for (const signal of signals) {
+        if (!signal)
+            continue;
+        const forward = () => controller.abort(signal.reason);
+        if (signal.aborted)
+            forward();
+        else {
+            signal.addEventListener('abort', forward, { once: true });
+            removers.push(() => signal.removeEventListener('abort', forward));
+        }
+    }
+    let timer;
+    if (seconds === 0)
+        controller.abort(new ActionTimeoutError('Execution deadline exceeded.'));
+    else if (seconds !== undefined) {
+        const deadline = Date.now() + seconds * 1000;
+        const tick = () => {
+            const remaining = deadline - Date.now();
+            if (remaining <= 0)
+                controller.abort(new ActionTimeoutError('Execution deadline exceeded.'));
+            else
+                timer = setTimeout(tick, Math.min(remaining, 2_147_483_647));
+        };
+        tick();
+    }
+    return {
+        signal: controller.signal,
+        abort: (reason) => controller.abort(reason),
+        dispose() {
+            for (const remove of removers)
+                remove();
+            if (timer !== undefined)
+                clearTimeout(timer);
+        },
+    };
+}
+/** Observe cancellation without leaving late rejections unhandled. */
+export async function abortable(work, signal) {
+    // Attach rejection handling even if the signal was already cancelled.
+    return new Promise((resolve, reject) => {
+        const onAbort = () => {
+            try {
+                checkCancelled(signal);
+            }
+            catch (error) {
+                reject(error);
+            }
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+        work.then(resolve, reject).finally(() => signal.removeEventListener('abort', onAbort));
+        if (signal.aborted)
+            onAbort();
+    });
+}
+//# sourceMappingURL=cancellation.js.map

package/dist/cancellation.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,40 @@
+/** Errors shared by the runtime and model adapters. */
+export declare class LangfxError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class TemplateError extends LangfxError {
+}
+export declare class SchemaError extends LangfxError {
+}
+export declare class LMError extends LangfxError {
+}
+export declare class LMInputError extends LMError {
+}
+export declare class UnsupportedCapabilityError extends LMError {
+}
+export declare class EmptyGenerationError extends LMError {
+}
+export declare class OutputValidationError extends LangfxError {
+}
+export declare class CancelledError extends LangfxError {
+}
+export declare class ActionTimeoutError extends CancelledError {
+}
+export declare class SessionClosedError extends LangfxError {
+}
+export declare class AuthenticationError extends LMError {
+}
+export declare class RateLimitError extends LMError {
+}
+export declare class TemporaryLMError extends LMError {
+}
+export declare class ContentFilteredError extends LMError {
+}
+export declare class IncompleteGenerationError extends LMError {
+}
+export declare class ToolExecutionError extends LangfxError {
+}
+export declare class ToolDeniedError extends LangfxError {
+}
+export declare class BudgetExceededError extends LangfxError {
+}

package/dist/errors.js

@@ -0,0 +1,44 @@
+/** Errors shared by the runtime and model adapters. */
+export class LangfxError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = new.target.name;
+    }
+}
+export class TemplateError extends LangfxError {
+}
+export class SchemaError extends LangfxError {
+}
+export class LMError extends LangfxError {
+}
+export class LMInputError extends LMError {
+}
+export class UnsupportedCapabilityError extends LMError {
+}
+export class EmptyGenerationError extends LMError {
+}
+export class OutputValidationError extends LangfxError {
+}
+export class CancelledError extends LangfxError {
+}
+export class ActionTimeoutError extends CancelledError {
+}
+export class SessionClosedError extends LangfxError {
+}
+export class AuthenticationError extends LMError {
+}
+export class RateLimitError extends LMError {
+}
+export class TemporaryLMError extends LMError {
+}
+export class ContentFilteredError extends LMError {
+}
+export class IncompleteGenerationError extends LMError {
+}
+export class ToolExecutionError extends LangfxError {
+}
+export class ToolDeniedError extends LangfxError {
+}
+export class BudgetExceededError extends LangfxError {
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC;IAC9B,CAAC;CACF;AACD,MAAM,OAAO,aAAc,SAAQ,WAAW;CAAG;AACjD,MAAM,OAAO,WAAY,SAAQ,WAAW;CAAG;AAC/C,MAAM,OAAO,OAAQ,SAAQ,WAAW;CAAG;AAC3C,MAAM,OAAO,YAAa,SAAQ,OAAO;CAAG;AAC5C,MAAM,OAAO,0BAA2B,SAAQ,OAAO;CAAG;AAC1D,MAAM,OAAO,oBAAqB,SAAQ,OAAO;CAAG;AACpD,MAAM,OAAO,qBAAsB,SAAQ,WAAW;CAAG;AACzD,MAAM,OAAO,cAAe,SAAQ,WAAW;CAAG;AAClD,MAAM,OAAO,kBAAmB,SAAQ,cAAc;CAAG;AACzD,MAAM,OAAO,kBAAmB,SAAQ,WAAW;CAAG;AACtD,MAAM,OAAO,mBAAoB,SAAQ,OAAO;CAAG;AACnD,MAAM,OAAO,cAAe,SAAQ,OAAO;CAAG;AAC9C,MAAM,OAAO,gBAAiB,SAAQ,OAAO;CAAG;AAChD,MAAM,OAAO,oBAAqB,SAAQ,OAAO;CAAG;AACpD,MAAM,OAAO,yBAA0B,SAAQ,OAAO;CAAG;AACzD,MAAM,OAAO,kBAAmB,SAAQ,WAAW;CAAG;AACtD,MAAM,OAAO,eAAgB,SAAQ,WAAW;CAAG;AACnD,MAAM,OAAO,mBAAoB,SAAQ,WAAW;CAAG"}