@moxxy/sdk 0.43.0 → 0.45.0

package/dist/agent-account-limit.d.ts

@@ -0,0 +1,41 @@
+import type { MoxxyEvent } from './events.js';
+/**
+ * How much of the person's account an agent connection's agent may still use, as the agent
+ * reports it (Claude's plan limits, Codex's rate limits). Recorded in the log, so every surface
+ * reads the same state.
+ */
+export interface AgentAccountLimit {
+    /** `reached`: the agent does no work until `resetsAt`; `near`: most of the window is used. */
+    readonly state: 'ok' | 'near' | 'reached';
+    /** When the window resets, in epoch ms, when the agent says. */
+    readonly resetsAt?: number;
+    /** The window's length in minutes: 300 for five hours, 10080 for a week. */
+    readonly windowMinutes?: number;
+    /** How much of the window is used, 0–100. */
+    readonly usedPercent?: number;
+}
+/** From how much of a window a limit counts as near, for an agent that does not say so itself (Claude warns from 75%). */
+export declare const ACCOUNT_LIMIT_NEAR_PERCENT = 75;
+/** Where an agent connection records its agent's account limit, under `AGENT_CONNECTION_PLUGIN_ID`. */
+export declare const AGENT_ACCOUNT_LIMIT_SUBTYPE = "account_limit";
+export interface RecordedAccountLimit {
+    readonly provider: string;
+    /** The agent's name ("Claude", "Codex"), for the surfaces to say whose limit it is. */
+    readonly agent?: string;
+    readonly limit: AgentAccountLimit;
+}
+/** The last account limit recorded for the provider. */
+export declare function recordedAccountLimit(events: ReadonlyArray<MoxxyEvent>, provider: string): RecordedAccountLimit | undefined;
+/** The limit a plugin event records, or undefined when it records something else. */
+export declare function accountLimitOfEvent(event: MoxxyEvent): RecordedAccountLimit | undefined;
+/** A near or reached limit, until its window resets; a limit with room left says nothing. */
+export declare function accountLimitInForce(recorded: RecordedAccountLimit | undefined, nowMs: number): RecordedAccountLimit | undefined;
+/** Whether two reports would read the same to the person: whole percents, the reset to the minute. */
+export declare function sameAccountLimit(a: AgentAccountLimit | undefined, b: AgentAccountLimit): boolean;
+/**
+ * A used-up limit the agent reports without its reset (Claude Code's own
+ * "You've hit your limit" when its process already said when it resets) keeps
+ * the reset known before, while that still lies ahead.
+ */
+export declare function withKnownReset(reading: AgentAccountLimit, known: AgentAccountLimit | undefined, nowMs: number): AgentAccountLimit;
+//# sourceMappingURL=agent-account-limit.d.ts.map

package/dist/agent-account-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-account-limit.d.ts","sourceRoot":"","sources":["../src/agent-account-limit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;IAC1C,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,6CAA6C;IAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,0HAA0H;AAC1H,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C,uGAAuG;AACvG,eAAO,MAAM,2BAA2B,kBAAkB,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,uFAAuF;IACvF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;CACnC;AAED,wDAAwD;AACxD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAS1H;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,oBAAoB,GAAG,SAAS,CAIvF;AAUD,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAI/H;AAED,sGAAsG;AACtG,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,iBAAiB,GAAG,SAAS,EAAE,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAUhG;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,iBAAiB,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB,CAIjI"}

package/dist/agent-account-limit.js

