@drakkar.software/octobot-client 0.4.0

package/dist/protocol/orchestration/createAutomation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAutomation.d.ts","sourceRoot":"","sources":["../../../src/protocol/orchestration/createAutomation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAA;AAC7F,OAAO,EAA0D,KAAK,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAIjH;;;;;wEAKwE;AACxE,MAAM,MAAM,aAAa,GAAG;IAC1B,8EAA8E;IAC9E,IAAI,EAAE,CAAC,aAAa,EAAE,uBAAuB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IACjE;;qBAEiB;IACjB,IAAI,EAAE,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG,oBAAoB,CAAA;AAExD,MAAM,MAAM,wBAAwB,GAAG;IAAE,KAAK,EAAE,UAAU,GAAG,YAAY,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAA;AAE1F,MAAM,MAAM,uBAAuB,GAAG;IACpC,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAA;IACvC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,wBAAwB,KAAK,IAAI,CAAA;CACnD,CAAA;AAED;qDACqD;AACrD,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,CAAA;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;gBAClB,KAAK,EAAE,UAAU,GAAG,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAMpE;AAED;wEACwE;AACxE,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,CAAA;gBAC7B,KAAK,EAAE,UAAU,GAAG,YAAY;CAK7C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,aAAa,EACjB,KAAK,EAAE,qBAAqB,EAC5B,IAAI,GAAE,uBAA4B,GACjC,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CA6B1C"}

package/dist/protocol/orchestration/createAutomation.js

@@ -0,0 +1,71 @@
+import { buildCreateStrategyConfig, buildCreateAutomationConfig } from '../actions.js';
+import { actionErrorDetails, createdAutomationIdOf } from '../state.js';
+import { sleep, pollDelay } from '../poll.js';
+/** A specific action the node executed and rejected. Not retriable by
+ *  resubmitting the same configuration unchanged. */
+export class AutomationActionFailedError extends Error {
+    phase;
+    detail;
+    constructor(phase, detail) {
+        super(`${phase} action failed${detail ? `: ${detail}` : ''}`);
+        this.name = 'AutomationActionFailedError';
+        this.phase = phase;
+        this.detail = detail;
+    }
+}
+/** Neither phase failed outright — the node just never confirmed within the
+ *  budget. Worth a fresh `runCreateAutomation` call, not a resubmit. */
+export class AutomationTimeoutError extends Error {
+    phase;
+    constructor(phase) {
+        super(`${phase} action not confirmed within the timeout budget`);
+        this.name = 'AutomationTimeoutError';
+        this.phase = phase;
+    }
+}
+/**
+ * Two-phase sequenced automation creation: emits `strategy_create`, polls the
+ * node until it confirms, then emits `automation_create` and polls until the
+ * node reports a result.
+ *
+ * This eliminates a concurrent-execution race: the node executes queued
+ * actions concurrently, and `automation_create` resolves its strategy by
+ * (id, version) — if it ran before `strategy_create` registered that
+ * strategy in the node's StrategyProvider, it would fail non-retriably with
+ * `strategy_not_found`. Sequencing guarantees the strategy exists first.
+ *
+ * Callers enforcing an account's automation cap (a product policy the node
+ * itself does not know about) must check it BEFORE calling this — it is not
+ * part of the protocol and this function does not re-derive it.
+ */
+export async function runCreateAutomation(io, input, opts = {}) {
+    const { timeoutMs = 60_000, pollDelay: nextDelay = pollDelay, signal, onProgress } = opts;
+    const deadline = Date.now() + timeoutMs;
+    async function runPhase(phase, configuration) {
+        onProgress?.({ phase, done: false });
+        const actionId = await io.emit(configuration);
+        for (let attempt = 0;; attempt++) {
+            if (signal?.aborted)
+                throw new DOMException('Aborted', 'AbortError');
+            if (Date.now() >= deadline)
+                throw new AutomationTimeoutError(phase);
+            await sleep(nextDelay(attempt));
+            if (signal?.aborted)
+                throw new DOMException('Aborted', 'AbortError');
+            if (Date.now() >= deadline)
+                throw new AutomationTimeoutError(phase);
+            const actions = await io.poll();
+            const action = actions.find((a) => a.id === actionId);
+            if (action?.status === 'failed')
+                throw new AutomationActionFailedError(phase, actionErrorDetails(action));
+            if (action?.status === 'completed') {
+                onProgress?.({ phase, done: true });
+                return action;
+            }
+        }
+    }
+    await runPhase('strategy', buildCreateStrategyConfig(input.strategy));
+    const autoAction = await runPhase('automation', buildCreateAutomationConfig(input));
+    return { automationId: createdAutomationIdOf(autoAction) };
+}
+//# sourceMappingURL=createAutomation.js.map

package/dist/protocol/orchestration/createAutomation.js.map

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

package/dist/protocol/poll.d.ts

@@ -0,0 +1,4 @@
+/** Shared polling primitives for sequenced node orchestrators. */
+export declare const sleep: (ms: number) => Promise<void>;
+export declare const pollDelay: (n: number) => number;
+//# sourceMappingURL=poll.d.ts.map

package/dist/protocol/poll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll.d.ts","sourceRoot":"","sources":["../../src/protocol/poll.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,kBAAgD,CAAA;AAChF,eAAO,MAAM,SAAS,GAAI,GAAG,MAAM,WAAoC,CAAA"}

package/dist/protocol/poll.js

@@ -0,0 +1,4 @@
+/** Shared polling primitives for sequenced node orchestrators. */
+export const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+export const pollDelay = (n) => Math.min(2000 + n * 1500, 8000);
+//# sourceMappingURL=poll.js.map

