@drakkar.software/octobot-client 0.4.0

package/dist/node-api/pairs.js

@@ -0,0 +1,72 @@
+import { NodeHttpError } from '../transport/rest.js';
+import { fetchNodeTradedPairs, } from './exchanges.js';
+function numberOrUndefined(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function symbolToPair(symbol) {
+    const isSwap = symbol.includes(':');
+    const [pairPart] = symbol.split(':', 1);
+    const slashIdx = pairPart.indexOf('/');
+    const base = slashIdx >= 0 ? pairPart.slice(0, slashIdx) : pairPart;
+    const quote = slashIdx >= 0 ? pairPart.slice(slashIdx + 1) : '';
+    return { symbol, base, quote, type: isSwap ? 'swap' : 'spot', active: true };
+}
+/** Node's `traded-pairs` payload is untyped JSON — validate its actual shape
+ *  here rather than trusting the declared type at the call site, so a
+ *  mismatched/unexpected response throws a clear error instead of a bare "X
+ *  is not a function" once a non-string symbol reaches `symbolToPair`.
+ *
+ *  Two per-exchange shapes are accepted: the current symbol → volume map, and
+ *  the bare symbol array older nodes still answer. Anything else is a payload
+ *  we don't understand — throwing beats silently returning an empty list.
+ *
+ *  A symbol listed by more than one exchange yields one pair (the list is
+ *  keyed by symbol downstream), keeping the first volumes reported for it. */
+export function extractPairs(byExchange) {
+    if (byExchange == null || typeof byExchange !== 'object' || Array.isArray(byExchange)) {
+        throw new Error('Unexpected traded-pairs payload from node');
+    }
+    const bySymbol = new Map();
+    const add = (symbol, volume) => {
+        const known = bySymbol.get(symbol);
+        const pair = known ?? symbolToPair(symbol);
+        if (volume != null && typeof volume === 'object') {
+            const raw = volume;
+            pair.baseVolume = pair.baseVolume ?? numberOrUndefined(raw.baseVolume);
+            pair.quoteVolume = pair.quoteVolume ?? numberOrUndefined(raw.quoteVolume);
+        }
+        if (!known)
+            bySymbol.set(symbol, pair);
+    };
+    for (const value of Object.values(byExchange)) {
+        if (Array.isArray(value)) {
+            for (const entry of value) {
+                if (typeof entry === 'string')
+                    add(entry);
+            }
+            continue;
+        }
+        if (value == null || typeof value !== 'object')
+            continue;
+        for (const [symbol, volume] of Object.entries(value))
+            add(symbol, volume);
+    }
+    return [...bySymbol.values()];
+}
+/** Fetch and normalize the traded pairs for one exchange on one node. Falls
+ *  back to the volume-less request when the node can't fetch tickers for
+ *  this exchange (501) rather than surfacing no pairs at all. */
+export async function fetchPairsFromNode(node, providerId, signal) {
+    const exchange = { id: providerId, name: providerId, exchange: providerId };
+    let byExchange;
+    try {
+        byExchange = await fetchNodeTradedPairs(node, exchange, { withVolume: true, signal });
+    }
+    catch (err) {
+        if (!(err instanceof NodeHttpError) || err.status !== 501)
+            throw err;
+        byExchange = await fetchNodeTradedPairs(node, exchange, { signal });
+    }
+    return extractPairs(byExchange).sort((a, b) => a.symbol.localeCompare(b.symbol));
+}
+//# sourceMappingURL=pairs.js.map

package/dist/node-api/pairs.js.map

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

package/dist/node-api/requiredFunds.d.ts

@@ -0,0 +1,11 @@
+import type { MarketMakingConfiguration } from '@drakkar.software/octobot-protocol';
+import type { NodeEndpoint } from '../transport/urls.js';
+import type { ExchangeConfigParams } from './exchanges.js';
+import { type RequiredFundsResponse } from './marketMaking.js';
+export type { RequiredFundsResponse };
+/** `POST /api/v1/tentacles/market-making/` with `type: 'market_making_volume'`. */
+export declare function fetchRequiredFunds(node: NodeEndpoint, exchangeConfig: ExchangeConfigParams, marketMakingConfig: MarketMakingConfiguration, options?: {
+    signal?: AbortSignal;
+    fetch?: typeof fetch;
+}): Promise<RequiredFundsResponse>;
+//# sourceMappingURL=requiredFunds.d.ts.map

package/dist/node-api/requiredFunds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requiredFunds.d.ts","sourceRoot":"","sources":["../../src/node-api/requiredFunds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAA;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAC1D,OAAO,EAAoD,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAEhH,YAAY,EAAE,qBAAqB,EAAE,CAAA;AAErC,mFAAmF;AACnF,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,YAAY,EAClB,cAAc,EAAE,oBAAoB,EACpC,kBAAkB,EAAE,yBAAyB,EAC7C,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CAAO,GAC3D,OAAO,CAAC,qBAAqB,CAAC,CAGhC"}

package/dist/node-api/requiredFunds.js

@@ -0,0 +1,7 @@
+import { marketMakingRequestBody, postMarketMakingRequest } from './marketMaking.js';
+/** `POST /api/v1/tentacles/market-making/` with `type: 'market_making_volume'`. */
+export async function fetchRequiredFunds(node, exchangeConfig, marketMakingConfig, options = {}) {
+    const body = marketMakingRequestBody('market_making_volume', exchangeConfig, marketMakingConfig);
+    return postMarketMakingRequest(node, body, options);
+}
+//# sourceMappingURL=requiredFunds.js.map

package/dist/node-api/requiredFunds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requiredFunds.js","sourceRoot":"","sources":["../../src/node-api/requiredFunds.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAA8B,MAAM,mBAAmB,CAAA;AAIhH,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAkB,EAClB,cAAoC,EACpC,kBAA6C,EAC7C,UAA0D,EAAE;IAE5D,MAAM,IAAI,GAAG,uBAAuB,CAAC,sBAAsB,EAAE,cAAc,EAAE,kBAAkB,CAAC,CAAA;IAChG,OAAO,uBAAuB,CAAwB,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;AAC5E,CAAC"}

package/dist/node-api/setup.d.ts

@@ -0,0 +1,25 @@
+import type { NodeEndpoint } from '../transport/urls.js';
+import { type NodeCredentials } from '../transport/rest.js';
+/** A node's own copy of the wallet it runs on. `seed` is only set when that
+ *  wallet was created from a mnemonic; a node set up from a raw key has the
+ *  private key alone. Declared here rather than imported from
+ *  `@drakkar.software/octobot-protocol` because the node's setup routes are
+ *  not part of its generated model set. */
+export type NodeWalletExport = {
+    address: string;
+    private_key: string;
+    seed?: string | null;
+};
+/** `GET /api/v1/setup/wallet/export` — the wallet behind the credentials being
+ *  presented. Only a node paired by an older QR needs this: that code carried a
+ *  password rather than the wallet, so the wallet had to be fetched. A current
+ *  pairing code is read offline and never reaches here.
+ *
+ *  `NodeHttpError` statuses worth telling apart: 401 (wrong password, or the
+ *  node has no wallet for that address), 403 (asking for someone else's wallet
+ *  without being the admin), 503 (node not configured yet). */
+export declare function fetchNodeWalletExport(node: NodeEndpoint, credentials: NodeCredentials, options?: {
+    signal?: AbortSignal;
+    fetch?: typeof fetch;
+}): Promise<NodeWalletExport>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/node-api/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/node-api/setup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE5E;;;;2CAI2C;AAC3C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB,CAAA;AAED;;;;;;;+DAO+D;AAC/D,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,YAAY,EAClB,WAAW,EAAE,eAAe,EAC5B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CAAO,GAC3D,OAAO,CAAC,gBAAgB,CAAC,CAE3B"}

package/dist/node-api/setup.js

@@ -0,0 +1,13 @@
+import { nodeAuthRequest } from '../transport/rest.js';
+/** `GET /api/v1/setup/wallet/export` — the wallet behind the credentials being
+ *  presented. Only a node paired by an older QR needs this: that code carried a
+ *  password rather than the wallet, so the wallet had to be fetched. A current
+ *  pairing code is read offline and never reaches here.
+ *
+ *  `NodeHttpError` statuses worth telling apart: 401 (wrong password, or the
+ *  node has no wallet for that address), 403 (asking for someone else's wallet
+ *  without being the admin), 503 (node not configured yet). */
+export async function fetchNodeWalletExport(node, credentials, options = {}) {
+    return nodeAuthRequest(node, credentials, '/setup/wallet/export', options);
+}
+//# sourceMappingURL=setup.js.map

package/dist/node-api/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/node-api/setup.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAwB,MAAM,sBAAsB,CAAA;AAa5E;;;;;;;+DAO+D;AAC/D,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,IAAkB,EAClB,WAA4B,EAC5B,UAA0D,EAAE;IAE5D,OAAO,eAAe,CAAmB,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE,OAAO,CAAC,CAAA;AAC9F,CAAC"}

package/dist/node-api/wallet.d.ts

@@ -0,0 +1,55 @@
+import { type NodePairingPayload } from './pairing.js';
+import type { NodeWalletExport } from './setup.js';
+import { type ReadOnlyPairingPayload } from '../identity/pairing.js';
+import { type ActionProposal } from '../protocol/proposal.js';
+/** A wallet resolved from a node, ready to be stored.
+ *
+ *  `seed` is what the user backs up; `key` is what the app signs and encrypts
+ *  with. They differ whenever the phrase needs a derivation the app does not use
+ *  natively, which `derivation` records. */
+export type NodeWalletImport = {
+    seed: string;
+    keySource: 'mnemonic' | 'privateKey';
+    derivation: 'legacy' | 'bip44';
+    key?: string;
+};
+/** From a pairing QR's secret, which is the wallet itself — a BIP39 phrase, or a
+ *  0x private key when the node was set up from a raw key and has no mnemonic.
+ *  Null when it is neither, which has to fail the scan rather than quietly
+ *  produce a wallet nobody owns. */
+export declare function nodeWalletFromSecret(secret: string): Promise<NodeWalletImport | null>;
+/** From an older node's HTTP wallet export, which hands over both halves. The
+ *  node's own `private_key` is authoritative for the identity — nothing has to be
+ *  derived to get that right — but its mnemonic is worth keeping as the thing the
+ *  user backs up. Null when the export carries no usable key, which is a node
+ *  with nothing to import rather than a code that failed to decode. */
+export declare function nodeWalletFromExport(wallet: NodeWalletExport): Promise<NodeWalletImport | null>;
+/** The key material a resolved wallet is identified by. */
+export declare function nodeWalletKey(wallet: NodeWalletImport): string;
+/** What a code held up to a wallet scanner turned out to be. */
+export type ScannedCode = {
+    kind: 'node';
+    payload: NodePairingPayload;
+} | {
+    kind: 'octobotReadOnlyPairing';
+    payload: ReadOnlyPairingPayload;
+} | {
+    kind: 'octobotActionProposal';
+    payload: ActionProposal;
+} | {
+    kind: 'privateKey';
+    value: string;
+} | {
+    kind: 'seed';
+    value: string;
+} | {
+    kind: 'unknown';
+};
+/** Classify a scanned code. Node pairing JSON and the two octobot-client JSON
+ *  shapes (read-only pairing, action proposal) are checked first because
+ *  they're the most specific — each has its own `v`/`kind` discriminator and
+ *  throws immediately on anything else. A standalone envelope next, since its
+ *  field name says the value is key material; a bare code last, where the
+ *  shape is all there is to go on. */
+export declare function classifyScannedCode(data: string): Promise<ScannedCode>;
+//# sourceMappingURL=wallet.d.ts.map

package/dist/node-api/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/node-api/wallet.ts"],"names":[],"mappings":"AAWA,OAAO,EAAsB,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EAAwB,KAAK,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAC1F,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAEnF;;;;4CAI4C;AAC5C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,UAAU,GAAG,YAAY,CAAA;IACpC,UAAU,EAAE,QAAQ,GAAG,OAAO,CAAA;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;oCAGoC;AACpC,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAgB3F;AAED;;;;uEAIuE;AACvE,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAclC;AAED,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAE9D;AAED,gEAAgE;AAChE,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,OAAO,EAAE,sBAAsB,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAA;AAEvB;;;;;sCAKsC;AACtC,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAoB5E"}

package/dist/node-api/wallet.js

@@ -0,0 +1,87 @@
+// Turning what a node hands over into a wallet an app can hold.
+//
+// A node's mnemonic is real BIP44 (`web3.Account.create_with_mnemonic`),
+// which is also this package's only derivation scheme today — so importing
+// one is unambiguous. This file exists for the two cases that still need
+// their own handling: a raw key (no derivation at all — `derivation:
+// 'legacy'` here just means "the key IS the identity," not any specific
+// scheme) and an older node's HTTP export, which hands over both the phrase
+// and the key it must actually agree with.
+import { classifyBareSecret, classifySecret, readSecretEnvelope } from '../identity/secret.js';
+import { deriveBip44PrivateKey, isEvmPrivateKey, normalizeEvmPrivateKey } from '../identity/evm.js';
+import { parseNodePairingQr } from './pairing.js';
+import { parseReadOnlyPairing } from '../identity/pairing.js';
+import { decodeActionProposal } from '../protocol/proposal.js';
+/** From a pairing QR's secret, which is the wallet itself — a BIP39 phrase, or a
+ *  0x private key when the node was set up from a raw key and has no mnemonic.
+ *  Null when it is neither, which has to fail the scan rather than quietly
+ *  produce a wallet nobody owns. */
+export async function nodeWalletFromSecret(secret) {
+    const classified = await classifySecret(secret);
+    if (classified.kind === 'privateKey') {
+        // No derivation to get wrong: the key is the identity.
+        return { seed: classified.value, keySource: 'privateKey', derivation: 'legacy' };
+    }
+    if (classified.kind === 'seed') {
+        return {
+            seed: classified.value,
+            keySource: 'mnemonic',
+            derivation: 'bip44',
+            key: await deriveBip44PrivateKey(classified.value),
+        };
+    }
+    return null;
+}
+/** From an older node's HTTP wallet export, which hands over both halves. The
+ *  node's own `private_key` is authoritative for the identity — nothing has to be
+ *  derived to get that right — but its mnemonic is worth keeping as the thing the
+ *  user backs up. Null when the export carries no usable key, which is a node
+ *  with nothing to import rather than a code that failed to decode. */
+export async function nodeWalletFromExport(wallet) {
+    const key = normalizeEvmPrivateKey(wallet.private_key);
+    if (!isEvmPrivateKey(key))
+        return null;
+    // The phrase is only kept if it really does derive to the key the node signs
+    // with. Both come from one wallet object on the node, so they should always
+    // agree — but a phrase offered as a backup that restores a *different* account
+    // in another wallet is worse than offering no phrase at all, and this is the
+    // only place that can check rather than assume.
+    if (wallet.seed) {
+        const fromSeed = await nodeWalletFromSecret(wallet.seed);
+        if (fromSeed?.key === key)
+            return fromSeed;
+    }
+    return { seed: key, keySource: 'privateKey', derivation: 'legacy' };
+}
+/** The key material a resolved wallet is identified by. */
+export function nodeWalletKey(wallet) {
+    return wallet.key ?? wallet.seed;
+}
+/** Classify a scanned code. Node pairing JSON and the two octobot-client JSON
+ *  shapes (read-only pairing, action proposal) are checked first because
+ *  they're the most specific — each has its own `v`/`kind` discriminator and
+ *  throws immediately on anything else. A standalone envelope next, since its
+ *  field name says the value is key material; a bare code last, where the
+ *  shape is all there is to go on. */
+export async function classifyScannedCode(data) {
+    const payload = parseNodePairingQr(data);
+    if (payload)
+        return { kind: 'node', payload };
+    try {
+        return { kind: 'octobotReadOnlyPairing', payload: parseReadOnlyPairing(data) };
+    }
+    catch {
+        // not a read-only pairing payload — fall through
+    }
+    try {
+        return { kind: 'octobotActionProposal', payload: decodeActionProposal(data) };
+    }
+    catch {
+        // not an action proposal payload — fall through
+    }
+    const enveloped = readSecretEnvelope(data);
+    if (enveloped !== null)
+        return classifySecret(enveloped);
+    return classifyBareSecret(data);
+}
+//# sourceMappingURL=wallet.js.map

package/dist/node-api/wallet.js.map

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

package/dist/protocol/actions.d.ts

@@ -0,0 +1,40 @@
+import type { Strategy as ProtocolStrategy, CreateAutomationConfiguration, EditAutomationConfiguration, StopAutomationConfiguration, AutomationConfiguration, AccountAuthentication, ExchangeConfig, Account as ProtocolAccount, CreateAccountConfiguration, EditAccountConfiguration, DeleteAccountConfiguration, RefreshAccountsConfiguration, CreateAccountAuthConfiguration, EditAccountAuthConfiguration, DeleteAccountAuthConfiguration, CreateExchangeConfigConfiguration, EditExchangeConfigConfiguration, DeleteExchangeConfigConfiguration, CreateStrategyConfiguration, EditStrategyConfiguration, DeleteStrategyConfiguration } from '@drakkar.software/octobot-protocol';
+export type AutomationBuildInput = {
+    name: string;
+    description?: string;
+    strategy: ProtocolStrategy;
+    accountIds: string[];
+};
+/** A locally-generated id for a queued user action. Not the node's own id
+ *  scheme — just a client-side correlation handle for the outbox. */
+export declare function newUserActionId(): string;
+export declare function buildAutomationConfiguration(input: AutomationBuildInput): AutomationConfiguration;
+export declare function buildCreateAutomationConfig(input: AutomationBuildInput): CreateAutomationConfiguration;
+export declare function buildEditAutomationConfig(input: AutomationBuildInput & {
+    automationId: string;
+}): EditAutomationConfiguration;
+export declare function buildStopAutomationConfig(automationId: string): StopAutomationConfiguration;
+export declare function buildCreateStrategyConfig(strategy: ProtocolStrategy): CreateStrategyConfiguration;
+export declare function buildEditStrategyConfig(strategy: ProtocolStrategy): EditStrategyConfiguration;
+export declare function buildDeleteStrategyConfig(id: string): DeleteStrategyConfiguration;
+export declare function accountAuthIdFor(accountId: string): string;
+export declare function exchangeConfigIdFor(accountId: string): string;
+/** Reverse of `accountAuthIdFor` — recovers the account id an
+ *  account_auth_* action's own id refers to. Safe because that helper is the
+ *  only producer of `auth_*` ids. */
+export declare function accountIdFromAuthId(authId: string): string;
+/** Reverse of `exchangeConfigIdFor` — recovers the account id an
+ *  exchange_config_* action's own id refers to. Safe because that helper is
+ *  the only producer of `cfg_*` ids. */
+export declare function accountIdFromExchangeConfigId(configId: string): string;
+export declare function buildCreateAccountConfig(account: ProtocolAccount): CreateAccountConfiguration;
+export declare function buildEditAccountConfig(id: string, account?: ProtocolAccount): EditAccountConfiguration;
+export declare function buildDeleteAccountConfig(id: string): DeleteAccountConfiguration;
+export declare function buildRefreshAccountsConfig(accountIds?: string[]): RefreshAccountsConfiguration;
+export declare function buildCreateAccountAuthConfig(auth: AccountAuthentication): CreateAccountAuthConfiguration;
+export declare function buildEditAccountAuthConfig(auth: AccountAuthentication): EditAccountAuthConfiguration;
+export declare function buildDeleteAccountAuthConfig(id: string): DeleteAccountAuthConfiguration;
+export declare function buildCreateExchangeConfigConfig(config: ExchangeConfig): CreateExchangeConfigConfiguration;
+export declare function buildEditExchangeConfigConfig(config: ExchangeConfig): EditExchangeConfigConfiguration;
+export declare function buildDeleteExchangeConfigConfig(id: string): DeleteExchangeConfigConfiguration;
+//# sourceMappingURL=actions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/protocol/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,IAAI,gBAAgB,EAC5B,6BAA6B,EAC7B,2BAA2B,EAC3B,2BAA2B,EAC3B,uBAAuB,EACvB,qBAAqB,EACrB,cAAc,EACd,OAAO,IAAI,eAAe,EAC1B,0BAA0B,EAC1B,wBAAwB,EACxB,0BAA0B,EAC1B,4BAA4B,EAC5B,8BAA8B,EAC9B,4BAA4B,EAC5B,8BAA8B,EAC9B,iCAAiC,EACjC,+BAA+B,EAC/B,iCAAiC,EACjC,2BAA2B,EAC3B,yBAAyB,EACzB,2BAA2B,EAC5B,MAAM,oCAAoC,CAAA;AAE3C,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB,CAAA;AAED;qEACqE;AACrE,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,oBAAoB,GAAG,uBAAuB,CAUjG;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,oBAAoB,GAAG,6BAA6B,CAKtG;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,oBAAoB,GAAG;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,2BAA2B,CAM7H;AAED,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,2BAA2B,CAK3F;AAOD,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,2BAA2B,CAEjG;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,yBAAyB,CAE7F;AAED,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,MAAM,GAAG,2BAA2B,CAEjF;AAWD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;qCAEqC;AACrC,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;wCAEwC;AACxC,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,eAAe,GAAG,0BAA0B,CAK7F;AAED,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,wBAAwB,CAMtG;AAED,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,MAAM,GAAG,0BAA0B,CAK/E;AAED,wBAAgB,0BAA0B,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,4BAA4B,CAK9F;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,qBAAqB,GAAG,8BAA8B,CAExG;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,qBAAqB,GAAG,4BAA4B,CAEpG;AAED,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,MAAM,GAAG,8BAA8B,CAEvF;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,cAAc,GAAG,iCAAiC,CAEzG;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,cAAc,GAAG,+BAA+B,CAErG;AAED,wBAAgB,+BAA+B,CAAC,EAAE,EAAE,MAAM,GAAG,iCAAiC,CAE7F"}

package/dist/protocol/actions.js

@@ -0,0 +1,118 @@
+/** A locally-generated id for a queued user action. Not the node's own id
+ *  scheme — just a client-side correlation handle for the outbox. */
+export function newUserActionId() {
+    return `ua_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+}
+export function buildAutomationConfiguration(input) {
+    const now = new Date().toISOString();
+    return {
+        name: input.name,
+        description: input.description,
+        created_at: now,
+        updated_at: now,
+        strategy: { id: input.strategy.id, version: input.strategy.version, emit_signals: false },
+        accounts: input.accountIds.map((id) => ({ id })),
+    };
+}
+export function buildCreateAutomationConfig(input) {
+    return {
+        action_type: 'automation_create',
+        configuration: buildAutomationConfiguration(input),
+    };
+}
+export function buildEditAutomationConfig(input) {
+    return {
+        id: input.automationId,
+        action_type: 'automation_edit',
+        configuration: buildAutomationConfiguration(input),
+    };
+}
+export function buildStopAutomationConfig(automationId) {
+    return {
+        id: automationId,
+        action_type: 'automation_stop',
+    };
+}
+// ── Strategy user-actions (protocol 0.4.0) ───────────────────────────────────
+// The node's StrategyProvider is populated ONLY by strategy user actions — a
+// client push of the strategies collection is opaque dead data to it, and
+// automation_create loads the strategy from the provider by (id, version).
+export function buildCreateStrategyConfig(strategy) {
+    return { action_type: 'strategy_create', configuration: strategy };
+}
+export function buildEditStrategyConfig(strategy) {
+    return { id: strategy.id, action_type: 'strategy_edit', configuration: strategy };
+}
+export function buildDeleteStrategyConfig(id) {
+    return { id, action_type: 'strategy_delete' };
+}
+// ── Account user-actions (protocol 0.4.0 graph) ──────────────────────────────
+// 0.4.0 splits an account across three node-side items: credentials live in
+// AccountAuthentication (account_auth_* actions), the venue in ExchangeConfig
+// (exchange_config_* actions), and the Account itself only references them
+// (authentication_id + specifics.exchange_config_ids). Ids are DERIVED from
+// the account id so edits and deletes can address the graph without storing
+// extra local fields. The node does not cascade deletes — the client emits
+// the auth/config deletes itself.
+export function accountAuthIdFor(accountId) {
+    return `auth_${accountId}`;
+}
+export function exchangeConfigIdFor(accountId) {
+    return `cfg_${accountId}`;
+}
+/** Reverse of `accountAuthIdFor` — recovers the account id an
+ *  account_auth_* action's own id refers to. Safe because that helper is the
+ *  only producer of `auth_*` ids. */
+export function accountIdFromAuthId(authId) {
+    return authId.startsWith('auth_') ? authId.slice('auth_'.length) : authId;
+}
+/** Reverse of `exchangeConfigIdFor` — recovers the account id an
+ *  exchange_config_* action's own id refers to. Safe because that helper is
+ *  the only producer of `cfg_*` ids. */
+export function accountIdFromExchangeConfigId(configId) {
+    return configId.startsWith('cfg_') ? configId.slice('cfg_'.length) : configId;
+}
+export function buildCreateAccountConfig(account) {
+    return {
+        action_type: 'account_create',
+        configuration: account,
+    };
+}
+export function buildEditAccountConfig(id, account) {
+    return {
+        id,
+        action_type: 'account_edit',
+        configuration: account,
+    };
+}
+export function buildDeleteAccountConfig(id) {
+    return {
+        id,
+        action_type: 'account_delete',
+    };
+}
+export function buildRefreshAccountsConfig(accountIds) {
+    return {
+        action_type: 'accounts_refresh',
+        ...(accountIds ? { account_ids: accountIds } : {}),
+    };
+}
+export function buildCreateAccountAuthConfig(auth) {
+    return { action_type: 'account_auth_create', configuration: auth };
+}
+export function buildEditAccountAuthConfig(auth) {
+    return { id: auth.id, action_type: 'account_auth_edit', configuration: auth };
+}
+export function buildDeleteAccountAuthConfig(id) {
+    return { id, action_type: 'account_auth_delete' };
+}
+export function buildCreateExchangeConfigConfig(config) {
+    return { action_type: 'exchange_config_create', configuration: config };
+}
+export function buildEditExchangeConfigConfig(config) {
+    return { id: config.id, action_type: 'exchange_config_edit', configuration: config };
+}
+export function buildDeleteExchangeConfigConfig(id) {
+    return { id, action_type: 'exchange_config_delete' };
+}
+//# sourceMappingURL=actions.js.map

package/dist/protocol/actions.js.map

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

package/dist/protocol/documents.d.ts

@@ -0,0 +1,25 @@
+import type { AutomationState, UserAction, AccountTradingWithAccountId } from '@drakkar.software/octobot-protocol';
+/** What the node computes at `users/{identity}/data` on every pull. A caller
+ *  with its own local document that stores additional fields in the same
+ *  blob (a dashboard cache, say) should intersect its own type with this
+ *  one rather than redeclaring `automations`/`user_actions`. */
+export type UserDataState = {
+    automations: AutomationState[];
+    user_actions: UserAction[];
+};
+/** What the node returns at `users/{identity}/accounts` — pull-only, the
+ *  node never accepts a push for this document. */
+export type AccountsState = {
+    accounts?: unknown[];
+    exchange_configs?: unknown[];
+};
+/** `users/{identity}/actions` — append-only, push-only. Wire elements only;
+ *  a caller's own local queue mirror is a different, larger shape. */
+export type UserActionsDocument = {
+    version?: string;
+    items: UserAction[];
+};
+/** `users/{identity}/accounts/{accountId}/trading` — one document per
+ *  account; there is no single "list every account's trading doc" pull. */
+export type AccountTradingDocument = AccountTradingWithAccountId;
+//# sourceMappingURL=documents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/protocol/documents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,2BAA2B,EAC5B,MAAM,oCAAoC,CAAA;AAE3C;;;gEAGgE;AAChE,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,EAAE,eAAe,EAAE,CAAA;IAC9B,YAAY,EAAE,UAAU,EAAE,CAAA;CAC3B,CAAA;AAED;mDACmD;AACnD,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;IACpB,gBAAgB,CAAC,EAAE,OAAO,EAAE,CAAA;CAC7B,CAAA;AAED;sEACsE;AACtE,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,UAAU,EAAE,CAAA;CACpB,CAAA;AAED;2EAC2E;AAC3E,MAAM,MAAM,sBAAsB,GAAG,2BAA2B,CAAA"}

package/dist/protocol/documents.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=documents.js.map

package/dist/protocol/documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.js","sourceRoot":"","sources":["../../src/protocol/documents.ts"],"names":[],"mappings":""}

package/dist/protocol/index.d.ts

@@ -0,0 +1,10 @@
+export { protocolStrategyKind, parseNodeAutomationStates, parseNodeUserActions, workflowStatusToAutomationStatus, automationErrorOf, normalizeNodeAssets, automationHoldings, parseNodeAccounts, parseNodeExchangeConfigs, accountHoldingsFromNodeState, automationResultOf, accountResultOf, actionErrorDetails, createdAutomationIdOf, createdAccountIdOf, actionDomainOf, targetAutomationIdOf, targetAccountIdsOf, actionTargetsAccount, automationStrategyRefOf, actionDisplayName, isRecord, cachedByDoc, type AutomationRunStatus, type Holding, type UserActionDomain, } from './state.js';
+export { newUserActionId, buildAutomationConfiguration, buildCreateAutomationConfig, buildEditAutomationConfig, buildStopAutomationConfig, buildCreateStrategyConfig, buildEditStrategyConfig, buildDeleteStrategyConfig, accountAuthIdFor, exchangeConfigIdFor, accountIdFromAuthId, accountIdFromExchangeConfigId, buildCreateAccountConfig, buildEditAccountConfig, buildDeleteAccountConfig, buildRefreshAccountsConfig, buildCreateAccountAuthConfig, buildEditAccountAuthConfig, buildDeleteAccountAuthConfig, buildCreateExchangeConfigConfig, buildEditExchangeConfigConfig, buildDeleteExchangeConfigConfig, type AutomationBuildInput, } from './actions.js';
+export * as strategy from './strategy/index.js';
+export * from './strategy/index.js';
+export { baseCurrencyOf } from './symbols.js';
+export { sleep, pollDelay } from './poll.js';
+export { type UserDataState, type AccountsState, type UserActionsDocument, type AccountTradingDocument, } from './documents.js';
+export { runCreateAutomation, AutomationActionFailedError, AutomationTimeoutError, type ActionEmitter, type CreateAutomationInput, type CreateAutomationProgress, } from './orchestration/createAutomation.js';
+export { encodeActionProposal, decodeActionProposal, type ActionProposal, type ProposedActionEntry, } from './proposal.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,EACpB,gCAAgC,EAChC,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,4BAA4B,EAC5B,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,QAAQ,EACR,WAAW,EACX,KAAK,mBAAmB,EACxB,KAAK,OAAO,EACZ,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,eAAe,EACf,4BAA4B,EAC5B,2BAA2B,EAC3B,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACvB,yBAAyB,EACzB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,6BAA6B,EAC7B,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,4BAA4B,EAC5B,+BAA+B,EAC/B,6BAA6B,EAC7B,+BAA+B,EAC/B,KAAK,oBAAoB,GAC1B,MAAM,cAAc,CAAA;AACrB,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAA;AAI/C,cAAc,qBAAqB,CAAA;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,sBAAsB,EACtB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,GAC9B,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAA"}

package/dist/protocol/index.js

@@ -0,0 +1,12 @@
+export { protocolStrategyKind, parseNodeAutomationStates, parseNodeUserActions, workflowStatusToAutomationStatus, automationErrorOf, normalizeNodeAssets, automationHoldings, parseNodeAccounts, parseNodeExchangeConfigs, accountHoldingsFromNodeState, automationResultOf, accountResultOf, actionErrorDetails, createdAutomationIdOf, createdAccountIdOf, actionDomainOf, targetAutomationIdOf, targetAccountIdsOf, actionTargetsAccount, automationStrategyRefOf, actionDisplayName, isRecord, cachedByDoc, } from './state.js';
+export { newUserActionId, buildAutomationConfiguration, buildCreateAutomationConfig, buildEditAutomationConfig, buildStopAutomationConfig, buildCreateStrategyConfig, buildEditStrategyConfig, buildDeleteStrategyConfig, accountAuthIdFor, exchangeConfigIdFor, accountIdFromAuthId, accountIdFromExchangeConfigId, buildCreateAccountConfig, buildEditAccountConfig, buildDeleteAccountConfig, buildRefreshAccountsConfig, buildCreateAccountAuthConfig, buildEditAccountAuthConfig, buildDeleteAccountAuthConfig, buildCreateExchangeConfigConfig, buildEditExchangeConfigConfig, buildDeleteExchangeConfigConfig, } from './actions.js';
+export * as strategy from './strategy/index.js';
+// Flat re-exports of every symbol the `strategy` namespace above holds — for
+// a caller that wants `buildStrategy(...)` directly rather than
+// `strategy.buildStrategy(...)`.
+export * from './strategy/index.js';
+export { baseCurrencyOf } from './symbols.js';
+export { sleep, pollDelay } from './poll.js';
+export { runCreateAutomation, AutomationActionFailedError, AutomationTimeoutError, } from './orchestration/createAutomation.js';
+export { encodeActionProposal, decodeActionProposal, } from './proposal.js';
+//# sourceMappingURL=index.js.map

package/dist/protocol/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,EACpB,gCAAgC,EAChC,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,4BAA4B,EAC5B,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,QAAQ,EACR,WAAW,GAIZ,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,eAAe,EACf,4BAA4B,EAC5B,2BAA2B,EAC3B,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACvB,yBAAyB,EACzB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,6BAA6B,EAC7B,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,4BAA4B,EAC5B,+BAA+B,EAC/B,6BAA6B,EAC7B,+BAA+B,GAEhC,MAAM,cAAc,CAAA;AACrB,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAA;AAC/C,6EAA6E;AAC7E,gEAAgE;AAChE,iCAAiC;AACjC,cAAc,qBAAqB,CAAA;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAO5C,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,sBAAsB,GAIvB,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GAGrB,MAAM,eAAe,CAAA"}

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

@@ -0,0 +1,61 @@
+import type { UserAction, UserActionConfiguration } from '@drakkar.software/octobot-protocol';
+import { type AutomationBuildInput } from '../actions.js';
+/** What `runCreateAutomation` needs from its caller: a way to push one action
+ *  onto the node's queue, and a way to learn the node's current view of
+ *  every queued action (draining any outbox first, if the caller has one).
+ *  `connectOctoBot()`'s facade wires this to a direct append + pull;
+ *  `octobot-sdk`'s offline engine wires it to its outbox + CRDT store — same
+ *  state machine, two very different delivery mechanisms underneath. */
+export type ActionEmitter = {
+    /** Emit one action's wire configuration. Returns its (client-assigned) id. */
+    emit: (configuration: UserActionConfiguration) => Promise<string>;
+    /** Deliver anything not yet sent, then return the node's current view of
+     *  every user action (from the latest `user-data` pull). Called once per
+     *  poll tick. */
+    poll: () => Promise<UserAction[]>;
+};
+export type CreateAutomationInput = AutomationBuildInput;
+export type CreateAutomationProgress = {
+    phase: 'strategy' | 'automation';
+    done: boolean;
+};
+export type CreateAutomationOptions = {
+    /** Total budget across BOTH phases. Default 60_000. */
+    timeoutMs?: number;
+    /** Default: the node's own confirmed cadence, min(2000 + n*1500, 8000). */
+    pollDelay?: (attempt: number) => number;
+    signal?: AbortSignal;
+    onProgress?: (p: CreateAutomationProgress) => void;
+};
+/** A specific action the node executed and rejected. Not retriable by
+ *  resubmitting the same configuration unchanged. */
+export declare class AutomationActionFailedError extends Error {
+    readonly phase: 'strategy' | 'automation';
+    readonly detail: string | null;
+    constructor(phase: 'strategy' | 'automation', detail: string | null);
+}
+/** Neither phase failed outright — the node just never confirmed within the
+ *  budget. Worth a fresh `runCreateAutomation` call, not a resubmit. */
+export declare class AutomationTimeoutError extends Error {
+    readonly phase: 'strategy' | 'automation';
+    constructor(phase: 'strategy' | 'automation');
+}
+/**
+ * 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 declare function runCreateAutomation(io: ActionEmitter, input: CreateAutomationInput, opts?: CreateAutomationOptions): Promise<{
+    automationId: string | null;
+}>;
+//# sourceMappingURL=createAutomation.d.ts.map