@msg91comm/m91 0.0.0-stage → 1.1.0

package/dist/src/integrations/specs.d.ts

@@ -0,0 +1,131 @@
+/**
+ * The tool definitions, written once and adapted per framework.
+ *
+ * A tool's name, its description and its argument docs are the entire interface
+ * a model has to M91 — they are the prompt. Four adapters each spelling their
+ * own copy is four descriptions that drift, and the drift is invisible until an
+ * agent on one framework behaves differently from the same agent on another.
+ *
+ * Every adapter therefore imports the schema and the `run` from here and does
+ * nothing but wrap it in the shape its framework expects.
+ */
+import type { M91Client } from '../client.js';
+import type { AlertResponse, Severity } from '../models.js';
+export declare const APPROVED = "approved";
+export declare const REJECTED = "rejected";
+/**
+ * `error: …` — never `approved`, whatever went wrong.
+ *
+ * The message is redacted: an M91 error can carry the URL it failed on, and
+ * that URL has the send token in its path. A tool result goes straight into a
+ * model's context and from there into logs, traces and evals.
+ */
+export declare function errorResult(error: unknown): string;
+/**
+ * `sent:delivered=N` — plus a word when nobody was actually reached.
+ *
+ * A model that reads "sent" and stops has no way to know the channel's phones
+ * were all stale. Saying so in the result is the only channel back to it.
+ */
+export declare function alertResult(alert: AlertResponse): string;
+/** JSON Schema rather than zod, so nothing here needs a dependency to exist. */
+export declare const APPROVAL_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly title: {
+            readonly type: "string";
+            readonly description: string;
+        };
+        readonly customId: {
+            readonly type: "string";
+            readonly description: string;
+        };
+        readonly description: {
+            readonly type: "string";
+            readonly description: string;
+        };
+        readonly severity: {
+            readonly type: "string";
+            readonly enum: readonly ["LOW", "MEDIUM", "HIGH", "CRITICAL"];
+            readonly description: "LOW, MEDIUM, HIGH or CRITICAL. All of them ring through Do Not Disturb; HIGH and CRITICAL also place a voice call after 45 seconds of silence. An approval that blocks you is normally HIGH.";
+        };
+        readonly approveLabel: {
+            readonly type: "string";
+            readonly description: "The yes button, 24 characters or fewer.";
+        };
+        readonly rejectLabel: {
+            readonly type: "string";
+            readonly description: "The no button, 24 characters or fewer.";
+        };
+        readonly timeoutSeconds: {
+            readonly type: "number";
+            readonly description: "How long to wait for an answer before giving up. Default 300.";
+        };
+    };
+    readonly required: readonly ["title", "customId"];
+    readonly additionalProperties: false;
+};
+export declare const ALERT_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly title: {
+            readonly type: "string";
+            readonly description: "What happened, in one line somebody can act on. 5-2000 characters.";
+        };
+        readonly customId: {
+            readonly type: "string";
+            readonly description: string;
+        };
+        readonly description: {
+            readonly type: "string";
+            readonly description: "Any detail that helps them act.";
+        };
+        readonly severity: {
+            readonly type: "string";
+            readonly enum: readonly ["LOW", "MEDIUM", "HIGH", "CRITICAL"];
+            readonly description: string;
+        };
+    };
+    readonly required: readonly ["title"];
+    readonly additionalProperties: false;
+};
+export declare const APPROVAL_TOOL_NAME = "m91_request_approval";
+export declare const ALERT_TOOL_NAME = "m91_send_alert";
+export declare const APPROVAL_DESCRIPTION: string;
+export declare const ALERT_DESCRIPTION: string;
+export interface ApprovalArgs {
+    title: string;
+    customId: string;
+    description?: string;
+    severity?: Severity;
+    approveLabel?: string;
+    rejectLabel?: string;
+    timeoutSeconds?: number;
+}
+export interface AlertArgs {
+    title: string;
+    customId?: string;
+    description?: string;
+    severity?: Severity;
+}
+/**
+ * What a deployment wants when the model does not say.
+ *
+ * Set these where the tool is built, not in the prompt. How long a person has
+ * to wake up, and what the buttons say, are operations decisions — a model
+ * choosing its own timeout is a model deciding how long somebody has to answer.
+ * It can still override per call when it has a reason.
+ */
+export interface ApprovalDefaults {
+    severity?: Severity;
+    approveLabel?: string;
+    rejectLabel?: string;
+    timeoutSeconds?: number;
+}
+export interface AlertDefaults {
+    severity?: Severity;
+}
+/** Ask, wait, and answer in a word a model cannot misread. */
+export declare function runApproval(client: M91Client, args: ApprovalArgs, defaults?: ApprovalDefaults): Promise<string>;
+export declare function runAlert(client: M91Client, args: AlertArgs, defaults?: AlertDefaults): Promise<string>;
+//# sourceMappingURL=specs.d.ts.map

