@agent-relay/sdk 7.1.0 → 8.0.1

package/dist/actions/types.d.ts

@@ -0,0 +1,177 @@
+import type { RelayMessaging } from '../messaging/index.js';
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type JsonSchemaLiteType = 'array' | 'boolean' | 'integer' | 'null' | 'number' | 'object' | 'string';
+export type JsonSchemaLite = boolean | JsonSchemaLiteObject;
+export interface JsonSchemaLiteObject {
+    [key: string]: unknown;
+    type?: JsonSchemaLiteType | JsonSchemaLiteType[];
+    title?: string;
+    description?: string;
+    default?: unknown;
+    const?: JsonValue;
+    enum?: JsonValue[];
+    properties?: Record<string, JsonSchemaLite>;
+    required?: string[];
+    additionalProperties?: boolean | JsonSchemaLite;
+    items?: JsonSchemaLite;
+    minItems?: number;
+    maxItems?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    minimum?: number;
+    maximum?: number;
+    anyOf?: JsonSchemaLite[];
+    oneOf?: JsonSchemaLite[];
+    allOf?: JsonSchemaLite[];
+}
+export type JsonSchema = JsonSchemaLite;
+export interface ZodLikeIssue {
+    path?: Array<string | number>;
+    message: string;
+    code?: string;
+    expected?: string;
+    received?: string;
+}
+export interface ZodLikeError {
+    issues?: ZodLikeIssue[];
+    message?: string;
+}
+export type ZodLikeParseResult<TOutput = unknown> = {
+    success: true;
+    data: TOutput;
+} | {
+    success: false;
+    error: ZodLikeError;
+};
+export interface ZodLikeSchema<TOutput = unknown> {
+    safeParse(input: unknown): ZodLikeParseResult<TOutput>;
+    description?: string;
+}
+/**
+ * Structural match for any standard-schema-style validator (e.g. a real `zod`
+ * schema) without depending on its full type. Validators are recognized at
+ * runtime by their `safeParse` method; this keeps the README's `z.object(...)`
+ * usage assignable regardless of how the output type is inferred.
+ */
+export interface SafeParseSchema {
+    safeParse(input: unknown): {
+        success: boolean;
+    };
+}
+export type ActionSchema<TOutput = unknown> = JsonSchema | ZodLikeSchema<TOutput> | SafeParseSchema;
+export interface ActionValidationIssue {
+    path: string;
+    message: string;
+    expected?: string;
+    received?: string;
+}
+export interface ActionValidationResult {
+    valid: boolean;
+    issues: ActionValidationIssue[];
+}
+export interface AgentRelayActionDescriptor {
+    name: string;
+    description: string;
+    inputSchema?: ActionSchema;
+    outputSchema?: ActionSchema;
+    visibility: 'agent' | 'human' | 'internal';
+}
+export interface ActionContext {
+    caller: {
+        name: string;
+        id?: string;
+        type?: 'agent' | 'human' | 'system';
+    };
+    workspaceId?: string;
+    messaging?: RelayMessaging;
+    emit?(event: ActionAuditEvent): Promise<void> | void;
+}
+export interface ActionPolicyDecision {
+    allowed: boolean;
+    reason?: string;
+}
+export type ActionPolicy = (input: unknown, context: ActionContext) => Promise<ActionPolicyDecision> | ActionPolicyDecision;
+export interface ActionDefinition<TInput = unknown, TOutput = unknown> {
+    name: string;
+    description?: string;
+    input?: ActionSchema<TInput>;
+    inputSchema?: ActionSchema<TInput>;
+    output?: ActionSchema<TOutput>;
+    outputSchema?: ActionSchema<TOutput>;
+    visibility?: 'agent' | 'human' | 'internal';
+    policy?: ActionPolicy;
+    handler(input: TInput, context: ActionContext): Promise<TOutput> | TOutput;
+}
+export interface InvokeActionInput {
+    name: string;
+    input: unknown;
+    context?: ActionContext;
+    caller?: ActionContext['caller'];
+    workspaceId?: string;
+    messaging?: RelayMessaging;
+    emit?(event: ActionAuditEvent): Promise<void> | void;
+}
+export interface ActionResult<TOutput = unknown> {
+    action: string;
+    ok: boolean;
+    output?: TOutput;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export type ActionAuditEvent = {
+    type: 'action.invoked';
+    action: string;
+    caller: string;
+    at: string;
+} | {
+    type: 'action.completed';
+    action: string;
+    caller: string;
+    at: string;
+} | {
+    type: 'action.failed';
+    action: string;
+    caller: string;
+    at: string;
+    error: string;
+} | {
+    type: 'action.denied';
+    action: string;
+    caller: string;
+    at: string;
+    reason?: string;
+};
+/**
+ * Registry-level action event delivered to listeners subscribed via
+ * {@link AgentRelayActions.onEvent}. Unlike {@link ActionAuditEvent} it carries
+ * the full caller and the action input/output so predicates can filter on them.
+ */
+export interface ActionListenerEvent {
+    type: 'action.invoked' | 'action.completed' | 'action.failed' | 'action.denied';
+    action: string;
+    caller: ActionContext['caller'];
+    input?: unknown;
+    output?: unknown;
+    error?: string;
+    reason?: string;
+    at: string;
+}
+export interface ActionHandle {
+    unregister(): void;
+}
+export interface AgentRelayActions {
+    register<TInput, TOutput>(definition: ActionDefinition<TInput, TOutput>): ActionHandle;
+    invoke<TOutput = unknown>(input: InvokeActionInput): Promise<ActionResult<TOutput>>;
+    list(input?: {
+        visibility?: 'agent' | 'human' | 'internal';
+    }): Promise<AgentRelayActionDescriptor[]>;
+    /** Subscribe to registry-level action events. Returns an unsubscribe function. */
+    onEvent?(handler: (event: ActionListenerEvent) => void): () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/actions/types.d.ts.map

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

package/dist/{provisioner → actions}/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/provisioner/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/actions/types.ts"],"names":[],"mappings":""}

package/dist/agent-relay.d.ts

@@ -0,0 +1,86 @@
+import { type AgentRelayActions, type ActionHandle } from './actions/index.js';
+import { type RelayMessaging, type RelaycastMessagingOptions } from './messaging/index.js';
+import { type EnrichedMessages, type RegisterActionInput, type RelayAgentClient, type RelayWorkspace } from './facade.js';
+import { type AgentHandleInput, type ActionPredicate, type EnrichedEvents, type ListenerHandler, type ListenerPredicate, type RelayAgentHandle, type RelayEvent } from './listeners.js';
+import type { AgentSessionEvent } from './session/index.js';
+export interface AgentRelayOptions extends RelaycastMessagingOptions {
+    messaging?: RelayMessaging;
+    actions?: AgentRelayActions;
+    /** Factory for agent-token-scoped messaging clients. Defaults to a Relaycast client. */
+    createAgentMessaging?: (token: string) => RelayMessaging;
+}
+export interface AgentRelayCreateWorkspaceInput {
+    name: string;
+    baseUrl?: string;
+    retryPolicy?: RelaycastMessagingOptions['retryPolicy'];
+    actions?: AgentRelayActions;
+}
+export interface AgentRelayAgent {
+    readonly messaging: RelayMessaging;
+    readonly agents: RelayMessaging['agents'];
+    readonly channels: RelayMessaging['channels'];
+    readonly messages: EnrichedMessages;
+    readonly threads: RelayMessaging['threads'];
+    readonly inbox: RelayMessaging['inbox'];
+    readonly events: RelayMessaging['events'];
+    readonly deliveries: RelayMessaging['deliveries'];
+    readonly integrations: RelayMessaging['integrations'];
+    readonly webhooks: RelayMessaging['webhooks'];
+    readonly capabilities: RelayMessaging['commands'];
+    readonly workspace: RelayWorkspace;
+    registerAction<TInput, TOutput>(def: RegisterActionInput<TInput, TOutput>): ActionHandle;
+    addListener(selector: string | ListenerPredicate, handler: ListenerHandler<RelayEvent>): () => void;
+    action(name: string): ActionPredicate;
+    agent(input: AgentHandleInput): RelayAgentHandle;
+    emitSessionEvent(agentId: string, event: AgentSessionEvent): void;
+}
+export declare class AgentRelay implements AgentRelayAgent {
+    readonly messaging: RelayMessaging;
+    private readonly actions;
+    readonly workspaceKey?: string;
+    private readonly messagingOptions;
+    private readonly clientsByToken;
+    private readonly createAgentMessaging;
+    private enrichedMessages?;
+    private workspaceFacade?;
+    private hub?;
+    constructor(options?: AgentRelayOptions);
+    static createWorkspace(input: string | AgentRelayCreateWorkspaceInput): Promise<AgentRelay>;
+    get agents(): RelayMessaging['agents'];
+    get channels(): RelayMessaging['channels'];
+    get messages(): EnrichedMessages;
+    get threads(): RelayMessaging['threads'];
+    get inbox(): RelayMessaging['inbox'];
+    get events(): EnrichedEvents;
+    private get listenerHub();
+    get deliveries(): RelayMessaging['deliveries'];
+    get integrations(): RelayMessaging['integrations'];
+    get webhooks(): RelayMessaging['webhooks'];
+    get capabilities(): RelayMessaging['commands'];
+    get workspace(): RelayWorkspace;
+    /** Build a live client bound to a freshly-registered agent. */
+    private buildAgentClient;
+    /** Rehydrate a live client from a persisted agent token, resolving identity from the relay. */
+    private reconnectAgent;
+    registerAction<TInput, TOutput>(def: RegisterActionInput<TInput, TOutput>): ActionHandle;
+    /** Subscribe by dotted event name, `'*'`/prefix wildcard, or a predicate. */
+    addListener(selector: string | ListenerPredicate, handler: ListenerHandler<RelayEvent>): () => void;
+    action(name: string): ActionPredicate;
+    agent(input: AgentHandleInput): RelayAgentHandle;
+    emitSessionEvent(agentId: string, event: AgentSessionEvent): void;
+    private messagingForToken;
+    private createMessagingResolver;
+}
+export declare function agentRelayAgent(messaging: RelayMessaging, actions: AgentRelayActions, handlerAgent?: string): AgentRelayAgent;
+/**
+ * Assemble a live agent client: an agent-scoped messaging surface plus the
+ * agent's identity and status/tool predicate builders, with `reply`/`react`
+ * convenience keyed on `messageId`.
+ */
+export declare function assembleAgentClient(messaging: RelayMessaging, actions: AgentRelayActions, identity: {
+    id: string;
+    name: string;
+    handle?: string;
+    token: string;
+}): RelayAgentClient;
+//# sourceMappingURL=agent-relay.d.ts.map

package/dist/agent-relay.d.ts.map

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

package/dist/agent-relay.js

@@ -0,0 +1,197 @@
+import { RelayCast } from '@relaycast/sdk';
+import { ActionRegistry } from './actions/index.js';
+import { RelaycastMessagingClient, } from './messaging/index.js';
+import { createEnrichedMessages, createWorkspaceFacade, registerFacadeAction, resolveAgentToken, } from './facade.js';
+import { createAgentHandle, createListenerHub, } from './listeners.js';
+export class AgentRelay {
+    messaging;
+    actions;
+    workspaceKey;
+    messagingOptions;
+    clientsByToken = new Map();
+    createAgentMessaging;
+    enrichedMessages;
+    workspaceFacade;
+    hub;
+    constructor(options = {}) {
+        const { messaging, actions, workspaceKey, createAgentMessaging, ...messagingOptions } = options;
+        const resolvedWorkspaceKey = workspaceKey ?? messagingOptions.apiKey;
+        this.workspaceKey = resolvedWorkspaceKey;
+        this.messagingOptions = { ...messagingOptions, workspaceKey: resolvedWorkspaceKey };
+        this.messaging = messaging ?? new RelaycastMessagingClient(this.messagingOptions);
+        this.actions = actions ?? new ActionRegistry();
+        this.createAgentMessaging =
+            createAgentMessaging ??
+                ((token) => new RelaycastMessagingClient({ ...this.messagingOptions, agentToken: token }));
+    }
+    static async createWorkspace(input) {
+        const options = typeof input === 'string' ? { name: input } : input;
+        const workspace = (await RelayCast.createWorkspace(options.name, {
+            baseUrl: options.baseUrl,
+        }));
+        const workspaceKey = extractWorkspaceKey(workspace);
+        if (!workspaceKey) {
+            throw new Error('Workspace created, but the response did not include a workspace key.');
+        }
+        return new AgentRelay({
+            workspaceKey,
+            baseUrl: options.baseUrl,
+            retryPolicy: options.retryPolicy,
+            actions: options.actions,
+        });
+    }
+    get agents() {
+        return this.messaging.agents;
+    }
+    get channels() {
+        return this.messaging.channels;
+    }
+    get messages() {
+        if (!this.enrichedMessages) {
+            this.enrichedMessages = createEnrichedMessages(this.messaging.messages, this.createMessagingResolver());
+        }
+        return this.enrichedMessages;
+    }
+    get threads() {
+        return this.messaging.threads;
+    }
+    get inbox() {
+        return this.messaging.inbox;
+    }
+    get events() {
+        return this.listenerHub.events;
+    }
+    get listenerHub() {
+        if (!this.hub) {
+            this.hub = createListenerHub(this.messaging.events, this.actions);
+        }
+        return this.hub;
+    }
+    get deliveries() {
+        return this.messaging.deliveries;
+    }
+    get integrations() {
+        return this.messaging.integrations;
+    }
+    get webhooks() {
+        return this.messaging.webhooks;
+    }
+    get capabilities() {
+        return this.messaging.commands;
+    }
+    get workspace() {
+        if (!this.workspaceFacade) {
+            this.workspaceFacade = createWorkspaceFacade(this.messaging, {
+                buildAgentClient: (registration) => this.buildAgentClient(registration),
+                reconnectAgent: (apiToken) => this.reconnectAgent(apiToken),
+            });
+        }
+        return this.workspaceFacade;
+    }
+    /** Build a live client bound to a freshly-registered agent. */
+    buildAgentClient(registration) {
+        return assembleAgentClient(this.messagingForToken(registration.token), this.actions, {
+            id: registration.id,
+            name: registration.name,
+            token: registration.token,
+        });
+    }
+    /** Rehydrate a live client from a persisted agent token, resolving identity from the relay. */
+    async reconnectAgent(apiToken) {
+        const messaging = this.messagingForToken(apiToken);
+        const identity = await messaging.agents.me();
+        return assembleAgentClient(messaging, this.actions, {
+            id: identity.id,
+            name: identity.name,
+            token: apiToken,
+        });
+    }
+    registerAction(def) {
+        // The workspace-scoped client has no single handler-agent identity or
+        // agent connection, so relay wiring is skipped and the action stays
+        // in-process. Use an agent client (workspace.register / reconnect) to
+        // register a relay-routed action.
+        return registerFacadeAction(this.actions, def, { messaging: this.messaging });
+    }
+    /** Subscribe by dotted event name, `'*'`/prefix wildcard, or a predicate. */
+    addListener(selector, handler) {
+        return this.listenerHub.addListener(selector, handler);
+    }
+    action(name) {
+        return this.listenerHub.action(name);
+    }
+    agent(input) {
+        return this.listenerHub.agent(input);
+    }
+    emitSessionEvent(agentId, event) {
+        this.listenerHub.emitSessionEvent(agentId, event);
+    }
+    messagingForToken(token) {
+        let client = this.clientsByToken.get(token);
+        if (!client) {
+            client = this.createAgentMessaging(token);
+            this.clientsByToken.set(token, client);
+        }
+        return client;
+    }
+    createMessagingResolver() {
+        return (from) => {
+            const token = resolveAgentToken(from);
+            return token ? this.messagingForToken(token).messages : this.messaging.messages;
+        };
+    }
+}
+function extractWorkspaceKey(payload) {
+    const data = payload.data && typeof payload.data === 'object' ? payload.data : {};
+    const value = payload.workspaceKey ??
+        payload.workspace_key ??
+        payload.apiKey ??
+        payload.api_key ??
+        data.workspaceKey ??
+        data.workspace_key ??
+        data.apiKey ??
+        data.api_key;
+    return typeof value === 'string' && value.trim() ? value : undefined;
+}
+export function agentRelayAgent(messaging, actions, handlerAgent) {
+    // An acting-as agent client sends through its own token; `from` overrides are
+    // best-effort and fall back to this client.
+    const messages = createEnrichedMessages(messaging.messages, () => messaging.messages);
+    const hub = createListenerHub(messaging.events, actions);
+    return {
+        messaging,
+        agents: messaging.agents,
+        channels: messaging.channels,
+        messages,
+        threads: messaging.threads,
+        inbox: messaging.inbox,
+        events: hub.events,
+        deliveries: messaging.deliveries,
+        integrations: messaging.integrations,
+        webhooks: messaging.webhooks,
+        capabilities: messaging.commands,
+        workspace: createWorkspaceFacade(messaging),
+        registerAction: (def) => registerFacadeAction(actions, def, { messaging, handlerAgent }),
+        addListener: (selector, handler) => hub.addListener(selector, handler),
+        action: (name) => hub.action(name),
+        agent: (input) => hub.agent(input),
+        emitSessionEvent: (agentId, event) => hub.emitSessionEvent(agentId, event),
+    };
+}
+/**
+ * Assemble a live agent client: an agent-scoped messaging surface plus the
+ * agent's identity and status/tool predicate builders, with `reply`/`react`
+ * convenience keyed on `messageId`.
+ */
+export function assembleAgentClient(messaging, actions, identity) {
+    const base = agentRelayAgent(messaging, actions, identity.name);
+    const handle = createAgentHandle(identity);
+    return {
+        ...base,
+        ...handle,
+        sendMessage: (input) => base.messages.send(input),
+        reply: (input) => base.messages.reply(input),
+        react: (input) => base.messages.react(input.messageId, input.emoji),
+    };
+}
+//# sourceMappingURL=agent-relay.js.map

package/dist/agent-relay.js.map

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

package/dist/capabilities.d.ts

@@ -0,0 +1,6 @@
+export declare class RelayCapabilityError extends Error {
+    readonly capability: string;
+    constructor(capability: string, message?: string);
+}
+export type Unsubscribe = () => void;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAKjD;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC"}

package/dist/capabilities.js

@@ -0,0 +1,9 @@
+export class RelayCapabilityError extends Error {
+    capability;
+    constructor(capability, message) {
+        super(message ?? `Agent Relay capability is not available: ${capability}`);
+        this.name = 'RelayCapabilityError';
+        this.capability = capability;
+    }
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACpC,UAAU,CAAS;IAE5B,YAAY,UAAkB,EAAE,OAAgB;QAC9C,KAAK,CAAC,OAAO,IAAI,4CAA4C,UAAU,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF"}

package/dist/delivery/index.d.ts

@@ -0,0 +1,4 @@
+export { RelayCapabilityError } from '../capabilities.js';
+export * from './types.js';
+export * from './runner.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/delivery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/delivery/index.js

@@ -0,0 +1,4 @@
+export { RelayCapabilityError } from '../capabilities.js';
+export * from './types.js';
+export * from './runner.js';
+//# sourceMappingURL=index.js.map

package/dist/delivery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/delivery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/delivery/runner.d.ts

@@ -0,0 +1,26 @@
+import type { InboxItem, RelayMessaging } from '../messaging/index.js';
+import type { InjectionContext, InjectionResult, MessageDeliveryTarget } from './types.js';
+import type { MessageContext } from '../session/index.js';
+export type DeliveryRunnerContext = Partial<Omit<InjectionContext, 'reason' | 'mode'> & Omit<MessageContext, 'reason' | 'mode'>> & {
+    reason?: InjectionContext['reason'] | MessageContext['reason'];
+    mode?: InjectionContext['mode'] | MessageContext['mode'];
+};
+export interface DeliveryRunnerOptions {
+    messaging: RelayMessaging;
+    delivery: MessageDeliveryTarget;
+    agentName?: string;
+    context?: DeliveryRunnerContext;
+    onResult?: (item: InboxItem, result: InjectionResult) => void | Promise<void>;
+    onError?: (item: InboxItem, error: unknown) => void | Promise<void>;
+}
+export declare class DeliveryRunner {
+    private readonly options;
+    private stopped;
+    private running?;
+    constructor(options: DeliveryRunnerOptions);
+    start(): Promise<void>;
+    stop(): void;
+    private run;
+    private deliver;
+}
+//# sourceMappingURL=runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/delivery/runner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAEV,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACtB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,qBAAqB,CAAC;AAE1E,MAAM,MAAM,qBAAqB,GAAG,OAAO,CACzC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,MAAM,CAAC,CACpF,GAAG;IACF,MAAM,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC/D,IAAI,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;CAC1D,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,cAAc,CAAC;IAC1B,QAAQ,EAAE,qBAAqB,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrE;AAED,qBAAa,cAAc;IAIb,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAC,CAAgB;gBAEH,OAAO,EAAE,qBAAqB;IAE3D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAWtB,IAAI,IAAI,IAAI;YAIE,GAAG;YAcH,OAAO;CAoCtB"}