@@ -0,0 +1,64 @@
+import { AGENT_CONNECTION_PLUGIN_ID } from './agent-step.js';
+/** From how much of a window a limit counts as near, for an agent that does not say so itself (Claude warns from 75%). */
+export const ACCOUNT_LIMIT_NEAR_PERCENT = 75;
+/** Where an agent connection records its agent's account limit, under `AGENT_CONNECTION_PLUGIN_ID`. */
+export const AGENT_ACCOUNT_LIMIT_SUBTYPE = 'account_limit';
+/** The last account limit recorded for the provider. */
+export function recordedAccountLimit(events, provider) {
+    for (let i = events.length - 1; i >= 0; i -= 1) {
+        const event = events[i];
+        if (!event || event.type !== 'plugin_event')
+            continue;
+        if (event.pluginId !== AGENT_CONNECTION_PLUGIN_ID || event.subtype !== AGENT_ACCOUNT_LIMIT_SUBTYPE)
+            continue;
+        const payload = event.payload;
+        if (payload && payload.provider === provider && payload.limit)
+            return accountLimitPayload(payload);
+    }
+    return undefined;
+}
+/** The limit a plugin event records, or undefined when it records something else. */
+export function accountLimitOfEvent(event) {
+    if (event.type !== 'plugin_event' || event.pluginId !== AGENT_CONNECTION_PLUGIN_ID || event.subtype !== AGENT_ACCOUNT_LIMIT_SUBTYPE)
+        return undefined;
+    const payload = event.payload;
+    return payload && typeof payload.provider === 'string' && payload.limit ? accountLimitPayload(payload) : undefined;
+}
+function accountLimitPayload(payload) {
+    return {
+        provider: String(payload.provider),
+        ...(typeof payload.agent === 'string' ? { agent: payload.agent } : {}),
+        limit: payload.limit,
+    };
+}
+/** A near or reached limit, until its window resets; a limit with room left says nothing. */
+export function accountLimitInForce(recorded, nowMs) {
+    if (!recorded || recorded.limit.state === 'ok')
+        return undefined;
+    const { resetsAt } = recorded.limit;
+    return resetsAt !== undefined && resetsAt <= nowMs ? undefined : recorded;
+}
+/** Whether two reports would read the same to the person: whole percents, the reset to the minute. */
+export function sameAccountLimit(a, b) {
+    if (!a)
+        return false;
+    const minute = (ms) => (ms === undefined ? undefined : Math.round(ms / 60_000));
+    const percent = (p) => (p === undefined ? undefined : Math.floor(p));
+    return (a.state === b.state &&
+        a.windowMinutes === b.windowMinutes &&
+        minute(a.resetsAt) === minute(b.resetsAt) &&
+        percent(a.usedPercent) === percent(b.usedPercent));
+}
+/**
+ * A used-up limit the agent reports without its reset (Claude Code's own
+ * "You've hit your limit" when its process already said when it resets) keeps
+ * the reset known before, while that still lies ahead.
+ */
+export function withKnownReset(reading, known, nowMs) {
+    if (reading.state !== 'reached' || reading.resetsAt !== undefined)
+        return reading;
+    if (!known || known.resetsAt === undefined || known.resetsAt <= nowMs)
+        return reading;
+    return { ...reading, resetsAt: known.resetsAt, ...(known.windowMinutes !== undefined && reading.windowMinutes === undefined ? { windowMinutes: known.windowMinutes } : {}) };
+}
+//# sourceMappingURL=agent-account-limit.js.map

package/dist/agent-account-limit.js.map

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

package/dist/agent-computer-use.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Whether a tool call an agent connection ran itself operates the person's computer, recognised
+ * by the tool's name, so every surface can say the agent is using the computer and offer Stop.
+ */
+export interface AgentComputerUse {
+    /** The app the call names, `null` when it names none (listing apps, a screenshot of the screen). */
+    readonly app: string | null;
+}
+export declare function agentComputerUseOf(name: string, input: unknown): AgentComputerUse | undefined;
+//# sourceMappingURL=agent-computer-use.d.ts.map

package/dist/agent-computer-use.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-computer-use.d.ts","sourceRoot":"","sources":["../src/agent-computer-use.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,oGAAoG;IACpG,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAYD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAQ7F"}

package/dist/agent-computer-use.js