package/dist/protocol/poll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll.js","sourceRoot":"","sources":["../../src/protocol/poll.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;AAChF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,CAAA"}

package/dist/protocol/proposal.d.ts

@@ -0,0 +1,36 @@
+import type { UserActionConfiguration } from '@drakkar.software/octobot-protocol';
+/** One built-but-unsent action inside a proposal. `after: 'previous-confirmed'`
+ *  marks an action that must not be appended until the PRIOR entry in the
+ *  array has been confirmed by the node — the only case this applies to
+ *  today is `automations.create()`'s `strategy_create` → `automation_create`
+ *  race (see `orchestration/createAutomation.ts`). A privileged executor
+ *  (one that actually has append rights) must honor this ordering; a
+ *  read-only proposer never appends anything itself, so it just carries the
+ *  constraint as data. */
+export type ProposedActionEntry = {
+    configuration: UserActionConfiguration;
+    after?: 'previous-confirmed';
+};
+/** A batch of built-but-unsent user actions, QR-encodable. Produced by a
+ *  read-only-connected client's write methods instead of appending; consumed
+ *  by a privileged client (one with real append rights) to actually execute
+ *  them after a human reviews and confirms. */
+export interface ActionProposal {
+    v: 1;
+    kind: 'octobot-action-proposal';
+    actions: ProposedActionEntry[];
+    /** Human-readable summary for a confirm screen, when the generic
+     *  per-action `configuration.name`/`action_type` derivation isn't enough
+     *  (e.g. a multi-action batch). */
+    label?: string;
+    createdAt: string;
+}
+export declare function encodeActionProposal(actions: ProposedActionEntry[], opts?: {
+    label?: string;
+}): string;
+/** Parse and structurally validate a scanned/pasted action-proposal payload.
+ *  Throws on anything that isn't shaped like one — callers doing QR
+ *  classification should catch and fall through to the next candidate
+ *  parser rather than propagate. */
+export declare function decodeActionProposal(payload: string): ActionProposal;
+//# sourceMappingURL=proposal.d.ts.map

package/dist/protocol/proposal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposal.d.ts","sourceRoot":"","sources":["../../src/protocol/proposal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAA;AAEjF;;;;;;;0BAO0B;AAC1B,MAAM,MAAM,mBAAmB,GAAG;IAChC,aAAa,EAAE,uBAAuB,CAAA;IACtC,KAAK,CAAC,EAAE,oBAAoB,CAAA;CAC7B,CAAA;AAED;;;+CAG+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,CAAC,CAAA;IACJ,IAAI,EAAE,yBAAyB,CAAA;IAC/B,OAAO,EAAE,mBAAmB,EAAE,CAAA;IAC9B;;uCAEmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,EAAE,EAAE,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAStG;AAED;;;oCAGoC;AACpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAkBpE"}

package/dist/protocol/proposal.js

@@ -0,0 +1,39 @@
+export function encodeActionProposal(actions, opts) {
+    const proposal = {
+        v: 1,
+        kind: 'octobot-action-proposal',
+        actions,
+        ...(opts?.label ? { label: opts.label } : {}),
+        createdAt: new Date().toISOString(),
+    };
+    return JSON.stringify(proposal);
+}
+/** Parse and structurally validate a scanned/pasted action-proposal payload.
+ *  Throws on anything that isn't shaped like one — callers doing QR
+ *  classification should catch and fall through to the next candidate
+ *  parser rather than propagate. */
+export function decodeActionProposal(payload) {
+    let parsed;
+    try {
+        parsed = JSON.parse(payload);
+    }
+    catch {
+        throw new Error('not valid JSON');
+    }
+    if (typeof parsed !== 'object' || parsed === null)
+        throw new Error('not an object');
+    const p = parsed;
+    if (p.v !== 1 || p.kind !== 'octobot-action-proposal')
+        throw new Error('not an action proposal payload');
+    if (!Array.isArray(p.actions) || p.actions.length === 0)
+        throw new Error('malformed action proposal: actions');
+    for (const entry of p.actions) {
+        if (typeof entry !== 'object' || entry === null || !('configuration' in entry)) {
+            throw new Error('malformed action proposal: entry');
+        }
+    }
+    if (typeof p.createdAt !== 'string')
+        throw new Error('malformed action proposal: createdAt');
+    return p;
+}
+//# sourceMappingURL=proposal.js.map

package/dist/protocol/proposal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposal.js","sourceRoot":"","sources":["../../src/protocol/proposal.ts"],"names":[],"mappings":"AA8BA,MAAM,UAAU,oBAAoB,CAAC,OAA8B,EAAE,IAAyB;IAC5F,MAAM,QAAQ,GAAmB;QAC/B,CAAC,EAAE,CAAC;QACJ,IAAI,EAAE,yBAAyB;QAC/B,OAAO;QACP,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAA;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;AACjC,CAAC;AAED;;;oCAGoC;AACpC,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAA;IACnC,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAA;IACnF,MAAM,CAAC,GAAG,MAAiC,CAAA;IAC3C,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,yBAAyB;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAA;IACxG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;IAC9G,KAAK,MAAM,KAAK,IAAI,CAAC,CAAC,OAAoB,EAAE,CAAC;QAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,eAAe,IAAI,KAAK,CAAC,EAAE,CAAC;YAC/E,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAA;QACrD,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;IAC5F,OAAO,CAA8B,CAAA;AACvC,CAAC"}

package/dist/protocol/state.d.ts