package/dist/src/integrations/specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specs.d.ts","sourceRoot":"","sources":["../../../src/integrations/specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE5D,eAAO,MAAM,QAAQ,aAAa,CAAC;AACnC,eAAO,MAAM,QAAQ,aAAa,CAAC;AAEnC;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIlD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAexD;AAWD,gFAAgF;AAChF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BlB,CAAC;AAEX,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;CAkBf,CAAC;AAEX,eAAO,MAAM,kBAAkB,yBAAyB,CAAC;AACzD,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAEhD,eAAO,MAAM,oBAAoB,QASW,CAAC;AAE7C,eAAO,MAAM,iBAAiB,QAQmD,CAAC;AAElF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,8DAA8D;AAC9D,wBAAsB,WAAW,CAC/B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,YAAY,EAClB,QAAQ,GAAE,gBAAqB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAkBjB;AAED,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,SAAS,EACf,QAAQ,GAAE,aAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAejB"}

package/dist/src/integrations/specs.js

@@ -0,0 +1,156 @@
+/**
+ * The tool definitions, written once and adapted per framework.
+ *
+ * A tool's name, its description and its argument docs are the entire interface
+ * a model has to M91 — they are the prompt. Four adapters each spelling their
+ * own copy is four descriptions that drift, and the drift is invisible until an
+ * agent on one framework behaves differently from the same agent on another.
+ *
+ * Every adapter therefore imports the schema and the `run` from here and does
+ * nothing but wrap it in the shape its framework expects.
+ */
+import { M91Error } from '../exceptions.js';
+import { redact } from '../http.js';
+export const APPROVED = 'approved';
+export const REJECTED = 'rejected';
+/**
+ * `error: …` — never `approved`, whatever went wrong.
+ *
+ * The message is redacted: an M91 error can carry the URL it failed on, and
+ * that URL has the send token in its path. A tool result goes straight into a
+ * model's context and from there into logs, traces and evals.
+ */
+export function errorResult(error) {
+    if (error instanceof M91Error)
+        return `error: [${error.code}] ${redact(error.message)}`;
+    const message = error instanceof Error ? error.message : String(error);
+    return `error: ${redact(message) || 'unknown failure'}`;
+}
+/**
+ * `sent:delivered=N` — plus a word when nobody was actually reached.
+ *
+ * A model that reads "sent" and stops has no way to know the channel's phones
+ * were all stale. Saying so in the result is the only channel back to it.
+ */
+export function alertResult(alert) {
+    if (alert.deduplicated) {
+        return ('sent:delivered=0 (an alert with this customId is already open and already ringing — ' +
+            'nobody was disturbed a second time)');
+    }
+    if (alert.delivered === 0) {
+        return (`sent:delivered=0 WARNING: the alert was filed but no phone could be reached ` +
+            `(unregistered=${alert.unregistered.length}, noDevice=${alert.noDevice}, ` +
+            `pending=${alert.pending}). Nobody has been woken.`);
+    }
+    return `sent:delivered=${alert.delivered}`;
+}
+const SEVERITY_DOC = 'LOW, MEDIUM, HIGH or CRITICAL. All of them ring through Do Not Disturb; HIGH and ' +
+    'CRITICAL also place a voice call after 45 seconds of silence.';
+const CUSTOM_ID_DOC = 'A stable id for this exact request, derived from what is being decided ' +
+    "('refund-ORD-40122'). NEVER a timestamp, a UUID or a counter: the id is what " +
+    'deduplicates a retry and what closes the alert afterwards.';
+/** JSON Schema rather than zod, so nothing here needs a dependency to exist. */
+export const APPROVAL_SCHEMA = {
+    type: 'object',
+    properties: {
+        title: {
+            type: 'string',
+            description: 'The question, as the person reads it at 3am on a lock screen. Name the action ' +
+                "and its consequence: 'Refund 48,000 on ORD-40122?' — not 'approve action'. " +
+                '5-2000 characters.',
+        },
+        customId: { type: 'string', description: CUSTOM_ID_DOC },
+        description: {
+            type: 'string',
+            description: 'The context the person needs to answer without asking you anything back: what ' +
+                'you found, what you are about to do, and what happens if they say no.',
+        },
+        severity: {
+            type: 'string',
+            enum: ['LOW', 'MEDIUM', 'HIGH', 'CRITICAL'],
+            description: `${SEVERITY_DOC} An approval that blocks you is normally HIGH.`,
+        },
+        approveLabel: { type: 'string', description: 'The yes button, 24 characters or fewer.' },
+        rejectLabel: { type: 'string', description: 'The no button, 24 characters or fewer.' },
+        timeoutSeconds: {
+            type: 'number',
+            description: 'How long to wait for an answer before giving up. Default 300.',
+        },
+    },
+    required: ['title', 'customId'],
+    additionalProperties: false,
+};
+export const ALERT_SCHEMA = {
+    type: 'object',
+    properties: {
+        title: {
+            type: 'string',
+            description: 'What happened, in one line somebody can act on. 5-2000 characters.',
+        },
+        customId: {
+            type: 'string',
+            description: "A stable id for the CONDITION, not this occurrence — 'disk-full-node7'. Repeats " +
+                'while it is still open wake nobody a second time. Never a timestamp.',
+        },
+        description: { type: 'string', description: 'Any detail that helps them act.' },
+        severity: { type: 'string', enum: ['LOW', 'MEDIUM', 'HIGH', 'CRITICAL'], description: SEVERITY_DOC },
+    },
+    required: ['title'],
+    additionalProperties: false,
+};
+export const APPROVAL_TOOL_NAME = 'm91_request_approval';
+export const ALERT_TOOL_NAME = 'm91_send_alert';
+export const APPROVAL_DESCRIPTION = 'Ask a human for permission and wait for their answer. Use this BEFORE any ' +
+    'irreversible or consequential action: payments, refunds, deletions, deployments, ' +
+    "sending messages on someone's behalf, changing production data, or anything you " +
+    'would want a colleague to sign off on. ' +
+    'The person is woken on their phone immediately at full volume, through silent mode ' +
+    'and Do Not Disturb, and called if they do not answer within 45 seconds. ' +
+    'This call BLOCKS until they respond or the timeout passes. ' +
+    "Returns 'approved' or 'rejected'. Treat anything that is not exactly 'approved' as " +
+    'a refusal and do not perform the action.';
+export const ALERT_DESCRIPTION = 'Wake a human immediately about something that has already happened, without waiting ' +
+    'for a reply. Use for failures, anomalies, breaches, and long jobs finishing that ' +
+    'somebody is waiting on. ' +
+    'The alert rings every phone on the on-call channel at full volume through silent ' +
+    'mode and Do Not Disturb, and keeps ringing until somebody answers. ' +
+    'Do NOT use this to ask permission — use m91_request_approval, which waits. ' +
+    'Do NOT use it for anything that could wait until morning; this wakes people up. ' +
+    "Returns 'sent:delivered=N', where N is how many phones were actually reached.";
+/** Ask, wait, and answer in a word a model cannot misread. */
+export async function runApproval(client, args, defaults = {}) {
+    try {
+        const approved = await client.requestApproval(args.title, {
+            customId: args.customId,
+            description: args.description,
+            severity: args.severity ?? defaults.severity ?? 'HIGH',
+            approveLabel: args.approveLabel ?? defaults.approveLabel ?? 'Approve',
+            rejectLabel: args.rejectLabel ?? defaults.rejectLabel ?? 'Reject',
+            // `??`, not `||`: an explicit 0 means "do not wait", and `||` would turn
+            // that into five minutes.
+            timeoutMs: (args.timeoutSeconds ?? defaults.timeoutSeconds ?? 300) * 1000,
+        });
+        return approved ? APPROVED : REJECTED;
+    }
+    catch (error) {
+        // Returned, not thrown: a thrown tool error ends the agent run, and an
+        // agent that cannot ask permission should be able to say so and stop.
+        return errorResult(error);
+    }
+}
+export async function runAlert(client, args, defaults = {}) {
+    try {
+        return alertResult(await client.send(args.title, {
+            description: args.description,
+            severity: args.severity ?? defaults.severity ?? 'MEDIUM',
+            customId: args.customId,
+        }));
+    }
+    catch (error) {
+        // Includes M91DeliveryError, whose message already says nobody's phone
+        // rang. A model reading "error:" and retrying is right there; a model
+        // reading "sent" and stopping is not.
+        return errorResult(error);
+    }
+}
+//# sourceMappingURL=specs.js.map

