@meetopenbot/plugin-sdk 0.2.0 → 0.4.0

package/dist/helpers.d.ts

@@ -1,5 +1,6 @@
-import type { AgentInvokeEvent, AgentOutputEvent, EventMeta, ToolResultEvent, UIWidgetEvent, WebhookEvent, WebhookHttpResponseEvent } from "./events.js";
-import type { RenderUIWidgetData, UIWidgetBase } from "./ui.js";
+import type { AgentInvokeEvent, AgentOutputEvent, EventMeta, OpenBotState, ToolResultEvent, UIWidgetEvent, UIWidgetResponseEvent, WebhookEvent, WebhookHttpResponseEvent } from "./events.js";
+import type { Storage } from "./storage.js";
+import type { RenderUIWidgetData, UIWidgetBase, UIWidgetField } from "./ui.js";
 /** Return true when this agent should handle an `agent:invoke` event. */
 export declare function shouldHandleInvoke(event: AgentInvokeEvent, agentId: string): boolean;
 /** Build an `agent:output` event. */
@@ -46,4 +47,91 @@ export declare function webhookHttpResponse(args: {
     body?: unknown;
     headers?: Record<string, string>;
 }): WebhookHttpResponseEvent;
+export declare const API_KEY_REQUEST_TYPE = "api_key_request";
+export declare function apiKeyRequestWidget(args: {
+    agentId: string;
+    threadId?: string;
+    source: string;
+    envVar: string;
+    label: string;
+    placeholder?: string;
+    reason?: string;
+    provider?: string;
+    docsUrl?: string;
+    description?: string;
+    extraFields?: UIWidgetField[];
+}): ReturnType<typeof uiWidget>;
+export type PersistApiKeyFailure = {
+    handled: true;
+    ok: false;
+    error: string;
+};
+export type PersistApiKeySuccess = {
+    handled: true;
+    ok: true;
+    envVar: string;
+    apiKey: string;
+    widgetId?: string;
+    provider?: string;
+};
+export type PersistApiKeyResult = {
+    handled: false;
+} | PersistApiKeyFailure | PersistApiKeySuccess;
+export declare function isPersistApiKeyFailure(result: PersistApiKeyResult): result is PersistApiKeyFailure;
+export declare function isPersistApiKeySuccess(result: PersistApiKeyResult): result is PersistApiKeySuccess;
+/** Persist a secret from an `api_key_request` widget response. */
+export declare function persistApiKeyFromWidgetResponse(args: {
+    event: UIWidgetResponseEvent;
+    storage?: Storage;
+    source: string;
+    fallbackEnvVar: string;
+    env?: Record<string, string | undefined>;
+    extraEnvVars?: string[];
+}): Promise<PersistApiKeyResult>;
+export declare function apiKeySavedEvents(args: {
+    agentId: string;
+    threadId?: string;
+    envVar: string;
+    widgetId?: string;
+    retryMessage?: string;
+}): Array<ReturnType<typeof uiWidget> | ReturnType<typeof agentOutput>>;
+/** Trim a string value; empty strings become `undefined`. */
+export declare function trimmedString(value: unknown): string | undefined;
+/** Config `model` value, or `fallback` when unset. */
+export declare function readConfigModel(config: Record<string, unknown>, fallback: string): string;
+/** Strip a `provider/` prefix (`openai/gpt-4o-mini` → `gpt-4o-mini`). */
+export declare function vendorModelId(model: string | undefined): string | undefined;
+export type StorageVariableValue = string | {
+    value: string;
+    secret: boolean;
+} | undefined;
+/**
+ * First non-empty value from `process.env`.
+ * The runtime merges workspace variables into the process env on boot and
+ * after every create/delete — plugins should not read `storage.getVariables()`.
+ */
+export declare function lookupSecret(args: {
+    envKeys: string[];
+}): string | undefined;
+/** User-facing copy when a required workspace variable is missing. */
+export declare function missingSecretMessage(envKey: string): string;
+export type ThreadSession = {
+    read: (state: OpenBotState) => string | undefined;
+    write: (state: OpenBotState, storage: Storage | undefined, value: string) => Promise<void>;
+};
+/** Read/write a single string field on thread (or channel) persisted state. */
+export declare function threadSession(field: string): ThreadSession;
+/** Persist a small patch onto the current thread, or the channel if there is no thread. */
+export declare function patchPersistedState(args: {
+    storage?: Storage;
+    state: OpenBotState;
+    patch: Record<string, unknown>;
+}): Promise<void>;
+/** Thread state if present, otherwise channel state. */
+export declare function persistedStateRecord(state: OpenBotState): Record<string, unknown>;
+/**
+ * Bridge a callback-style agent loop onto an async generator.
+ * Used by specialist plugins that enqueue widgets from `generateText` hooks.
+ */
+export declare function yieldFromBackgroundQueue<T>(run: (enqueue: (item: T) => void) => Promise<void>): AsyncGenerator<T>;
 //# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,aAAa,EACb,YAAY,EACZ,wBAAwB,EACzB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEhE,yEAAyE;AACzE,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,MAAM,GACd,OAAO,CAGT;AAED,qCAAqC;AACrC,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB,GAAG,gBAAgB,CAUnB;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,KAAK,EAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,EAC7B,IAAI,EAAE,KAAK,GACV,eAAe,CAAC,KAAK,CAAC,CAMxB;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;CAC/B,GAAG,kBAAkB,CAUrB;AAED,wCAAwC;AACxC,wBAAgB,QAAQ,CAAC,IAAI,EAAE;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB,GAAG,aAAa,CAUhB;AAED,oEAAoE;AACpE,wBAAgB,QAAQ,CAAC,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,EACrD,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,EAC5B,KAAK,EAAE,CAAC,GACP,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,CAS1B;AAED,0DAA0D;AAC1D,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAEhE;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAKpB;AAED,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,GAAG,wBAAwB,CAK3B"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,YAAY,EACZ,wBAAwB,EACzB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE/E,yEAAyE;AACzE,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,MAAM,GACd,OAAO,CAGT;AAED,qCAAqC;AACrC,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB,GAAG,gBAAgB,CAUnB;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,KAAK,EAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,EAC7B,IAAI,EAAE,KAAK,GACV,eAAe,CAAC,KAAK,CAAC,CAMxB;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;CAC/B,GAAG,kBAAkB,CAUrB;AAED,wCAAwC;AACxC,wBAAgB,QAAQ,CAAC,IAAI,EAAE;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB,GAAG,aAAa,CAUhB;AAED,oEAAoE;AACpE,wBAAgB,QAAQ,CAAC,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,EACrD,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,EAC5B,KAAK,EAAE,CAAC,GACP,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,CAS1B;AAED,0DAA0D;AAC1D,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAEhE;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAKpB;AAED,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,GAAG,wBAAwB,CAK3B;AAED,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AAEtD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,aAAa,EAAE,CAAC;CAC/B,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAmC9B;AAED,MAAM,MAAM,oBAAoB,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAC/E,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,IAAI,CAAC;IACd,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AACF,MAAM,MAAM,mBAAmB,GAAG;IAAE,OAAO,EAAE,KAAK,CAAA;CAAE,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;AAEnG,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,mBAAmB,GAC1B,MAAM,IAAI,oBAAoB,CAEhC;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,mBAAmB,GAC1B,MAAM,IAAI,oBAAoB,CAEhC;AAED,kEAAkE;AAClE,wBAAsB,+BAA+B,CAAC,IAAI,EAAE;IAC1D,KAAK,EAAE,qBAAqB,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA+B/B;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,KAAK,CAAC,UAAU,CAAC,OAAO,QAAQ,CAAC,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAqBtE;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAEhE;AAED,sDAAsD;AACtD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAG3E;AAED,MAAM,MAAM,oBAAoB,GAC5B,MAAM,GACN;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAClC,SAAS,CAAC;AAEd;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAM5E;AAED,sEAAsE;AACtE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,MAAM,GAAG,SAAS,CAAC;IAClD,KAAK,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5F,CAAC;AAEF,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAS1D;AAED,2FAA2F;AAC3F,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CAchB;AAED,wDAAwD;AACxD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,YAAY,GAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB;AAED;;;GAGG;AACH,wBAAuB,wBAAwB,CAAC,CAAC,EAC/C,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,GACjD,cAAc,CAAC,CAAC,CAAC,CAgCnB"}