@@ -0,0 +1,87 @@
+import type { AutomationState, WorkflowStatus, UserAction, AutomationActionResult, AccountActionResult, Account as ProtocolAccount, ExchangeConfig, DetailedAsset, Strategy as ProtocolStrategy } from '@drakkar.software/octobot-protocol';
+import type { StrategyKind } from './strategy/kinds.js';
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function cachedByDoc<T>(compute: (doc: Record<string, unknown>) => T, empty: T): (doc: unknown) => T;
+/** Derives a `StrategyKind` from a protocol Strategy's configuration —
+ *  for callers reconstructing a strategy from raw node data that need to tag
+ *  it with the same kind derivation a local persisted doc would carry. */
+export declare function protocolStrategyKind(configuration: ProtocolStrategy['configuration']): StrategyKind;
+/** Node-reported automation states from a pulled user-data document. Excludes
+ *  any entry carrying a `kind` field — that marks a caller's own local
+ *  mirror unioned into the same array, not node state. */
+export declare const parseNodeAutomationStates: (doc: unknown) => AutomationState[];
+/** Node-reported user actions (with execution status + result) from a pulled
+ *  user-data document. Pulling the append-only `actions` collection itself
+ *  always returns empty — the node reports execution state through
+ *  user-data, not through the queue collection. */
+export declare const parseNodeUserActions: (doc: unknown) => UserAction[];
+/** Protocol workflow status → a coarse live/draft/stopped classification.
+ *  'canceled', 'failed', 'completed' and any future unknown value map to
+ *  'stopped' so a non-running workflow never renders as a live bot. */
+export type AutomationRunStatus = 'live' | 'draft' | 'stopped';
+export declare function workflowStatusToAutomationStatus(status: WorkflowStatus | string | undefined): AutomationRunStatus;
+/** Node-reported failure for an automation: error_message is the protocol
+ *  enum-ish summary, error the detailed string. */
+export declare function automationErrorOf(state: AutomationState): string | null;
+/** Normalize a raw node `assets` value (either flat `DetailedAsset[]` or
+ *  nested `DetailedAssetsForTradingType[]`) into a flat `DetailedAsset[]`.
+ *  The 0.4.0 schema declares the nested shape but the node serializes flat
+ *  items (bypasses pydantic validation when filling) — accept both. */
+export declare function normalizeNodeAssets(raw: unknown): DetailedAsset[];
+/** Holdings from an AutomationState, normalized. */
+export declare function automationHoldings(state: AutomationState): DetailedAsset[];
+export declare const parseNodeAccounts: (doc: unknown) => ProtocolAccount[];
+export declare const parseNodeExchangeConfigs: (doc: unknown) => ExchangeConfig[];
+/** A protocol-shaped account holding: no fiat value (a caller with its own
+ *  pricing owns that), no display-only decoration. */
+export type Holding = {
+    symbol: string;
+    total: number;
+    free: number;
+    used: number;
+};
+/** Map node-reported asset quantities to a flat holdings list. */
+export declare function accountHoldingsFromNodeState(na: ProtocolAccount): Holding[];
+export declare function automationResultOf(action: UserAction): AutomationActionResult | null;
+export declare function accountResultOf(action: UserAction): AccountActionResult | null;
+export declare function actionErrorDetails(action: UserAction): string | null;
+/** The automation id a completed automation_create produced. */
+export declare function createdAutomationIdOf(action: UserAction): string | null;
+/** The account id an `account_create` carries. Unlike automations, account
+ *  ids are client-assigned and reused verbatim by the node, so the creating
+ *  action alone identifies the account it will produce. */
+export declare function createdAccountIdOf(action: UserAction): string | null;
+/** Which domain a user action belongs to, purely from its wire `action_type`. */
+export type UserActionDomain = 'accounts' | 'automations';
+/** Null for action types with no owning domain (a future protocol action
+ *  added here before its domain is wired in degrades to "belongs nowhere"
+ *  rather than crashing a domain filter). */
+export declare function actionDomainOf(action: UserAction): UserActionDomain | null;
+/** The automation an action targets — explicit id for edit/stop/signal, the
+ *  node-reported created id for create. */
+export declare function targetAutomationIdOf(action: UserAction): string | null;
+/** Every account id an action targets. `account_create`/`_edit`/`_delete`
+ *  carry the account id directly; `account_auth_*`/`exchange_config_*` carry
+ *  an `auth_*`/`cfg_*` id derived from it and are reversed back to the
+ *  account id. `accounts_refresh` with no explicit `account_ids` targets
+ *  every account — callers should treat that case as "matches any account"
+ *  rather than reading an empty array from here. */
+export declare function targetAccountIdsOf(action: UserAction): string[];
+/** Whether a queued action targets the given account — an `accounts_refresh`
+ *  with no explicit `account_ids` refreshes every account, so it counts as
+ *  targeting all of them. */
+export declare function actionTargetsAccount(action: UserAction, accountId: string): boolean;
+/** The strategy (id, version) an automation runs, recovered from the action
+ *  history: node AutomationStates carry no strategy reference — the
+ *  automation_create / automation_edit configurations are the only wire
+ *  record. The newest action targeting the automation wins (an edit
+ *  supersedes the create). */
+export declare function automationStrategyRefOf(actions: UserAction[], automationId: string): {
+    id: string;
+    version?: string;
+} | null;
+/** Human-facing name carried by the action's configuration, when one exists.
+ *  Returns null when the configuration only carries an opaque id (stop /
+ *  delete actions) — callers fall back to their own type label. */
+export declare function actionDisplayName(action: UserAction): string | null;
+//# sourceMappingURL=state.d.ts.map

package/dist/protocol/state.d.ts.map

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

package/dist/protocol/state.js