package/dist/src/integrations/specs.js.map

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

package/dist/src/integrations/vercel-ai.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Vercel AI SDK tools.
+ *
+ * ```ts
+ * import { M91Client } from '@msg91comm/m91';
+ * import { createM91ApprovalTool, createM91AlertTool } from '@msg91comm/m91/integrations/vercel-ai';
+ *
+ * const client = new M91Client(process.env.M91_SEND_LINK!);
+ *
+ * const { text } = await generateText({
+ *   model: openai('gpt-4o'),
+ *   tools: {
+ *     m91_request_approval: await createM91ApprovalTool(client),
+ *     m91_send_alert: await createM91AlertTool(client),
+ *   },
+ *   maxSteps: 10,
+ *   prompt: 'Look into order ORD-40122 and refund it if it checks out.',
+ * });
+ * ```
+ *
+ * The factories are **async** because `ai` is an optional peer dependency,
+ * imported only when one of these is called — `npm install @msg91comm/m91` stays at zero
+ * dependencies.
+ */
+import type { M91Client } from '../client.js';
+import { type AlertDefaults, type ApprovalDefaults } from './specs.js';
+/**
+ * The blocking approval gate. Returns `"approved"`, `"rejected"` or
+ * `"error: …"`, and nothing but a real human approval returns `"approved"`.
+ */
+export declare function createM91ApprovalTool(client: M91Client, defaults?: ApprovalDefaults): Promise<unknown>;
+/** The fire-and-forget alert. Returns `"sent:delivered=N"` or `"error: …"`. */
+export declare function createM91AlertTool(client: M91Client, defaults?: AlertDefaults): Promise<unknown>;
+/** Both, keyed by tool name, ready to spread into `tools: {…}`. */
+export declare function createM91Tools(client: M91Client, defaults?: ApprovalDefaults & AlertDefaults): Promise<Record<string, unknown>>;
+//# sourceMappingURL=vercel-ai.d.ts.map