@@ -0,0 +1,24 @@
+/**
+ * Whether a tool call an agent connection ran itself operates the person's computer, recognised
+ * by the tool's name, so every surface can say the agent is using the computer and offer Stop.
+ */
+/**
+ * A computer-use MCP server's tools, which drive the person's apps: `mcp__computer-use__click` from
+ * Claude Code and Codex, `computer-use_click` from OpenCode (which names MCP tools `server_tool`).
+ */
+const COMPUTER_SERVERS = /^(?:mcp__)?computer[-_]use_/;
+/** Codex's computer use as JavaScript against its `cua` API; the same API also drives Codex's own browser. */
+const CUA_JS = 'mcp__cua_repl__js';
+const CUA_APPS = /\bcua\.(getApp|getState|listApps|listWindows)\s*\(/;
+const CUA_APP_NAME = /\bcua\.getApp\(\s*['"`]([^'"`]+)['"`]/;
+export function agentComputerUseOf(name, input) {
+    const fields = typeof input === 'object' && input !== null ? input : {};
+    if (COMPUTER_SERVERS.test(name)) {
+        return { app: typeof fields.app === 'string' && fields.app.length > 0 ? fields.app : null };
+    }
+    if (name !== CUA_JS || typeof fields.code !== 'string' || !CUA_APPS.test(fields.code))
+        return undefined;
+    const named = CUA_APP_NAME.exec(fields.code);
+    return { app: named && named[1] ? named[1] : null };
+}
+//# sourceMappingURL=agent-computer-use.js.map

package/dist/agent-computer-use.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-computer-use.js","sourceRoot":"","sources":["../src/agent-computer-use.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;;GAGG;AACH,MAAM,gBAAgB,GAAG,6BAA6B,CAAC;AACvD,8GAA8G;AAC9G,MAAM,MAAM,GAAG,mBAAmB,CAAC;AACnC,MAAM,QAAQ,GAAG,oDAAoD,CAAC;AACtE,MAAM,YAAY,GAAG,uCAAuC,CAAC;AAE7D,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,KAAc;IAC7D,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAE,KAAiC,CAAC,CAAC,CAAC,EAAE,CAAC;IACrG,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,GAAG,EAAE,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9F,CAAC;IACD,IAAI,IAAI,KAAK,MAAM,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACxG,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7C,OAAO,EAAE,GAAG,EAAE,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACtD,CAAC"}

package/dist/agent-context-window.d.ts

@@ -0,0 +1,22 @@
+import type { MoxxyEvent } from './events.js';
+import type { ModelDescriptor } from './provider.js';
+/**
+ * Where an agent connection records the context window its agent reports for a model
+ * (Codex's `modelContextWindow`, Claude's `modelUsage.contextWindow`), under
+ * `AGENT_CONNECTION_PLUGIN_ID`. It replaces the starting window from the model list,
+ * so every surface shows the window the agent really runs with.
+ */
+export declare const AGENT_CONTEXT_WINDOW_SUBTYPE = "context_window";
+export interface RecordedContextWindow {
+    readonly provider: string;
+    readonly model: string;
+    readonly tokens: number;
+}
+export declare function isContextWindowSize(tokens: unknown): tokens is number;
+/** The window an event records, or undefined when it records something else. */
+export declare function contextWindowOfEvent(event: MoxxyEvent): RecordedContextWindow | undefined;
+/** The last window recorded for each model of the provider. */
+export declare function recordedContextWindows(events: ReadonlyArray<MoxxyEvent>, provider: string): ReadonlyMap<string, number>;
+/** The models with the windows the agent reported in place of their starting ones. */
+export declare function withRecordedContextWindows(models: ReadonlyArray<ModelDescriptor>, windows: ReadonlyMap<string, number>): ReadonlyArray<ModelDescriptor>;
+//# sourceMappingURL=agent-context-window.d.ts.map

package/dist/agent-context-window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-context-window.d.ts","sourceRoot":"","sources":["../src/agent-context-window.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,mBAAmB,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,MAAM,CAErE;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,qBAAqB,GAAG,SAAS,CAKzF;AAED,+DAA+D;AAC/D,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAOvH;AAED,sFAAsF;AACtF,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,EACtC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,aAAa,CAAC,eAAe,CAAC,CAMhC"}

package/dist/agent-context-window.js

@@ -0,0 +1,40 @@
+import { AGENT_CONNECTION_PLUGIN_ID } from './agent-step.js';
+/**
+ * Where an agent connection records the context window its agent reports for a model
+ * (Codex's `modelContextWindow`, Claude's `modelUsage.contextWindow`), under
+ * `AGENT_CONNECTION_PLUGIN_ID`. It replaces the starting window from the model list,
+ * so every surface shows the window the agent really runs with.
+ */
+export const AGENT_CONTEXT_WINDOW_SUBTYPE = 'context_window';
+export function isContextWindowSize(tokens) {
+    return typeof tokens === 'number' && Number.isSafeInteger(tokens) && tokens > 0;
+}
+/** The window an event records, or undefined when it records something else. */
+export function contextWindowOfEvent(event) {
+    if (event.type !== 'plugin_event' || event.pluginId !== AGENT_CONNECTION_PLUGIN_ID || event.subtype !== AGENT_CONTEXT_WINDOW_SUBTYPE)
+        return undefined;
+    const payload = event.payload;
+    if (!payload || typeof payload.provider !== 'string' || typeof payload.model !== 'string' || !isContextWindowSize(payload.tokens))
+        return undefined;
+    return { provider: payload.provider, model: payload.model, tokens: payload.tokens };
+}
+/** The last window recorded for each model of the provider. */
+export function recordedContextWindows(events, provider) {
+    const windows = new Map();
+    for (const event of events) {
+        const recorded = contextWindowOfEvent(event);
+        if (recorded && recorded.provider === provider)
+            windows.set(recorded.model, recorded.tokens);
+    }
+    return windows;
+}
+/** The models with the windows the agent reported in place of their starting ones. */
+export function withRecordedContextWindows(models, windows) {
+    if (windows.size === 0)
+        return models;
+    return models.map((model) => {
+        const tokens = windows.get(model.id);
+        return tokens === undefined || tokens === model.contextWindow ? model : { ...model, contextWindow: tokens };
+    });
+}
+//# sourceMappingURL=agent-context-window.js.map

package/dist/agent-context-window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-context-window.js","sourceRoot":"","sources":["../src/agent-context-window.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAI7D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,gBAAgB,CAAC;AAQ7D,MAAM,UAAU,mBAAmB,CAAC,MAAe;IACjD,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC;AAClF,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,oBAAoB,CAAC,KAAiB;IACpD,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,QAAQ,KAAK,0BAA0B,IAAI,KAAK,CAAC,OAAO,KAAK,4BAA4B;QAAE,OAAO,SAAS,CAAC;IACvJ,MAAM,OAAO,GAAG,KAAK,CAAC,OAAgD,CAAC;IACvE,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IACpJ,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;AACtF,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,sBAAsB,CAAC,MAAiC,EAAE,QAAgB;IACxF,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC7C,IAAI,QAAQ,IAAI,QAAQ,CAAC,QAAQ,KAAK,QAAQ;YAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/F,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,0BAA0B,CACxC,MAAsC,EACtC,OAAoC;IAEpC,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IACtC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACrC,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC;IAC9G,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/agent-no-reply.d.ts

@@ -0,0 +1,11 @@
+import type { MoxxyEvent } from './events.js';
+/**
+ * Recorded under `AGENT_CONNECTION_PLUGIN_ID` at the end of a turn the agent took up by
+ * itself ("Agent continued") in which it said nothing and ran nothing, so every surface
+ * says so instead of leaving the turn's marker alone in the chat.
+ */
+export declare const AGENT_NO_REPLY_SUBTYPE = "no_reply";
+/** How every surface words the note. */
+export declare const AGENT_NO_REPLY_TEXT = "The agent finished without replying.";
+export declare function isAgentNoReplyEvent(event: MoxxyEvent): boolean;
+//# sourceMappingURL=agent-no-reply.d.ts.map

package/dist/agent-no-reply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-no-reply.d.ts","sourceRoot":"","sources":["../src/agent-no-reply.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,aAAa,CAAC;AAEjD,wCAAwC;AACxC,eAAO,MAAM,mBAAmB,yCAAyC,CAAC;AAE1E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAE9D"}

package/dist/agent-no-reply.js

@@ -0,0 +1,13 @@
+import { AGENT_CONNECTION_PLUGIN_ID } from './agent-step.js';
+/**
+ * Recorded under `AGENT_CONNECTION_PLUGIN_ID` at the end of a turn the agent took up by
+ * itself ("Agent continued") in which it said nothing and ran nothing, so every surface
+ * says so instead of leaving the turn's marker alone in the chat.
+ */
+export const AGENT_NO_REPLY_SUBTYPE = 'no_reply';
+/** How every surface words the note. */
+export const AGENT_NO_REPLY_TEXT = 'The agent finished without replying.';
+export function isAgentNoReplyEvent(event) {
+    return event.type === 'plugin_event' && event.pluginId === AGENT_CONNECTION_PLUGIN_ID && event.subtype === AGENT_NO_REPLY_SUBTYPE;
+}
+//# sourceMappingURL=agent-no-reply.js.map

package/dist/agent-no-reply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-no-reply.js","sourceRoot":"","sources":["../src/agent-no-reply.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAG7D;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,UAAU,CAAC;AAEjD,wCAAwC;AACxC,MAAM,CAAC,MAAM,mBAAmB,GAAG,sCAAsC,CAAC;AAE1E,MAAM,UAAU,mBAAmB,CAAC,KAAiB;IACnD,OAAO,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,QAAQ,KAAK,0BAA0B,IAAI,KAAK,CAAC,OAAO,KAAK,sBAAsB,CAAC;AACpI,CAAC"}

package/dist/agent-step.d.ts

@@ -0,0 +1,14 @@
+import type { MoxxyEvent } from './events.js';
+/**
+ * Where an agent connection keeps the vendor agent's session in the log. The
+ * `agentStep` contract itself is part of the provider types (`provider.ts`).
+ */
+export declare const AGENT_CONNECTION_PLUGIN_ID: import("./ids.js").PluginId;
+export declare const AGENT_SESSION_SUBTYPE = "agent_session";
+/** The state of the agent's own goal (Claude `/goal`, Codex `thread/goal`), recorded after its turn. */
+export declare const AGENT_GOAL_SUBTYPE = "goal_status";
+/** Where subagents are recorded, the agent's own as well as Moxxy's (`@moxxy/core` writes the same envelope). */
+export declare const SUBAGENTS_PLUGIN_ID: import("./ids.js").PluginId;
+/** The agent session to resume for this provider: the last one recorded, if any. */
+export declare function agentSessionFromEvents(events: ReadonlyArray<MoxxyEvent>, provider: string): string | undefined;
+//# sourceMappingURL=agent-step.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-step.d.ts","sourceRoot":"","sources":["../src/agent-step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C;;;GAGG;AAEH,eAAO,MAAM,0BAA0B,6BAAwC,CAAC;AAChF,eAAO,MAAM,qBAAqB,kBAAkB,CAAC;AACrD,wGAAwG;AACxG,eAAO,MAAM,kBAAkB,gBAAgB,CAAC;AAChD,iHAAiH;AACjH,eAAO,MAAM,mBAAmB,6BAAiC,CAAC;AAElE,oFAAoF;AACpF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS9G"}

package/dist/agent-step.js

@@ -0,0 +1,26 @@
+import { asPluginId } from './ids.js';
+/**
+ * Where an agent connection keeps the vendor agent's session in the log. The
+ * `agentStep` contract itself is part of the provider types (`provider.ts`).
+ */
+export const AGENT_CONNECTION_PLUGIN_ID = asPluginId('@moxxy/agent-connection');
+export const AGENT_SESSION_SUBTYPE = 'agent_session';
+/** The state of the agent's own goal (Claude `/goal`, Codex `thread/goal`), recorded after its turn. */
+export const AGENT_GOAL_SUBTYPE = 'goal_status';
+/** Where subagents are recorded, the agent's own as well as Moxxy's (`@moxxy/core` writes the same envelope). */
+export const SUBAGENTS_PLUGIN_ID = asPluginId('@moxxy/subagents');
+/** The agent session to resume for this provider: the last one recorded, if any. */
+export function agentSessionFromEvents(events, provider) {
+    for (let i = events.length - 1; i >= 0; i -= 1) {
+        const event = events[i];
+        if (!event || event.type !== 'plugin_event')
+            continue;
+        if (event.pluginId !== AGENT_CONNECTION_PLUGIN_ID || event.subtype !== AGENT_SESSION_SUBTYPE)
+            continue;
+        const payload = event.payload;
+        if (payload && payload.provider === provider && typeof payload.sessionId === 'string')
+            return payload.sessionId;
+    }
+    return undefined;
+}
+//# sourceMappingURL=agent-step.js.map

package/dist/agent-step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-step.js","sourceRoot":"","sources":["../src/agent-step.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC;;;GAGG;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,UAAU,CAAC,yBAAyB,CAAC,CAAC;AAChF,MAAM,CAAC,MAAM,qBAAqB,GAAG,eAAe,CAAC;AACrD,wGAAwG;AACxG,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAChD,iHAAiH;AACjH,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;AAElE,oFAAoF;AACpF,MAAM,UAAU,sBAAsB,CAAC,MAAiC,EAAE,QAAgB;IACxF,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;YAAE,SAAS;QACtD,IAAI,KAAK,CAAC,QAAQ,KAAK,0BAA0B,IAAI,KAAK,CAAC,OAAO,KAAK,qBAAqB;YAAE,SAAS;QACvG,MAAM,OAAO,GAAG,KAAK,CAAC,OAA6D,CAAC;QACpF,IAAI,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ;YAAE,OAAO,OAAO,CAAC,SAAS,CAAC;IAClH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/agent-work.d.ts

@@ -0,0 +1,34 @@
+import type { PluginId } from './ids.js';
+import type { MoxxyEvent } from './events.js';
+import type { AgentStepEvent } from './provider.js';
+/** Everything the agent runs in the background now (`AGENT_CONNECTION_PLUGIN_ID`); each record replaces the one before. */
+export declare const AGENT_BACKGROUND_WORK_SUBTYPE = "background_work";
+/** One background work ended (`AGENT_CONNECTION_PLUGIN_ID`), with what it printed last. */
+export declare const AGENT_BACKGROUND_WORK_ENDED_SUBTYPE = "background_work_ended";
+/** What a subagent said as it worked (`SUBAGENTS_PLUGIN_ID`). */
+export declare const SUBAGENT_MESSAGE_SUBTYPE = "subagent_message";
+/** How much of a command's output a `background_work_ended` keeps: its end, which says how it went. */
+export declare const AGENT_WORK_OUTPUT_LIMIT = 4096;
+/** A record of the agent's background work (its list, an end): read by the Agents pane, never drawn in the chat. */
+export declare function isAgentWorkEvent(event: MoxxyEvent): boolean;
+/** A record of a helper agent (its start, steps, words, end), from Moxxy's own subagents or an agent connection's. */
+export declare function isSubagentEvent(event: MoxxyEvent): boolean;
+/** A `plugin_event` without its envelope (session, turn, id, time). */
+export interface AgentActivityRecord {
+    readonly source: 'plugin' | 'system';
+    readonly pluginId: PluginId;
+    readonly subtype: string;
+    readonly payload: Record<string, unknown>;
+}
+/** The helpers of a conversation by id, kept to name them in the records of their later events. */
+export type SubagentNames = Map<string, {
+    readonly label: string;
+    readonly agentType: string;
+}>;
+/**
+ * How an agent's helpers and background work are recorded in the log, the
+ * same whether they come in a turn or between turns; `undefined` for any
+ * other event.
+ */
+export declare function agentActivityRecord(event: AgentStepEvent, provider: string, names: SubagentNames): AgentActivityRecord | undefined;
+//# sourceMappingURL=agent-work.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-work.d.ts","sourceRoot":"","sources":["../src/agent-work.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,2HAA2H;AAC3H,eAAO,MAAM,6BAA6B,oBAAoB,CAAC;AAC/D,2FAA2F;AAC3F,eAAO,MAAM,mCAAmC,0BAA0B,CAAC;AAC3E,iEAAiE;AACjE,eAAO,MAAM,wBAAwB,qBAAqB,CAAC;AAC3D,uGAAuG;AACvG,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,oHAAoH;AACpH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAM3D;AAED,sHAAsH;AACtH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAE1D;AAED,uEAAuE;AACvE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,mGAAmG;AACnG,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEhG;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,mBAAmB,GAAG,SAAS,CA6ClI"}

package/dist/agent-work.js

@@ -0,0 +1,80 @@
+import { AGENT_CONNECTION_PLUGIN_ID, SUBAGENTS_PLUGIN_ID } from './agent-step.js';
+/** Everything the agent runs in the background now (`AGENT_CONNECTION_PLUGIN_ID`); each record replaces the one before. */
+export const AGENT_BACKGROUND_WORK_SUBTYPE = 'background_work';
+/** One background work ended (`AGENT_CONNECTION_PLUGIN_ID`), with what it printed last. */
+export const AGENT_BACKGROUND_WORK_ENDED_SUBTYPE = 'background_work_ended';
+/** What a subagent said as it worked (`SUBAGENTS_PLUGIN_ID`). */
+export const SUBAGENT_MESSAGE_SUBTYPE = 'subagent_message';
+/** How much of a command's output a `background_work_ended` keeps: its end, which says how it went. */
+export const AGENT_WORK_OUTPUT_LIMIT = 4096;
+/** A record of the agent's background work (its list, an end): read by the Agents pane, never drawn in the chat. */
+export function isAgentWorkEvent(event) {
+    return (event.type === 'plugin_event' &&
+        event.pluginId === AGENT_CONNECTION_PLUGIN_ID &&
+        (event.subtype === AGENT_BACKGROUND_WORK_SUBTYPE || event.subtype === AGENT_BACKGROUND_WORK_ENDED_SUBTYPE));
+}
+/** A record of a helper agent (its start, steps, words, end), from Moxxy's own subagents or an agent connection's. */
+export function isSubagentEvent(event) {
+    return event.type === 'plugin_event' && event.pluginId === SUBAGENTS_PLUGIN_ID;
+}
+/**
+ * How an agent's helpers and background work are recorded in the log, the
+ * same whether they come in a turn or between turns; `undefined` for any
+ * other event.
+ */
+export function agentActivityRecord(event, provider, names) {
+    switch (event.type) {
+        case 'subagent_started':
+            names.set(event.id, { label: event.label, agentType: event.agentType });
+            return subagentRecord('subagent_started', {
+                childSessionId: event.id,
+                label: event.label,
+                agentType: event.agentType,
+                ...(event.prompt ? { prompt: event.prompt } : {}),
+                ...(event.toolsUnseen ? { toolsUnseen: true } : {}),
+            });
+        case 'subagent_tool_call': {
+            const named = names.get(event.id);
+            return subagentRecord('subagent_tool_call', { childSessionId: event.id, ...(named ? { label: named.label } : {}), name: event.name, input: event.input });
+        }
+        case 'subagent_message': {
+            const named = names.get(event.id);
+            return subagentRecord(SUBAGENT_MESSAGE_SUBTYPE, { childSessionId: event.id, ...(named ? { label: named.label } : {}), text: event.text });
+        }
+        case 'subagent_completed': {
+            const named = names.get(event.id);
+            return subagentRecord('subagent_completed', {
+                childSessionId: event.id,
+                ...(named ? { label: named.label, agentType: named.agentType } : {}),
+                text: event.text,
+                stopReason: event.stopped ? 'stopped' : event.error ? 'error' : 'end_turn',
+                ...(event.tokensUsed !== undefined ? { tokensUsed: event.tokensUsed } : {}),
+                ...(event.error ? { error: event.error } : {}),
+            });
+        }
+        case 'background_work':
+            return workRecord(AGENT_BACKGROUND_WORK_SUBTYPE, { provider, work: event.work.map(({ id, kind, label }) => ({ id, kind, label })) });
+        case 'background_work_ended':
+            return workRecord(AGENT_BACKGROUND_WORK_ENDED_SUBTYPE, {
+                provider,
+                id: event.id,
+                kind: event.kind,
+                label: event.label,
+                status: event.status,
+                ...(event.summary ? { summary: event.summary } : {}),
+                ...(event.output ? { output: outputEnd(event.output) } : {}),
+            });
+        default:
+            return undefined;
+    }
+}
+function subagentRecord(subtype, payload) {
+    return { source: 'plugin', pluginId: SUBAGENTS_PLUGIN_ID, subtype, payload };
+}
+function workRecord(subtype, payload) {
+    return { source: 'system', pluginId: AGENT_CONNECTION_PLUGIN_ID, subtype, payload };
+}
+function outputEnd(output) {
+    return output.length <= AGENT_WORK_OUTPUT_LIMIT ? output : output.slice(-AGENT_WORK_OUTPUT_LIMIT);
+}
+//# sourceMappingURL=agent-work.js.map

package/dist/agent-work.js.map

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

package/dist/attachment-payload.d.ts

@@ -0,0 +1,95 @@
+import type { MoxxyEvent, UserPromptAttachment } from './events.js';
+/**
+ * Attachment bytes travel two very different roads. The model needs them in
+ * full; a client that only DRAWS the conversation (desktop, a channel
+ * bot) does not, and pushing a scanned 30 MB PDF through the client link on
+ * every reconnect is what once wedged a chat in a reconnect loop. So the runner
+ * sends clients {@link eventForClient} — large payloads swapped for their size —
+ * and a client that wants the bytes (an image preview) reads them back in
+ * bounded slices with {@link readAttachmentChunk}. The log itself never changes.
+ */
+/**
+ * The most attachment payload (base64 characters) one model request carries.
+ * Every request resends the whole conversation, so without a cap a chat with a
+ * few scanned PDFs outgrows the provider's request limit (Anthropic: 32 MB) and
+ * EVERY later turn fails. The newest attachments go in full; older ones that no
+ * longer fit become a note naming them.
+ */
+export declare const MODEL_ATTACHMENT_BUDGET_CHARS: number;
+/** One attachment's payload above this travels to clients by size only. */
+export declare const CLIENT_INLINE_ATTACHMENT_CHARS: number;
+/** All of one event's inline attachment payloads together stay under this. */
+export declare const CLIENT_INLINE_EVENT_CHARS: number;
+/** The largest slice one attachment read returns. */
+export declare const ATTACHMENT_READ_CHUNK_CHARS: number;
+/** The attachment's size in bytes — its real size even on a client copy whose bytes were left out. */
+export declare function attachmentBytes(att: UserPromptAttachment): number;
+/**
+ * The copy of `event` a client receives: every attachment payload too large for
+ * the client link becomes `content: ''` plus `omittedBytes`. Returns `event`
+ * itself when nothing had to change, so the common case allocates nothing.
+ */
+export declare function eventForClient(event: MoxxyEvent): MoxxyEvent;
+/**
+ * The most one history page may weigh on the wire, in JSON characters. Paging
+ * counts events, and a few hundred events with screenshots or attachments can
+ * add up to tens of megabytes — one frame the client has to swallow whole.
+ */
+export declare const HISTORY_PAGE_MAX_CHARS: number;
+/** One newest-first history page: ascending events plus the cursor to the next older page. */
+export interface HistoryPage {
+    readonly events: ReadonlyArray<MoxxyEvent>;
+    readonly prevCursor: number | null;
+}
+/**
+ * The page as a client receives it: every event in its client form, and the
+ * oldest events dropped until the page fits {@link HISTORY_PAGE_MAX_CHARS}. The
+ * newest event always stays, so paging always advances; the dropped events
+ * come back on the next older page.
+ */
+export declare function historyPageForClient(page: HistoryPage): HistoryPage;
+/** One slice of an attachment's `content`, starting at `offset` (in characters). */
+export interface AttachmentChunk {
+    readonly data: string;
+    /** The full `content` length, so the reader knows when it has everything. */
+    readonly total: number;
+}
+/**
+ * Slice attachment `index` of `event`. Slices start on a multiple of four
+ * characters when `offset` does, so base64 slices decode on their own too.
+ */
+export declare function readAttachmentChunk(event: MoxxyEvent, index: number, offset: number): AttachmentChunk;
+/** How an attachment is named across the conversation: `seq:index` of the prompt that carried it. */
+export declare function attachmentKey(seq: number, index: number): string;
+/** One attachment found in the log, with where it sits. */
+export interface FoundAttachment {
+    readonly seq: number;
+    readonly index: number;
+    readonly attachment: UserPromptAttachment;
+}
+/**
+ * The attachment `query` names: its key (`seq:index`) or its file name, the
+ * newest one of that name, whatever the case. Null when none matches.
+ */
+export declare function findAttachment(events: ReadonlyArray<MoxxyEvent>, query: string): FoundAttachment | null;
+/** Every attachment of the conversation, oldest first, as `seq:index name`. */
+export declare function listAttachments(events: ReadonlyArray<MoxxyEvent>): string[];
+/**
+ * What `recall({ attachment })` returns for an image or a document: a pointer,
+ * not the bytes, which stay once in the log. The projection puts the
+ * attachment itself beside this result, so the model sees the original again
+ * even after its turn was summarized away.
+ */
+export interface RestoredAttachmentOutput {
+    readonly forModel: string;
+    readonly restoredAttachment: {
+        readonly seq: number;
+        readonly index: number;
+    };
+}
+/** The attachment a recall result restores, or null for any other output. */
+export declare function restoredAttachmentRef(output: unknown): {
+    seq: number;
+    index: number;
+} | null;
+//# sourceMappingURL=attachment-payload.d.ts.map

package/dist/attachment-payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-payload.d.ts","sourceRoot":"","sources":["../src/attachment-payload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEpE;;;;;;;;GAQG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,QAAmB,CAAC;AAE9D,2EAA2E;AAC3E,eAAO,MAAM,8BAA8B,QAAa,CAAC;AACzD,8EAA8E;AAC9E,eAAO,MAAM,yBAAyB,QAAc,CAAC;AACrD,qDAAqD;AACrD,eAAO,MAAM,2BAA2B,QAAc,CAAC;AAOvD,sGAAsG;AACtG,wBAAgB,eAAe,CAAC,GAAG,EAAE,oBAAoB,GAAG,MAAM,CAKjE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAc5D;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,QAAkB,CAAC;AAEtD,8FAA8F;AAC9F,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAgBnE;AAED,oFAAoF;AACpF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAQrG;AAED,qGAAqG;AACrG,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,2DAA2D;AAC3D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;CAC3C;AAaD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAYvG;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,MAAM,EAAE,CAI3E;AAED;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,kBAAkB,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/E;AAED,6EAA6E;AAC7E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAM5F"}