@@ -0,0 +1,303 @@
+import { accountIdFromAuthId, accountIdFromExchangeConfigId } from './actions.js';
+// The node computes `users/{identity}/data` on every pull as a protocol
+// UserDataState { automations: AutomationState[], user_actions: UserAction[] }
+// (snake_case pydantic JSON). This is bidirectional wire state — parse it
+// READ-TIME with the tolerant functions below; a caller with its own local
+// mirror (tombstones, CRDT merge) reconciles the two itself, one layer up.
+export function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+// Every parser below is cached per input document reference: a caller reading
+// through `useSyncExternalStore`-style selectors needs a stable reference for
+// the same input, or a fresh .filter()/.map() per call trips React's
+// "getSnapshot should be cached" infinite-loop guard. A store write replaces
+// the data object, so a new reference recomputes. Exported (not just used
+// internally) so a caller building its own local-merge layer on top of these
+// parsers — see docs/10-advanced-primitives.md — can give its own derived
+// values the same reference-stability guarantee instead of reimplementing it.
+export function cachedByDoc(compute, empty) {
+    const cache = new WeakMap();
+    return (doc) => {
+        if (!isRecord(doc))
+            return empty;
+        const hit = cache.get(doc);
+        if (hit !== undefined)
+            return hit;
+        const out = compute(doc);
+        cache.set(doc, out);
+        return out;
+    };
+}
+/** Derives a `StrategyKind` from a protocol Strategy's configuration —
+ *  for callers reconstructing a strategy from raw node data that need to tag
+ *  it with the same kind derivation a local persisted doc would carry. */
+export function protocolStrategyKind(configuration) {
+    switch (configuration.configuration_type) {
+        case 'market_making': return 'mm';
+        case 'copy': return 'copy';
+        case 'generic_process': return 'custom';
+        case 'generic_workflow': return 'ai-agents';
+        case 'trading_tentacles': {
+            const name = configuration.name;
+            if (name === 'GridTradingMode')
+                return 'grid';
+            if (name === 'DCATradingMode')
+                return 'dca';
+            if (name === 'IndexTradingMode')
+                return 'basket';
+            return 'custom';
+        }
+        default: return 'custom';
+    }
+}
+const EMPTY_AUTOMATION_STATES = [];
+const EMPTY_USER_ACTIONS = [];
+/** Node-reported automation states from a pulled user-data document. Excludes
+ *  any entry carrying a `kind` field — that marks a caller's own local
+ *  mirror unioned into the same array, not node state. */
+export const parseNodeAutomationStates = cachedByDoc((doc) => {
+    if (!Array.isArray(doc.automations))
+        return EMPTY_AUTOMATION_STATES;
+    return doc.automations.filter((entry) => isRecord(entry) && typeof entry.id === 'string' && !('kind' in entry));
+}, EMPTY_AUTOMATION_STATES);
+/** Node-reported user actions (with execution status + result) from a pulled
+ *  user-data document. Pulling the append-only `actions` collection itself
+ *  always returns empty — the node reports execution state through
+ *  user-data, not through the queue collection. */
+export const parseNodeUserActions = cachedByDoc((doc) => {
+    if (!Array.isArray(doc.user_actions))
+        return EMPTY_USER_ACTIONS;
+    return doc.user_actions.filter((entry) => isRecord(entry) && typeof entry.id === 'string');
+}, EMPTY_USER_ACTIONS);
+export function workflowStatusToAutomationStatus(status) {
+    switch (status) {
+        case 'scheduled':
+        case 'periodic':
+        case 'running':
+            return 'live';
+        case 'pending':
+            return 'draft';
+        default:
+            return 'stopped';
+    }
+}
+/** Node-reported failure for an automation: error_message is the protocol
+ *  enum-ish summary, error the detailed string. */
+export function automationErrorOf(state) {
+    return state.error_message ?? state.error ?? null;
+}
+/** Normalize a raw node `assets` value (either flat `DetailedAsset[]` or
+ *  nested `DetailedAssetsForTradingType[]`) into a flat `DetailedAsset[]`.
+ *  The 0.4.0 schema declares the nested shape but the node serializes flat
+ *  items (bypasses pydantic validation when filling) — accept both. */
+export function normalizeNodeAssets(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    for (const entry of raw) {
+        if (!isRecord(entry))
+            continue;
+        if (typeof entry.symbol === 'string') {
+            out.push(entry);
+        }
+        else if (Array.isArray(entry.assets)) {
+            for (const nested of entry.assets) {
+                if (isRecord(nested) && typeof nested.symbol === 'string')
+                    out.push(nested);
+            }
+        }
+    }
+    return out;
+}
+/** Holdings from an AutomationState, normalized. */
+export function automationHoldings(state) {
+    return normalizeNodeAssets(state.assets);
+}
+// The accounts collection is node-owned and pull-only: a client push is
+// dead-lettered into opaque storage and every pull returns the node's
+// AccountsState { accounts, exchange_configs }.
+const EMPTY_NODE_ACCOUNTS = [];
+const EMPTY_EXCHANGE_CONFIGS = [];
+export const parseNodeAccounts = cachedByDoc((doc) => {
+    if (!Array.isArray(doc.accounts))
+        return EMPTY_NODE_ACCOUNTS;
+    return doc.accounts.filter((entry) => isRecord(entry) && typeof entry.id === 'string');
+}, EMPTY_NODE_ACCOUNTS);
+export const parseNodeExchangeConfigs = cachedByDoc((doc) => {
+    if (!Array.isArray(doc.exchange_configs))
+        return EMPTY_EXCHANGE_CONFIGS;
+    return doc.exchange_configs.filter((entry) => isRecord(entry) && typeof entry.id === 'string');
+}, EMPTY_EXCHANGE_CONFIGS);
+/** Map node-reported asset quantities to a flat holdings list. */
+export function accountHoldingsFromNodeState(na) {
+    const assets = normalizeNodeAssets(na.assets);
+    return assets.map((a) => ({
+        symbol: a.symbol,
+        total: a.total,
+        free: a.available,
+        used: Math.max(0, a.total - a.available),
+    }));
+}
+// ── Typed user-action accessors ──────────────────────────────────────────────
+// Discriminated reads over UserAction.result / .configuration — replace
+// ad-hoc `as X` casts.
+export function automationResultOf(action) {
+    return action.result?.result_type === 'automation' ? action.result : null;
+}
+export function accountResultOf(action) {
+    return action.result?.result_type === 'account' ? action.result : null;
+}
+export function actionErrorDetails(action) {
+    // Every 0.4.0 result variant (automation, account, account_auth,
+    // exchange_config, strategy) carries the same optional error_details slot
+    // plus a structured error_message enum (e.g. 'strategy_not_found'). Both
+    // are optional — fall back to the enum so a failure is never blank.
+    const result = action.result;
+    return result?.error_details ?? result?.error_message ?? null;
+}
+/** The automation id a completed automation_create produced. */
+export function createdAutomationIdOf(action) {
+    return automationResultOf(action)?.created_automation_id ?? null;
+}
+/** The account id an `account_create` carries. Unlike automations, account
+ *  ids are client-assigned and reused verbatim by the node, so the creating
+ *  action alone identifies the account it will produce. */
+export function createdAccountIdOf(action) {
+    const cfg = action.configuration;
+    if (cfg?.action_type !== 'account_create')
+        return null;
+    return cfg.configuration?.id ?? null;
+}
+const ACTION_TYPE_DOMAIN = {
+    account_create: 'accounts',
+    account_edit: 'accounts',
+    account_delete: 'accounts',
+    account_auth_create: 'accounts',
+    account_auth_edit: 'accounts',
+    account_auth_delete: 'accounts',
+    exchange_config_create: 'accounts',
+    exchange_config_edit: 'accounts',
+    exchange_config_delete: 'accounts',
+    accounts_refresh: 'accounts',
+    automation_create: 'automations',
+    automation_edit: 'automations',
+    automation_stop: 'automations',
+    automation_signal: 'automations',
+    // A strategy only exists to back an automation — same domain.
+    strategy_create: 'automations',
+    strategy_edit: 'automations',
+    strategy_delete: 'automations',
+};
+/** Null for action types with no owning domain (a future protocol action
+ *  added here before its domain is wired in degrades to "belongs nowhere"
+ *  rather than crashing a domain filter). */
+export function actionDomainOf(action) {
+    const type = action.configuration?.action_type;
+    return type ? ACTION_TYPE_DOMAIN[type] ?? null : null;
+}
+/** The automation an action targets — explicit id for edit/stop/signal, the
+ *  node-reported created id for create. */
+export function targetAutomationIdOf(action) {
+    const cfg = action.configuration;
+    if (!cfg)
+        return null;
+    switch (cfg.action_type) {
+        case 'automation_edit': return cfg.id;
+        case 'automation_stop': return cfg.id;
+        case 'automation_signal': return cfg.automation_id;
+        case 'automation_create': return createdAutomationIdOf(action);
+        default: return null;
+    }
+}
+/** Every account id an action targets. `account_create`/`_edit`/`_delete`
+ *  carry the account id directly; `account_auth_*`/`exchange_config_*` carry
+ *  an `auth_*`/`cfg_*` id derived from it and are reversed back to the
+ *  account id. `accounts_refresh` with no explicit `account_ids` targets
+ *  every account — callers should treat that case as "matches any account"
+ *  rather than reading an empty array from here. */
+export function targetAccountIdsOf(action) {
+    const cfg = action.configuration;
+    if (!cfg)
+        return [];
+    switch (cfg.action_type) {
+        case 'account_create': {
+            const id = createdAccountIdOf(action);
+            return id ? [id] : [];
+        }
+        case 'account_edit': return [cfg.id];
+        case 'account_delete': return [cfg.id];
+        case 'accounts_refresh': return cfg.account_ids ?? [];
+        case 'account_auth_create':
+            return [accountIdFromAuthId(cfg.configuration.id)];
+        case 'account_auth_edit': return [accountIdFromAuthId(cfg.id)];
+        case 'account_auth_delete': return [accountIdFromAuthId(cfg.id)];
+        case 'exchange_config_create':
+            return [accountIdFromExchangeConfigId(cfg.configuration.id)];
+        case 'exchange_config_edit':
+            return [accountIdFromExchangeConfigId(cfg.id)];
+        case 'exchange_config_delete':
+            return [accountIdFromExchangeConfigId(cfg.id)];
+        default: return [];
+    }
+}
+/** Whether a queued action targets the given account — an `accounts_refresh`
+ *  with no explicit `account_ids` refreshes every account, so it counts as
+ *  targeting all of them. */
+export function actionTargetsAccount(action, accountId) {
+    const cfg = action.configuration;
+    if (cfg?.action_type === 'accounts_refresh' && !cfg.account_ids)
+        return true;
+    return targetAccountIdsOf(action).includes(accountId);
+}
+/** The strategy (id, version) an automation runs, recovered from the action
+ *  history: node AutomationStates carry no strategy reference — the
+ *  automation_create / automation_edit configurations are the only wire
+ *  record. The newest action targeting the automation wins (an edit
+ *  supersedes the create). */
+export function automationStrategyRefOf(actions, automationId) {
+    let best = null;
+    let bestAt = '';
+    for (const action of actions) {
+        const cfg = action.configuration;
+        if (!cfg)
+            continue;
+        let ref;
+        if (cfg.action_type === 'automation_edit' && cfg.id === automationId) {
+            ref = cfg.configuration?.strategy;
+        }
+        else if (cfg.action_type === 'automation_create' && createdAutomationIdOf(action) === automationId) {
+            ref = cfg.configuration?.strategy;
+        }
+        if (!ref?.id)
+            continue;
+        const at = action.updated_at ?? action.created_at ?? '';
+        if (best === null || at >= bestAt) {
+            best = { id: ref.id, version: ref.version };
+            bestAt = at;
+        }
+    }
+    return best;
+}
+/** Human-facing name carried by the action's configuration, when one exists.
+ *  Returns null when the configuration only carries an opaque id (stop /
+ *  delete actions) — callers fall back to their own type label. */
+export function actionDisplayName(action) {
+    const cfg = action.configuration;
+    if (!cfg)
+        return null;
+    switch (cfg.action_type) {
+        case 'automation_create': return cfg.configuration?.name ?? null;
+        case 'automation_edit': return cfg.configuration?.name ?? null;
+        case 'account_create':
+        case 'account_edit':
+        // Strategy actions carry the strategy's display name — the likeliest
+        // failure in the inbox (a strategy race) should not title generically.
+        case 'strategy_create':
+        case 'strategy_edit': {
+            const config = cfg.configuration;
+            return config?.name ?? null;
+        }
+        default: return null;
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/protocol/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/protocol/state.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,mBAAmB,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAA;AAGjF,wEAAwE;AACxE,+EAA+E;AAC/E,0EAA0E;AAC1E,2EAA2E;AAC3E,2EAA2E;AAE3E,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC7E,CAAC;AAED,8EAA8E;AAC9E,8EAA8E;AAC9E,qEAAqE;AACrE,6EAA6E;AAC7E,0EAA0E;AAC1E,6EAA6E;AAC7E,0EAA0E;AAC1E,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAI,OAA4C,EAAE,KAAQ;IACnF,MAAM,KAAK,GAAG,IAAI,OAAO,EAAa,CAAA;IACtC,OAAO,CAAC,GAAY,EAAK,EAAE;QACzB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAA;QAChC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAC1B,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,GAAG,CAAA;QACjC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;QACxB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;QACnB,OAAO,GAAG,CAAA;IACZ,CAAC,CAAA;AACH,CAAC;AAED;;0EAE0E;AAC1E,MAAM,UAAU,oBAAoB,CAAC,aAAgD;IACnF,QAAQ,aAAa,CAAC,kBAAkB,EAAE,CAAC;QACzC,KAAK,eAAe,CAAC,CAAI,OAAO,IAAI,CAAA;QACpC,KAAK,MAAM,CAAC,CAAa,OAAO,MAAM,CAAA;QACtC,KAAK,iBAAiB,CAAC,CAAE,OAAO,QAAQ,CAAA;QACxC,KAAK,kBAAkB,CAAC,CAAC,OAAO,WAAW,CAAA;QAC3C,KAAK,mBAAmB,CAAC,CAAC,CAAC;YACzB,MAAM,IAAI,GAAI,aAAmC,CAAC,IAAI,CAAA;YACtD,IAAI,IAAI,KAAK,iBAAiB;gBAAG,OAAO,MAAM,CAAA;YAC9C,IAAI,IAAI,KAAK,gBAAgB;gBAAI,OAAO,KAAK,CAAA;YAC7C,IAAI,IAAI,KAAK,kBAAkB;gBAAE,OAAO,QAAQ,CAAA;YAChD,OAAO,QAAQ,CAAA;QACjB,CAAC;QACD,OAAO,CAAC,CAAC,OAAO,QAAQ,CAAA;IAC1B,CAAC;AACH,CAAC;AAED,MAAM,uBAAuB,GAAsB,EAAE,CAAA;AACrD,MAAM,kBAAkB,GAAiB,EAAE,CAAA;AAE3C;;0DAE0D;AAC1D,MAAM,CAAC,MAAM,yBAAyB,GAAwC,WAAW,CACvF,CAAC,GAAG,EAAE,EAAE;IACN,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;QAAE,OAAO,uBAAuB,CAAA;IACnE,OAAO,GAAG,CAAC,WAAW,CAAC,MAAM,CAC3B,CAAC,KAAK,EAA4B,EAAE,CAClC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,CACxE,CAAA;AACH,CAAC,EACD,uBAAuB,CACxB,CAAA;AAED;;;mDAGmD;AACnD,MAAM,CAAC,MAAM,oBAAoB,GAAmC,WAAW,CAC7E,CAAC,GAAG,EAAE,EAAE;IACN,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QAAE,OAAO,kBAAkB,CAAA;IAC/D,OAAO,GAAG,CAAC,YAAY,CAAC,MAAM,CAC5B,CAAC,KAAK,EAAuB,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,CAChF,CAAA;AACH,CAAC,EACD,kBAAkB,CACnB,CAAA;AAOD,MAAM,UAAU,gCAAgC,CAAC,MAA2C;IAC1F,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,WAAW,CAAC;QACjB,KAAK,UAAU,CAAC;QAChB,KAAK,SAAS;YACZ,OAAO,MAAM,CAAA;QACf,KAAK,SAAS;YACZ,OAAO,OAAO,CAAA;QAChB;YACE,OAAO,SAAS,CAAA;IACpB,CAAC;AACH,CAAC;AAED;mDACmD;AACnD,MAAM,UAAU,iBAAiB,CAAC,KAAsB;IACtD,OAAO,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,KAAK,IAAI,IAAI,CAAA;AACnD,CAAC;AAED;;;uEAGuE;AACvE,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAA;IAClC,MAAM,GAAG,GAAoB,EAAE,CAAA;IAC/B,KAAK,MAAM,KAAK,IAAI,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAQ;QAC9B,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACrC,GAAG,CAAC,IAAI,CAAC,KAAiC,CAAC,CAAA;QAC7C,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YACvC,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBAClC,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;oBAAE,GAAG,CAAC,IAAI,CAAC,MAAkC,CAAC,CAAA;YACzG,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,kBAAkB,CAAC,KAAsB;IACvD,OAAO,mBAAmB,CAAC,KAAK,CAAC,MAAiB,CAAC,CAAA;AACrD,CAAC;AAED,wEAAwE;AACxE,sEAAsE;AACtE,gDAAgD;AAEhD,MAAM,mBAAmB,GAAsB,EAAE,CAAA;AACjD,MAAM,sBAAsB,GAAqB,EAAE,CAAA;AAEnD,MAAM,CAAC,MAAM,iBAAiB,GAAwC,WAAW,CAC/E,CAAC,GAAG,EAAE,EAAE;IACN,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,mBAAmB,CAAA;IAC5D,OAAO,GAAG,CAAC,QAAQ,CAAC,MAAM,CACxB,CAAC,KAAK,EAA4B,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,CACrF,CAAA;AACH,CAAC,EACD,mBAAmB,CACpB,CAAA;AAED,MAAM,CAAC,MAAM,wBAAwB,GAAuC,WAAW,CACrF,CAAC,GAAG,EAAE,EAAE;IACN,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;QAAE,OAAO,sBAAsB,CAAA;IACvE,OAAO,GAAG,CAAC,gBAAgB,CAAC,MAAM,CAChC,CAAC,KAAK,EAA2B,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,CACpF,CAAA;AACH,CAAC,EACD,sBAAsB,CACvB,CAAA;AAMD,kEAAkE;AAClE,MAAM,UAAU,4BAA4B,CAAC,EAAmB;IAC9D,MAAM,MAAM,GAAG,mBAAmB,CAAC,EAAE,CAAC,MAAiB,CAAC,CAAA;IACxD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACxB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,KAAK,EAAG,CAAC,CAAC,KAAK;QACf,IAAI,EAAI,CAAC,CAAC,SAAS;QACnB,IAAI,EAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,SAAS,CAAC;KAC3C,CAAC,CAAC,CAAA;AACL,CAAC;AAED,gFAAgF;AAChF,wEAAwE;AACxE,uBAAuB;AAEvB,MAAM,UAAU,kBAAkB,CAAC,MAAkB;IACnD,OAAO,MAAM,CAAC,MAAM,EAAE,WAAW,KAAK,YAAY,CAAC,CAAC,CAAE,MAAM,CAAC,MAAiC,CAAC,CAAC,CAAC,IAAI,CAAA;AACvG,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAkB;IAChD,OAAO,MAAM,CAAC,MAAM,EAAE,WAAW,KAAK,SAAS,CAAC,CAAC,CAAE,MAAM,CAAC,MAA8B,CAAC,CAAC,CAAC,IAAI,CAAA;AACjG,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAkB;IACnD,iEAAiE;IACjE,0EAA0E;IAC1E,yEAAyE;IACzE,oEAAoE;IACpE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAwE,CAAA;IAC9F,OAAO,MAAM,EAAE,aAAa,IAAI,MAAM,EAAE,aAAa,IAAI,IAAI,CAAA;AAC/D,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,qBAAqB,CAAC,MAAkB;IACtD,OAAO,kBAAkB,CAAC,MAAM,CAAC,EAAE,qBAAqB,IAAI,IAAI,CAAA;AAClE,CAAC;AAED;;2DAE2D;AAC3D,MAAM,UAAU,kBAAkB,CAAC,MAAkB;IACnD,MAAM,GAAG,GAAG,MAAM,CAAC,aAAa,CAAA;IAChC,IAAI,GAAG,EAAE,WAAW,KAAK,gBAAgB;QAAE,OAAO,IAAI,CAAA;IACtD,OAAQ,GAAkC,CAAC,aAAa,EAAE,EAAE,IAAI,IAAI,CAAA;AACtE,CAAC;AAKD,MAAM,kBAAkB,GAAqC;IAC3D,cAAc,EAAE,UAAU;IAC1B,YAAY,EAAE,UAAU;IACxB,cAAc,EAAE,UAAU;IAC1B,mBAAmB,EAAE,UAAU;IAC/B,iBAAiB,EAAE,UAAU;IAC7B,mBAAmB,EAAE,UAAU;IAC/B,sBAAsB,EAAE,UAAU;IAClC,oBAAoB,EAAE,UAAU;IAChC,sBAAsB,EAAE,UAAU;IAClC,gBAAgB,EAAE,UAAU;IAC5B,iBAAiB,EAAE,aAAa;IAChC,eAAe,EAAE,aAAa;IAC9B,eAAe,EAAE,aAAa;IAC9B,iBAAiB,EAAE,aAAa;IAChC,8DAA8D;IAC9D,eAAe,EAAE,aAAa;IAC9B,aAAa,EAAE,aAAa;IAC5B,eAAe,EAAE,aAAa;CAC/B,CAAA;AAED;;6CAE6C;AAC7C,MAAM,UAAU,cAAc,CAAC,MAAkB;IAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,aAAa,EAAE,WAAW,CAAA;IAC9C,OAAO,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;AACvD,CAAC;AAED;2CAC2C;AAC3C,MAAM,UAAU,oBAAoB,CAAC,MAAkB;IACrD,MAAM,GAAG,GAAG,MAAM,CAAC,aAAa,CAAA;IAChC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAA;IACrB,QAAQ,GAAG,CAAC,WAAW,EAAE,CAAC;QACxB,KAAK,iBAAiB,CAAC,CAAC,OAAQ,GAAmC,CAAC,EAAE,CAAA;QACtE,KAAK,iBAAiB,CAAC,CAAC,OAAQ,GAAmC,CAAC,EAAE,CAAA;QACtE,KAAK,mBAAmB,CAAC,CAAC,OAAQ,GAAqC,CAAC,aAAa,CAAA;QACrF,KAAK,mBAAmB,CAAC,CAAC,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAA;QAC9D,OAAO,CAAC,CAAC,OAAO,IAAI,CAAA;IACtB,CAAC;AACH,CAAC;AAED;;;;;oDAKoD;AACpD,MAAM,UAAU,kBAAkB,CAAC,MAAkB;IACnD,MAAM,GAAG,GAAG,MAAM,CAAC,aAAa,CAAA;IAChC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAA;IACnB,QAAQ,GAAG,CAAC,WAAW,EAAE,CAAC;QACxB,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,MAAM,EAAE,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAA;YACrC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QACvB,CAAC;QACD,KAAK,cAAc,CAAC,CAAC,OAAO,CAAE,GAAgC,CAAC,EAAE,CAAC,CAAA;QAClE,KAAK,gBAAgB,CAAC,CAAC,OAAO,CAAE,GAAkC,CAAC,EAAE,CAAC,CAAA;QACtE,KAAK,kBAAkB,CAAC,CAAC,OAAQ,GAAoC,CAAC,WAAW,IAAI,EAAE,CAAA;QACvF,KAAK,qBAAqB;YACxB,OAAO,CAAC,mBAAmB,CAAE,GAAsC,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAA;QACxF,KAAK,mBAAmB,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAE,GAAoC,CAAC,EAAE,CAAC,CAAC,CAAA;QAChG,KAAK,qBAAqB,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAE,GAAsC,CAAC,EAAE,CAAC,CAAC,CAAA;QACpG,KAAK,wBAAwB;YAC3B,OAAO,CAAC,6BAA6B,CAAE,GAAyC,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAA;QACrG,KAAK,sBAAsB;YACzB,OAAO,CAAC,6BAA6B,CAAE,GAAuC,CAAC,EAAE,CAAC,CAAC,CAAA;QACrF,KAAK,wBAAwB;YAC3B,OAAO,CAAC,6BAA6B,CAAE,GAAyC,CAAC,EAAE,CAAC,CAAC,CAAA;QACvF,OAAO,CAAC,CAAC,OAAO,EAAE,CAAA;IACpB,CAAC;AACH,CAAC;AAED;;6BAE6B;AAC7B,MAAM,UAAU,oBAAoB,CAAC,MAAkB,EAAE,SAAiB;IACxE,MAAM,GAAG,GAAG,MAAM,CAAC,aAAa,CAAA;IAChC,IAAI,GAAG,EAAE,WAAW,KAAK,kBAAkB,IAAI,CAAE,GAAoC,CAAC,WAAW;QAAE,OAAO,IAAI,CAAA;IAC9G,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;AACvD,CAAC;AAED;;;;8BAI8B;AAC9B,MAAM,UAAU,uBAAuB,CACrC,OAAqB,EACrB,YAAoB;IAEpB,IAAI,IAAI,GAA4C,IAAI,CAAA;IACxD,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,aAAa,CAAA;QAChC,IAAI,CAAC,GAAG;YAAE,SAAQ;QAClB,IAAI,GAAgD,CAAA;QACpD,IAAI,GAAG,CAAC,WAAW,KAAK,iBAAiB,IAAK,GAAmC,CAAC,EAAE,KAAK,YAAY,EAAE,CAAC;YACtG,GAAG,GAAI,GAAmC,CAAC,aAAa,EAAE,QAAQ,CAAA;QACpE,CAAC;aAAM,IAAI,GAAG,CAAC,WAAW,KAAK,mBAAmB,IAAI,qBAAqB,CAAC,MAAM,CAAC,KAAK,YAAY,EAAE,CAAC;YACrG,GAAG,GAAI,GAAqC,CAAC,aAAa,EAAE,QAAQ,CAAA;QACtE,CAAC;QACD,IAAI,CAAC,GAAG,EAAE,EAAE;YAAE,SAAQ;QACtB,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,IAAI,EAAE,CAAA;QACvD,IAAI,IAAI,KAAK,IAAI,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC;YAClC,IAAI,GAAG,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAA;YAC3C,MAAM,GAAG,EAAE,CAAA;QACb,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;mEAEmE;AACnE,MAAM,UAAU,iBAAiB,CAAC,MAAkB;IAClD,MAAM,GAAG,GAAG,MAAM,CAAC,aAAa,CAAA;IAChC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAA;IACrB,QAAQ,GAAG,CAAC,WAAW,EAAE,CAAC;QACxB,KAAK,mBAAmB,CAAC,CAAC,OAAQ,GAAqC,CAAC,aAAa,EAAE,IAAI,IAAI,IAAI,CAAA;QACnG,KAAK,iBAAiB,CAAC,CAAG,OAAQ,GAAmC,CAAC,aAAa,EAAE,IAAI,IAAI,IAAI,CAAA;QACjG,KAAK,gBAAgB,CAAC;QACtB,KAAK,cAAc,CAAC;QACpB,qEAAqE;QACrE,uEAAuE;QACvE,KAAK,iBAAiB,CAAC;QACvB,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,MAAM,GAAI,GAA6C,CAAC,aAAa,CAAA;YAC3E,OAAO,MAAM,EAAE,IAAI,IAAI,IAAI,CAAA;QAC7B,CAAC;QACD,OAAO,CAAC,CAAC,OAAO,IAAI,CAAA;IACtB,CAAC;AACH,CAAC"}