package/dist/src/integrations/vercel-ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel-ai.d.ts","sourceRoot":"","sources":["../../../src/integrations/vercel-ai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAML,KAAK,aAAa,EAElB,KAAK,gBAAgB,EAGtB,MAAM,YAAY,CAAC;AAqBpB;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,gBAAqB,GAC9B,OAAO,CAAC,OAAO,CAAC,CASlB;AAED,+EAA+E;AAC/E,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,aAAkB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED,mEAAmE;AACnE,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,gBAAgB,GAAG,aAAkB,GAC9C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAKlC"}

package/dist/src/integrations/vercel-ai.js

@@ -0,0 +1,67 @@
+/**
+ * Vercel AI SDK tools.
+ *
+ * ```ts
+ * import { M91Client } from '@msg91comm/m91';
+ * import { createM91ApprovalTool, createM91AlertTool } from '@msg91comm/m91/integrations/vercel-ai';
+ *
+ * const client = new M91Client(process.env.M91_SEND_LINK!);
+ *
+ * const { text } = await generateText({
+ *   model: openai('gpt-4o'),
+ *   tools: {
+ *     m91_request_approval: await createM91ApprovalTool(client),
+ *     m91_send_alert: await createM91AlertTool(client),
+ *   },
+ *   maxSteps: 10,
+ *   prompt: 'Look into order ORD-40122 and refund it if it checks out.',
+ * });
+ * ```
+ *
+ * The factories are **async** because `ai` is an optional peer dependency,
+ * imported only when one of these is called — `npm install @msg91comm/m91` stays at zero
+ * dependencies.
+ */
+import { ALERT_DESCRIPTION, ALERT_SCHEMA, APPROVAL_DESCRIPTION, APPROVAL_SCHEMA, runAlert, runApproval, } from './specs.js';
+async function aiModule() {
+    try {
+        // A variable specifier: an optional peer dependency must not be a build
+        // requirement for this package.
+        const specifier = 'ai';
+        return (await import(specifier));
+    }
+    catch (error) {
+        throw new Error('The Vercel AI SDK integration needs the `ai` package. Install it with: npm install ai', { cause: error });
+    }
+}
+/**
+ * The blocking approval gate. Returns `"approved"`, `"rejected"` or
+ * `"error: …"`, and nothing but a real human approval returns `"approved"`.
+ */
+export async function createM91ApprovalTool(client, defaults = {}) {
+    const { tool, jsonSchema } = await aiModule();
+    return tool({
+        description: APPROVAL_DESCRIPTION,
+        // JSON Schema rather than zod, so this adapter adds no dependency of its own
+        // and the argument docs stay in one file shared with every other framework.
+        inputSchema: jsonSchema(APPROVAL_SCHEMA),
+        execute: (args) => runApproval(client, args, defaults),
+    });
+}
+/** The fire-and-forget alert. Returns `"sent:delivered=N"` or `"error: …"`. */
+export async function createM91AlertTool(client, defaults = {}) {
+    const { tool, jsonSchema } = await aiModule();
+    return tool({
+        description: ALERT_DESCRIPTION,
+        inputSchema: jsonSchema(ALERT_SCHEMA),
+        execute: (args) => runAlert(client, args, defaults),
+    });
+}
+/** Both, keyed by tool name, ready to spread into `tools: {…}`. */
+export async function createM91Tools(client, defaults = {}) {
+    return {
+        m91_request_approval: await createM91ApprovalTool(client, defaults),
+        m91_send_alert: await createM91AlertTool(client, defaults),
+    };
+}
+//# sourceMappingURL=vercel-ai.js.map