package/dist/helpers.js

@@ -78,4 +78,199 @@ export function webhookHttpResponse(args) {
         data: args,
     };
 }
+export const API_KEY_REQUEST_TYPE = "api_key_request";
+export function apiKeyRequestWidget(args) {
+    const docs = args.docsUrl ? ` You can get one from ${args.docsUrl}.` : "";
+    const description = args.description ??
+        `${args.label} could not authenticate${args.reason ? ` (${args.reason})` : ""}. ` +
+            `Provide a ${args.label} API key to continue.${docs} ` +
+            "The key is stored as a workspace variable on your machine and never leaves your local runtime.";
+    return uiWidget({
+        agentId: args.agentId,
+        threadId: args.threadId,
+        widget: {
+            kind: "form",
+            widgetId: `${args.source}_api_key_request_${Date.now()}`,
+            title: `${args.label} API Key Required`,
+            description,
+            fields: [
+                ...(args.extraFields ?? []),
+                {
+                    id: "apiKey",
+                    label: "API Key",
+                    type: "password",
+                    placeholder: args.placeholder ?? "sk-...",
+                    required: true,
+                },
+            ],
+            submitLabel: "Save API Key",
+            metadata: {
+                type: API_KEY_REQUEST_TYPE,
+                provider: args.provider ?? args.source,
+                envVar: args.envVar,
+                source: args.source,
+            },
+        },
+    });
+}
+export function isPersistApiKeyFailure(result) {
+    return result.handled === true && result.ok === false;
+}
+export function isPersistApiKeySuccess(result) {
+    return result.handled === true && result.ok === true;
+}
+/** Persist a secret from an `api_key_request` widget response. */
+export async function persistApiKeyFromWidgetResponse(args) {
+    const { metadata, values, widgetId } = args.event.data ?? {};
+    if (!metadata || metadata.type !== API_KEY_REQUEST_TYPE)
+        return { handled: false };
+    if (metadata.source !== args.source)
+        return { handled: false };
+    const apiKey = values?.apiKey;
+    if (typeof apiKey !== "string" || !apiKey.trim())
+        return { handled: false };
+    const envVar = typeof metadata.envVar === "string" && metadata.envVar.trim()
+        ? metadata.envVar.trim()
+        : args.fallbackEnvVar;
+    const provider = typeof metadata.provider === "string" ? metadata.provider : undefined;
+    if (!args.storage) {
+        return { handled: true, ok: false, error: "no storage available; cannot persist API key." };
+    }
+    try {
+        const value = apiKey.trim();
+        await args.storage.createVariable({ key: envVar, value, secret: true });
+        const env = args.env ?? process.env;
+        env[envVar] = value;
+        for (const extra of args.extraEnvVars ?? []) {
+            env[extra] = value;
+        }
+        return { handled: true, ok: true, envVar, apiKey: value, widgetId, provider };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { handled: true, ok: false, error: message };
+    }
+}
+export function apiKeySavedEvents(args) {
+    return [
+        uiWidget({
+            agentId: args.agentId,
+            threadId: args.threadId,
+            widget: {
+                widgetId: args.widgetId ?? `api_key_saved_${Date.now()}`,
+                kind: "message",
+                title: "API Key Saved",
+                body: `Saved ${args.envVar} as a workspace variable. You can now continue the conversation.`,
+                state: "submitted",
+            },
+        }),
+        agentOutput({
+            agentId: args.agentId,
+            threadId: args.threadId,
+            content: args.retryMessage ??
+                `Saved ${args.envVar} to workspace variables. Re-send your last message to retry.`,
+        }),
+    ];
+}
+/** Trim a string value; empty strings become `undefined`. */
+export function trimmedString(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+/** Config `model` value, or `fallback` when unset. */
+export function readConfigModel(config, fallback) {
+    return trimmedString(config.model) ?? fallback;
+}
+/** Strip a `provider/` prefix (`openai/gpt-4o-mini` → `gpt-4o-mini`). */
+export function vendorModelId(model) {
+    if (!model)
+        return undefined;
+    return model.includes("/") ? model.split("/").slice(1).join("/") : model;
+}
+/**
+ * First non-empty value from `process.env`.
+ * The runtime merges workspace variables into the process env on boot and
+ * after every create/delete — plugins should not read `storage.getVariables()`.
+ */
+export function lookupSecret(args) {
+    for (const key of args.envKeys) {
+        const value = trimmedString(process.env[key]);
+        if (value)
+            return value;
+    }
+    return undefined;
+}
+/** User-facing copy when a required workspace variable is missing. */
+export function missingSecretMessage(envKey) {
+    return `Setup is incomplete. Set \`${envKey}\` in workspace settings.`;
+}
+/** Read/write a single string field on thread (or channel) persisted state. */
+export function threadSession(field) {
+    return {
+        read(state) {
+            return trimmedString(persistedStateRecord(state)[field]);
+        },
+        async write(state, storage, value) {
+            await patchPersistedState({ storage, state, patch: { [field]: value } });
+        },
+    };
+}
+/** Persist a small patch onto the current thread, or the channel if there is no thread. */
+export async function patchPersistedState(args) {
+    if (!args.storage || !args.state.channelId)
+        return;
+    if (args.state.threadId) {
+        await args.storage.patchThreadState({
+            channelId: args.state.channelId,
+            threadId: args.state.threadId,
+            state: args.patch,
+        });
+        return;
+    }
+    await args.storage.patchChannelState({
+        channelId: args.state.channelId,
+        state: args.patch,
+    });
+}
+/** Thread state if present, otherwise channel state. */
+export function persistedStateRecord(state) {
+    const source = state.threadDetails?.state ?? state.channelDetails?.state;
+    return source && typeof source === "object" && !Array.isArray(source)
+        ? source
+        : {};
+}
+/**
+ * Bridge a callback-style agent loop onto an async generator.
+ * Used by specialist plugins that enqueue widgets from `generateText` hooks.
+ */
+export async function* yieldFromBackgroundQueue(run) {
+    const queue = [];
+    let wake;
+    let done = false;
+    let error;
+    const task = run((item) => {
+        queue.push(item);
+        wake?.();
+        wake = undefined;
+    })
+        .catch((caught) => {
+        error = caught;
+    })
+        .finally(() => {
+        done = true;
+        wake?.();
+        wake = undefined;
+    });
+    while (!done || queue.length > 0) {
+        if (queue.length === 0) {
+            await new Promise((resolve) => {
+                wake = resolve;
+            });
+            continue;
+        }
+        yield queue.shift();
+    }
+    await task;
+    if (error)
+        throw error;
+}
 //# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

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

package/dist/index.d.ts

@@ -6,4 +6,13 @@ export * from './ui.js';
 export * from './storage.js';
 export * from './helpers.js';
 export * from './diff.js';
+export * from './cloud-mode.js';
+export * from './credits-auth.js';
+export * from './model-registry.js';
+export * from './agent-plugin.js';
+export * from './text-reply.js';
+export * from './mcp-agent.js';
+export * from './mcp-args.js';
+export * from './openai-model.js';
+export * from './thread-context.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -6,4 +6,13 @@ export * from './ui.js';
 export * from './storage.js';
 export * from './helpers.js';
 export * from './diff.js';
+export * from './cloud-mode.js';
+export * from './credits-auth.js';
+export * from './model-registry.js';
+export * from './agent-plugin.js';
+export * from './text-reply.js';
+export * from './mcp-agent.js';
+export * from './mcp-args.js';
+export * from './openai-model.js';
+export * from './thread-context.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

package/dist/mcp-agent.d.ts

@@ -0,0 +1,36 @@
+import { type AgentPluginDefinition } from './agent-plugin.js';
+import type { PluginModule } from './plugin.js';
+export type McpHttpTransport = {
+    url: string;
+    headers?: (apiKey: string) => Record<string, string>;
+};
+export type McpStdioTransport = {
+    command: string;
+    args?: string[];
+    env?: (apiKey: string) => Record<string, string>;
+};
+export type McpTransport = McpHttpTransport | McpStdioTransport;
+export declare function runMcpTurn(args: {
+    mcp: McpTransport;
+    apiKey: string;
+    model: string;
+    system: string;
+    prompt: string;
+    maxSteps?: number;
+    sanitizeEmptyArgs?: boolean;
+}): Promise<string>;
+export type McpAgentDefinition = Omit<AgentPluginDefinition, 'run'> & {
+    secret: {
+        envKeys: string[];
+    };
+    mcp: McpTransport;
+    system: string;
+    maxSteps?: number;
+    history?: boolean;
+    sanitizeEmptyArgs?: boolean;
+};
+/**
+ * Specialist agent: secret + MCP + generateText. Model picker comes from `models`.
+ */
+export declare function defineMcpAgent(definition: McpAgentDefinition): Promise<PluginModule>;
+//# sourceMappingURL=mcp-agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-agent.d.ts","sourceRoot":"","sources":["../src/mcp-agent.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,KAAK,qBAAqB,EAE3B,MAAM,mBAAmB,CAAC;AAK3B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtD,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;AAMhE,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,YAAY,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,GAAG,OAAO,CAAC,MAAM,CAAC,CAiClB;AAED,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,qBAAqB,EAAE,KAAK,CAAC,GAAG;IACpE,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC9B,GAAG,EAAE,YAAY,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAoD1F"}

package/dist/mcp-agent.js

@@ -0,0 +1,93 @@
+import { createMCPClient } from '@ai-sdk/mcp';
+import { Experimental_StdioMCPTransport } from '@ai-sdk/mcp/mcp-stdio';
+import { generateText, stepCountIs } from 'ai';
+import { creditsErrorMessage, hasLlmAuth, llmAuthNotConfiguredMessage, } from './credits-auth.js';
+import { defineAgentPlugin, } from './agent-plugin.js';
+import { lookupSecret, missingSecretMessage, readConfigModel } from './helpers.js';
+import { wrapMcpTools } from './mcp-args.js';
+import { resolveOpenAiModel } from './openai-model.js';
+import { loadThreadContext } from './thread-context.js';
+function isHttpTransport(transport) {
+    return 'url' in transport;
+}
+export async function runMcpTurn(args) {
+    const transport = isHttpTransport(args.mcp)
+        ? {
+            type: 'http',
+            url: args.mcp.url,
+            headers: args.mcp.headers?.(args.apiKey),
+        }
+        : new Experimental_StdioMCPTransport({
+            command: args.mcp.command,
+            args: args.mcp.args ?? [],
+            env: {
+                PATH: process.env.PATH || '',
+                HOME: process.env.HOME || '',
+                ...process.env,
+                ...args.mcp.env?.(args.apiKey),
+            },
+        });
+    const client = await createMCPClient({ transport });
+    try {
+        let tools = await client.tools();
+        if (args.sanitizeEmptyArgs)
+            tools = wrapMcpTools(tools);
+        const result = await generateText({
+            model: resolveOpenAiModel(args.model),
+            system: args.system,
+            prompt: args.prompt,
+            tools,
+            stopWhen: stepCountIs(args.maxSteps ?? 10),
+        });
+        return result.text.trim() || 'Done.';
+    }
+    finally {
+        await client.close().catch(() => undefined);
+    }
+}
+/**
+ * Specialist agent: secret + MCP + generateText. Model picker comes from `models`.
+ */
+export async function defineMcpAgent(definition) {
+    const { secret, mcp, system, maxSteps, history, sanitizeEmptyArgs, models, ...plugin } = definition;
+    const defaultModel = models?.default ?? 'openai/gpt-4o-mini';
+    return defineAgentPlugin({
+        ...plugin,
+        models: models ?? { providers: ['openai'], default: defaultModel },
+        async run(args) {
+            const apiKey = lookupSecret(secret);
+            if (!apiKey)
+                return missingSecretMessage(secret.envKeys[0] ?? 'API_KEY');
+            if (!hasLlmAuth('openai'))
+                return llmAuthNotConfiguredMessage();
+            let prompt = args.prompt;
+            if (history && args.threadId) {
+                const threadContext = await loadThreadContext(args.context.storage, {
+                    channelId: args.handlerCtx.state.channelId,
+                    threadId: args.threadId,
+                    agentId: args.context.agentId,
+                    currentMessage: args.prompt,
+                });
+                if (threadContext)
+                    prompt = `${threadContext}\n\nCurrent message:\n${args.prompt}`;
+            }
+            return runMcpTurn({
+                mcp,
+                apiKey,
+                model: readConfigModel(args.context.config, defaultModel),
+                system,
+                prompt,
+                maxSteps,
+                sanitizeEmptyArgs,
+            });
+        },
+        mapError: plugin.mapError ?? ((error) => ({
+            kind: 'reply',
+            content: creditsErrorMessage(error instanceof Error ? error.message : String(error), {
+                agentName: plugin.name,
+            }) ??
+                (error instanceof Error ? error.message : String(error)),
+        })),
+    });
+}
+//# sourceMappingURL=mcp-agent.js.map

package/dist/mcp-agent.js.map

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

package/dist/mcp-args.d.ts

@@ -0,0 +1,3 @@
+export declare function sanitizeMcpToolArgs(args: unknown): unknown;
+export declare function wrapMcpTools<T extends object>(tools: T): T;
+//# sourceMappingURL=mcp-args.d.ts.map

package/dist/mcp-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-args.d.ts","sourceRoot":"","sources":["../src/mcp-args.ts"],"names":[],"mappings":"AAAA,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAuB1D;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAiB1D"}

package/dist/mcp-args.js

@@ -0,0 +1,41 @@
+export function sanitizeMcpToolArgs(args) {
+    if (args === null || args === undefined)
+        return args;
+    if (typeof args !== 'object' || Array.isArray(args))
+        return args;
+    const result = {};
+    for (const [key, value] of Object.entries(args)) {
+        if (value === '')
+            continue;
+        if (Array.isArray(value) && value.length === 0)
+            continue;
+        if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+            const nested = sanitizeMcpToolArgs(value);
+            if (nested &&
+                typeof nested === 'object' &&
+                !Array.isArray(nested) &&
+                Object.keys(nested).length > 0) {
+                result[key] = nested;
+            }
+            continue;
+        }
+        result[key] = value;
+    }
+    return result;
+}
+export function wrapMcpTools(tools) {
+    const wrapped = { ...tools };
+    for (const [name, tool] of Object.entries(tools)) {
+        if (!tool || typeof tool !== 'object' || !('execute' in tool))
+            continue;
+        const execute = tool.execute;
+        if (typeof execute !== 'function')
+            continue;
+        wrapped[name] = {
+            ...tool,
+            execute: (input, options) => execute.call(tool, sanitizeMcpToolArgs(input), options),
+        };
+    }
+    return wrapped;
+}
+//# sourceMappingURL=mcp-args.js.map