package/dist/src/integrations/vercel-ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel-ai.js","sourceRoot":"","sources":["../../../src/integrations/vercel-ai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,eAAe,EAKf,QAAQ,EACR,WAAW,GACZ,MAAM,YAAY,CAAC;AAOpB,KAAK,UAAU,QAAQ;IACrB,IAAI,CAAC;QACH,wEAAwE;QACxE,gCAAgC;QAChC,MAAM,SAAS,GAAG,IAAI,CAAC;QACvB,OAAO,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAwB,CAAC;IAC1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,uFAAuF,EACvF,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAiB,EACjB,WAA6B,EAAE;IAE/B,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,QAAQ,EAAE,CAAC;IAC9C,OAAO,IAAI,CAAC;QACV,WAAW,EAAE,oBAAoB;QACjC,6EAA6E;QAC7E,4EAA4E;QAC5E,WAAW,EAAE,UAAU,CAAC,eAAe,CAAC;QACxC,OAAO,EAAE,CAAC,IAAkB,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC;KACrE,CAAC,CAAC;AACL,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAiB,EACjB,WAA0B,EAAE;IAE5B,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,QAAQ,EAAE,CAAC;IAC9C,OAAO,IAAI,CAAC;QACV,WAAW,EAAE,iBAAiB;QAC9B,WAAW,EAAE,UAAU,CAAC,YAAY,CAAC;QACrC,OAAO,EAAE,CAAC,IAAe,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC;KAC/D,CAAC,CAAC;AACL,CAAC;AAED,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAiB,EACjB,WAA6C,EAAE;IAE/C,OAAO;QACL,oBAAoB,EAAE,MAAM,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC;QACnE,cAAc,EAAE,MAAM,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC;KAC3D,CAAC;AACJ,CAAC"}