package/dist/mcp-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-args.js","sourceRoot":"","sources":["../src/mcp-args.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAC/C,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACrD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAEjE,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAA+B,CAAC,EAAE,CAAC;QAC3E,IAAI,KAAK,KAAK,EAAE;YAAE,SAAS;QAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACzD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzE,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;YAC1C,IACE,MAAM;gBACN,OAAO,MAAM,KAAK,QAAQ;gBAC1B,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAC9B,CAAC;gBACD,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;YACvB,CAAC;YACD,SAAS;QACX,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,YAAY,CAAmB,KAAQ;IACrD,MAAM,OAAO,GAAG,EAAE,GAAG,KAAK,EAA6B,CAAC;IACxD,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC;YAAE,SAAS;QACxE,MAAM,OAAO,GAAI,IAA8B,CAAC,OAAO,CAAC;QACxD,IAAI,OAAO,OAAO,KAAK,UAAU;YAAE,SAAS;QAC5C,OAAO,CAAC,IAAI,CAAC,GAAG;YACd,GAAG,IAAI;YACP,OAAO,EAAE,CAAC,KAAc,EAAE,OAAiB,EAAE,EAAE,CAC5C,OAA0D,CAAC,IAAI,CAC9D,IAAI,EACJ,mBAAmB,CAAC,KAAK,CAAC,EAC1B,OAAO,CACR;SACJ,CAAC;IACJ,CAAC;IACD,OAAO,OAAY,CAAC;AACtB,CAAC"}

package/dist/model-registry.d.ts

@@ -0,0 +1,54 @@
+import type { ConfigSchemaProperty } from './plugin.js';
+export type ModelRegistryProvider = {
+    label: string;
+    models: Array<{
+        id: string;
+        label: string;
+        description: string;
+    }>;
+};
+export type ModelRegistry = {
+    providers?: Record<string, ModelRegistryProvider>;
+};
+export type ModelConfigField = ConfigSchemaProperty & {
+    type: 'string';
+    options?: Array<{
+        label: string;
+        value: string;
+        description?: string;
+    }>;
+};
+export type ModelConfigFieldOptions = {
+    /** Registry provider ids to include (e.g. `openai`, `anthropic`). */
+    providers: string[];
+    /** `prefixed` => `openai/gpt-4o`. `raw` => `gpt-4o`. */
+    valueFormat?: 'prefixed' | 'raw';
+    override?: boolean;
+    /** Used when the registry is empty, and as a preferred default when present. */
+    defaultValue?: string;
+    /** Prefer the first model whose id matches (e.g. `/sonnet/i`). */
+    defaultMatch?: RegExp;
+    description?: string;
+    fallbackDescription?: string;
+    extraOptions?: Array<{
+        label: string;
+        value: string;
+        description?: string;
+    }>;
+};
+export declare const API_KEY_PROVIDER_IDS: readonly ["openai", "anthropic", "google", "deepseek"];
+export declare const PROVIDER_API_KEY_LINKS: Record<string, string>;
+export declare function fetchModelRegistry(): Promise<ModelRegistry | null>;
+/** Test-only: drop the in-memory registry cache. */
+export declare function resetModelRegistryCache(): void;
+export declare function listApiKeyProviders(registry: ModelRegistry | null): Array<{
+    id: string;
+    label: string;
+}>;
+export declare function getProviderModelOptions(registry: ModelRegistry | null, provider: string): Array<{
+    label: string;
+    value: string;
+}> | undefined;
+/** Registry-backed `configSchema` model field (`enum` + labeled `options`). */
+export declare function modelConfigField(options: ModelConfigFieldOptions): Promise<ModelConfigField>;
+//# sourceMappingURL=model-registry.d.ts.map

package/dist/model-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-registry.d.ts","sourceRoot":"","sources":["../src/model-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnE,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CACnD,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG;IACpD,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzE,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,qEAAqE;IACrE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,wDAAwD;IACxD,WAAW,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9E,CAAC;AAKF,eAAO,MAAM,oBAAoB,wDAAyD,CAAC;AAE3F,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKzD,CAAC;AAWF,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAmBxE;AAED,oDAAoD;AACpD,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,aAAa,GAAG,IAAI,GAC7B,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAStC;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,aAAa,GAAG,IAAI,EAC9B,QAAQ,EAAE,MAAM,GACf,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CAIrD;AAMD,+EAA+E;AAC/E,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CAuD3B"}