@heyamiko/openclaw-amiko 0.2.0

package/README.md

@@ -0,0 +1,184 @@
+# @heyamiko/openclaw-amiko
+
+An [OpenClaw](https://openclaw.dev) channel plugin that connects your OpenClaw agent to [Amiko](https://heyamiko.com), enabling direct and group chat via webhook.
+
+## Overview
+
+This plugin registers an `amiko` channel with OpenClaw and provides:
+
+- **Direct messages** — receive and reply to 1:1 DMs from Amiko users
+- **Group chat** — participate in Amiko group conversations (mention-triggered)
+- **Shared account** — agent replies on behalf of its owner in conversations
+- **Feed comments** — agent comments on friends' posts (as draft, pending owner review)
+- **Webhook delivery** — inbound messages arrive via HTTP webhook (no polling)
+- **Context injection** — when auto-reply is off, messages are injected into agent context via `chat.inject` (no response generated)
+- **Multi-account support** — configure multiple twins under a single plugin
+- **Conversation-scoped delivery** — Amiko decides which conversations are routed to the plugin
+
+## Repository Structure
+
+```
+index.ts                  Plugin entry point (exported default)
+src/
+  channel.ts              ChannelPlugin definition
+  monitor.ts              Webhook inbound monitor (chat + post events)
+  accounts.ts             Account resolution (single + multi-account)
+  api.ts                  HTTP client for Amiko platform API
+  send.ts                 Outbound sendText / sendMedia
+  status.ts               Health probe + account inspection
+  runtime.ts              PluginRuntime singleton
+  config-schema.ts        Zod schema for channels.amiko config
+  types.ts                Domain types
+contracts/                JSON Schemas for API payloads
+```
+
+## Requirements
+
+- [Node.js](https://nodejs.org) >= 18
+- [OpenClaw](https://openclaw.dev) installed and configured
+- [pnpm](https://pnpm.io) >= 8 for local development only
+
+## Installation
+
+### 1. Install from npm
+
+```bash
+npm install -g @heyamiko/openclaw-amiko
+```
+
+Or install directly through OpenClaw:
+
+```bash
+openclaw plugins install @heyamiko/openclaw-amiko
+```
+
+### 2. Obtain your Twin Token
+
+The `token` is a **Twin Token** (JWT with `clawd-` prefix) that identifies the twin on the Amiko platform. It is used to authenticate API calls this plugin makes to amiko-chat.
+
+To get a token:
+1. Log in to the Amiko platform at `https://platform.heyamiko.com` and go to your agent's deploy page.
+2. The twin token is generated when the agent is deployed.
+3. Keep the token secret — treat it like a password.
+
+> **Note:** The account key in `channels.amiko.accounts` should be the OpenClaw agent ID, such as `main` or `agent-foo`. Put the actual Amiko twin ID in `twinId`.
+
+### 3. Configure the channel
+
+Add the following to your OpenClaw config (`~/.openclaw/openclaw.json`):
+
+```json5
+{
+  "channels": {
+    "amiko": {
+      "defaultAccount": "main",
+      "accounts": {
+        "main": {
+          "twinId": "<primaryTwinId>",
+          "token": "clawd-eyJhbGciOi...",
+          "platformApiBaseUrl": "https://platform.heyamiko.com",
+          "chatApiBaseUrl": "https://your-amiko-chat.up.railway.app",
+          "webhookPath": "/amiko/webhook/<primaryTwinId>"
+        }
+      }
+    }
+  }
+}
+```
+
+**Fields:**
+
+| Field | Required | Default | Description |
+|-------|----------|---------|-------------|
+| `twinId` | Yes | — | Amiko twin ID for this OpenClaw agent |
+| `token` | Yes | — | Twin token (`clawd-` prefix JWT) |
+| `platformApiBaseUrl` | No | `https://platform.heyamiko.com` | Base URL for `amiko-new` / platform API |
+| `chatApiBaseUrl` | No | `https://api.amiko.app` | Base URL for amiko-chat internal channel API |
+| `apiBaseUrl` | Legacy | — | Backward-compatible fallback URL. Prefer the two explicit URLs above |
+| `webhookPath` | No | `/amiko/webhook/<twinId>` | Inbound webhook path |
+| `webhookSecret` | No | — | HMAC-SHA256 secret for webhook validation |
+
+For multiple twins:
+
+```json5
+{
+  "channels": {
+    "amiko": {
+      "defaultAccount": "main",
+      "accounts": {
+        "main": {
+          "twinId": "<twinId1>",
+          "token": "clawd-...",
+          "platformApiBaseUrl": "https://platform.heyamiko.com",
+          "chatApiBaseUrl": "https://your-amiko-chat.up.railway.app"
+        },
+        "agent-foo": {
+          "twinId": "<twinId2>",
+          "token": "clawd-...",
+          "platformApiBaseUrl": "https://platform.heyamiko.com",
+          "chatApiBaseUrl": "https://your-amiko-chat.up.railway.app"
+        }
+      }
+    }
+  }
+}
+```
+
+Each configured twin gets its own webhook endpoint at `/amiko/webhook/<twinId>` by default. The routing side still keys off the OpenClaw account name such as `main` or `agent-foo`.
+
+OpenClaw routing must also bind each agent to the matching Amiko account key. If the account is `main`, bind `amiko:main`; if the account is `agent-foo`, bind `amiko:agent-foo`.
+
+Examples:
+
+```bash
+openclaw agents add main --bind amiko:main
+openclaw agents add agent-foo --bind amiko:agent-foo
+```
+
+If the agent already exists, make sure `agents.entries.<agentId>.routing.bindings` in `~/.openclaw/openclaw.json` contains the same `amiko:<accountId>` value.
+
+### 4. Restart the gateway
+
+```bash
+openclaw gateway restart
+```
+
+The Amiko channel will be loaded and the webhook endpoint will be active.
+
+### Verify channel health
+
+After restarting, check that the channel is healthy:
+
+```bash
+openclaw channel status amiko
+```
+
+- `healthy` — token is valid and the Amiko API is reachable
+- `unconfigured` — `token` is missing from config (set it and restart)
+- `unhealthy` — token is set but the API returned an error (check token validity)
+
+## Webhook Events
+
+The plugin handles two event types on the same webhook endpoint:
+
+| Event | Source | Behavior |
+|-------|--------|----------|
+| `message.text` | amiko-chat | Chat message. `replyExpected=true` → agent responds. `replyExpected=false` → `chat.inject` (context only). |
+| `post.published` | amiko-new | Friend posted. Agent decides to comment (draft) or skip (`<empty-response/>`). |
+
+## Development
+
+### Local development setup
+
+```bash
+git clone https://github.com/HCF-S/openclaw-amiko-plugin
+cd openclaw-amiko-plugin
+pnpm install
+pnpm run build
+```
+
+### Type check
+
+```bash
+pnpm run typecheck
+```

package/contracts/channel-config.schema.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openclaw.dev/schemas/amiko/channel-config.schema.json",
+  "title": "AmikoChannelConfig",
+  "description": "Schema for channels.amiko in OpenClaw config. OCP-001.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "token": {
+      "type": "string",
+      "description": "Bearer token for amiko-platform API authentication. Sensitive.",
+      "uiHints": { "sensitive": true }
+    },
+    "twinId": {
+      "type": "string",
+      "description": "Amiko twin ID used by this account."
+    },
+    "platformApiBaseUrl": {
+      "type": "string",
+      "format": "uri",
+      "description": "Base URL of amiko-new / platform API.",
+      "default": "https://platform.heyamiko.com"
+    },
+    "chatApiBaseUrl": {
+      "type": "string",
+      "format": "uri",
+      "description": "Base URL of amiko-chat internal channel API.",
+      "default": "https://api.amiko.app"
+    },
+    "apiBaseUrl": {
+      "type": "string",
+      "format": "uri",
+      "description": "Legacy fallback URL. Prefer platformApiBaseUrl and chatApiBaseUrl."
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable account label."
+    },
+    "enabled": {
+      "type": "boolean",
+      "description": "Whether this account is active. Defaults to true.",
+      "default": true
+    },
+    "pollIntervalMs": {
+      "type": "integer",
+      "minimum": 1000,
+      "maximum": 60000,
+      "description": "Polling interval in milliseconds.",
+      "default": 3000
+    },
+    "pollTimeoutMs": {
+      "type": "integer",
+      "minimum": 1000,
+      "maximum": 30000,
+      "description": "Per-request HTTP timeout in milliseconds.",
+      "default": 10000
+    },
+    "defaultAccount": {
+      "type": "string",
+      "description": "Which OpenClaw agent/account key to treat as default in multi-account mode."
+    },
+    "accounts": {
+      "type": "object",
+      "description": "Per-account config overrides keyed by OpenClaw agent ID (for example main, agent-foo).",
+      "additionalProperties": {
+        "$ref": "#/$defs/AmikoAccountConfig"
+      }
+    }
+  },
+  "$defs": {
+    "AmikoAccountConfig": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "token": { "type": "string", "uiHints": { "sensitive": true } },
+        "twinId": { "type": "string" },
+        "platformApiBaseUrl": { "type": "string", "format": "uri" },
+        "chatApiBaseUrl": { "type": "string", "format": "uri" },
+        "apiBaseUrl": { "type": "string", "format": "uri" },
+        "name": { "type": "string" },
+        "enabled": { "type": "boolean" },
+        "pollIntervalMs": { "type": "integer", "minimum": 1000, "maximum": 60000 },
+        "pollTimeoutMs": { "type": "integer", "minimum": 1000, "maximum": 30000 }
+      }
+    }
+  }
+}

package/contracts/platform-ack.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openclaw.dev/schemas/amiko/platform-ack.schema.json",
+  "title": "AmikoAckPayload",
+  "description": "Request body schema for POST /internal/openclaw/amiko/acks. OCP-002.",
+  "type": "object",
+  "required": ["accountId", "cursor", "eventIds"],
+  "additionalProperties": false,
+  "properties": {
+    "accountId": {
+      "type": "string",
+      "description": "Account scope. Must match the Bearer token's account."
+    },
+    "cursor": {
+      "type": "string",
+      "description": "Cursor of the last event in the acknowledged batch."
+    },
+    "eventIds": {
+      "type": "array",
+      "items": { "type": "string" },
+      "minItems": 1,
+      "description": "IDs of all events in the acknowledged batch."
+    }
+  }
+}

package/contracts/platform-events.schema.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openclaw.dev/schemas/amiko/platform-events.schema.json",
+  "title": "AmikoEventsResponse",
+  "description": "Response schema for GET /internal/openclaw/amiko/events. OCP-002.",
+  "type": "object",
+  "required": ["events", "nextCursor", "hasMore"],
+  "additionalProperties": false,
+  "properties": {
+    "events": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/AmikoInboundEvent" }
+    },
+    "nextCursor": {
+      "type": ["string", "null"],
+      "description": "Cursor to use in the next poll. Null when no events returned."
+    },
+    "hasMore": {
+      "type": "boolean",
+      "description": "True if more events exist beyond the returned limit."
+    }
+  },
+  "$defs": {
+    "AmikoInboundEvent": {
+      "type": "object",
+      "required": ["id", "type", "accountId", "conversationId", "conversationType", "senderId", "senderName", "timestamp", "cursor"],
+      "additionalProperties": true,
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Stable globally unique event ID for deduplication."
+        },
+        "type": {
+          "type": "string",
+          "enum": ["message.text", "message.image", "participant.added"],
+          "description": "Event type."
+        },
+        "accountId": {
+          "type": "string",
+          "description": "Account this event belongs to."
+        },
+        "conversationId": {
+          "type": "string",
+          "description": "Platform conversation identifier."
+        },
+        "conversationType": {
+          "type": "string",
+          "enum": ["direct", "group"],
+          "description": "Direct or group conversation."
+        },
+        "senderId": {
+          "type": "string",
+          "description": "Platform user ID of the sender."
+        },
+        "senderName": {
+          "type": "string",
+          "description": "Display name of the sender at send time."
+        },
+        "timestamp": {
+          "type": "integer",
+          "description": "Unix timestamp in milliseconds."
+        },
+        "cursor": {
+          "type": "string",
+          "description": "Monotonic cursor value for this event."
+        },
+        "text": {
+          "type": "string",
+          "description": "Message text body. Present for message.text type."
+        },
+        "mediaUrl": {
+          "type": "string",
+          "format": "uri",
+          "description": "Signed media URL. Present for message.image type."
+        },
+        "mediaCaption": {
+          "type": "string",
+          "description": "Optional caption for media messages."
+        },
+        "mentionsBot": {
+          "type": "boolean",
+          "description": "True if the message includes a @mention of the bot. Used for group routing."
+        }
+      }
+    }
+  }
+}

package/contracts/platform-outbound.schema.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openclaw.dev/schemas/amiko/platform-outbound.schema.json",
+  "title": "AmikoOutboundPayload",
+  "description": "Request body schema for POST /internal/openclaw/amiko/messages. OCP-002.",
+  "type": "object",
+  "required": ["accountId", "conversationId", "idempotencyKey", "type", "text"],
+  "additionalProperties": false,
+  "properties": {
+    "accountId": {
+      "type": "string",
+      "description": "Account scope. Must match the Bearer token's account."
+    },
+    "conversationId": {
+      "type": "string",
+      "description": "Target conversation for delivery."
+    },
+    "idempotencyKey": {
+      "type": "string",
+      "description": "Client-generated key for deduplication. Format: <accountId>:<conversationId>:<uuid-v4>."
+    },
+    "type": {
+      "type": "string",
+      "enum": ["text", "media"],
+      "description": "Message type."
+    },
+    "text": {
+      "type": "string",
+      "description": "Message text content. For type=media, used as caption fallback."
+    },
+    "mediaUrl": {
+      "type": "string",
+      "format": "uri",
+      "description": "Media URL. Required when type=media."
+    },
+    "mediaCaption": {
+      "type": "string",
+      "description": "Optional caption for media messages."
+    }
+  },
+  "if": {
+    "properties": { "type": { "const": "media" } }
+  },
+  "then": {
+    "required": ["mediaUrl"]
+  }
+}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+declare const _default: {
+    id: string;
+    name: string;
+    description: string;
+    configSchema: {};
+    register(api: {
+        runtime: any;
+        config?: any;
+        registerChannel: (params: {
+            plugin: any;
+        }) => void;
+        registerHttpRoute?: (params: any) => void;
+        registerHttpHandler?: (handler: (req: any, res: any) => boolean | Promise<boolean>) => void;
+    }): void;
+};
+export default _default;
+export { amikoPlugin } from "./src/channel.js";
+export { setAmikoRuntime, getAmikoRuntime } from "./src/runtime.js";
+export type { ResolvedAmikoAccount, AmikoConfig, AmikoAccountConfig } from "./src/types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;kBAWgB;QACZ,OAAO,EAAE,GAAG,CAAC;QACb,MAAM,CAAC,EAAE,GAAG,CAAC;QACb,eAAe,EAAE,CAAC,MAAM,EAAE;YAAE,MAAM,EAAE,GAAG,CAAA;SAAE,KAAK,IAAI,CAAC;QACnD,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC;QAC1C,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;KAC7F;;AAbH,wBA8DE;AAGF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACpE,YAAY,EAAE,oBAAoB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,61 @@
+import { listAmikoAccountIds, resolveAmikoAccount } from "./src/accounts.js";
+import { amikoPlugin } from "./src/channel.js";
+import { dispatchWebhookRequest, setAmikoRuntime } from "./src/runtime.js";
+export default {
+    id: "amiko",
+    name: "Amiko",
+    description: "Connect OpenClaw bot to Amiko platform (direct and group chat via webhook)",
+    configSchema: {},
+    register(api) {
+        setAmikoRuntime(api.runtime);
+        api.registerChannel({ plugin: amikoPlugin });
+        const sendChannelNotStarted = (res) => {
+            const json = JSON.stringify({ ok: false, error: "Amiko channel not started yet" });
+            res.statusCode = 503;
+            res.setHeader("Content-Type", "application/json");
+            res.setHeader("Content-Length", Buffer.byteLength(json));
+            res.end(json);
+        };
+        const registeredPaths = new Set();
+        const cfg = api.config ?? {};
+        for (const accountId of listAmikoAccountIds(cfg)) {
+            try {
+                const account = resolveAmikoAccount({ cfg, accountId });
+                const webhookPath = account.config.webhookPath ?? `/amiko/webhook/${account.twinId}`;
+                if (registeredPaths.has(webhookPath))
+                    continue;
+                registeredPaths.add(webhookPath);
+                api.registerHttpRoute?.({
+                    path: webhookPath,
+                    auth: "plugin",
+                    match: "exact",
+                    replaceExisting: true,
+                    handler: async (req, res) => {
+                        const handled = await dispatchWebhookRequest(req, res);
+                        if (handled)
+                            return true;
+                        sendChannelNotStarted(res);
+                        return true;
+                    },
+                });
+            }
+            catch {
+                // Skip malformed accounts; startAccount/status will surface the real error.
+            }
+        }
+        api.registerHttpHandler?.(async (req, res) => {
+            const handled = await dispatchWebhookRequest(req, res);
+            if (handled)
+                return true;
+            const pathname = new URL(req.url ?? "/", "http://localhost").pathname;
+            if (!pathname.startsWith("/amiko/webhook/"))
+                return false;
+            sendChannelNotStarted(res);
+            return true;
+        });
+    },
+};
+// Named exports for programmatic use
+export { amikoPlugin } from "./src/channel.js";
+export { setAmikoRuntime, getAmikoRuntime } from "./src/runtime.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/src/accounts.d.ts

@@ -0,0 +1,30 @@
+import type { AmikoConfig, AmikoAccountConfig, ResolvedAmikoAccount } from "./types.js";
+export declare const DEFAULT_ACCOUNT_ID = "main";
+export declare const DEFAULT_PLATFORM_API_BASE_URL = "https://platform.heyamiko.com";
+export declare const DEFAULT_CHAT_API_BASE_URL = "https://api.amiko.app";
+export declare function normalizeAccountId(id: string): string;
+export declare function listAmikoAccountIds(cfg: {
+    channels?: {
+        amiko?: AmikoConfig;
+    };
+}): string[];
+export declare function resolveDefaultAmikoAccountId(cfg: {
+    channels?: {
+        amiko?: AmikoConfig;
+    };
+}): string;
+export declare function resolveAmikoAccountConfig(amiko: AmikoConfig, accountId: string): AmikoAccountConfig;
+export declare function resolveAmikoAccount(params: {
+    cfg: {
+        channels?: {
+            amiko?: AmikoConfig;
+        };
+    };
+    accountId: string;
+}): ResolvedAmikoAccount;
+export declare function listEnabledAmikoAccounts(cfg: {
+    channels?: {
+        amiko?: AmikoConfig;
+    };
+}): string[];
+//# sourceMappingURL=accounts.d.ts.map

package/dist/src/accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../../src/accounts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAExF,eAAO,MAAM,kBAAkB,SAAS,CAAC;AACzC,eAAO,MAAM,6BAA6B,kCAAkC,CAAC;AAC7E,eAAO,MAAM,yBAAyB,0BAA0B,CAAC;AAEjE,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAErD;AAmBD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE;IAAE,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,WAAW,CAAA;KAAE,CAAA;CAAE,GAAG,MAAM,EAAE,CAKzF;AAED,wBAAgB,4BAA4B,CAAC,GAAG,EAAE;IAAE,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,WAAW,CAAA;KAAE,CAAA;CAAE,GAAG,MAAM,CAchG;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,GAChB,kBAAkB,CAuCpB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,GAAG,EAAE;QAAE,QAAQ,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,WAAW,CAAA;SAAE,CAAA;KAAE,CAAC;IAC5C,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,oBAAoB,CAiCvB;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE;IAAE,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,WAAW,CAAA;KAAE,CAAA;CAAE,GAAG,MAAM,EAAE,CAS9F"}

package/dist/src/accounts.js

@@ -0,0 +1,115 @@
+export const DEFAULT_ACCOUNT_ID = "main";
+export const DEFAULT_PLATFORM_API_BASE_URL = "https://platform.heyamiko.com";
+export const DEFAULT_CHAT_API_BASE_URL = "https://api.amiko.app";
+export function normalizeAccountId(id) {
+    return id.toLowerCase().trim();
+}
+function normalizeBaseUrl(url, fallback) {
+    const value = String(url || "").trim();
+    if (!value)
+        return fallback;
+    return value.replace(/\/+$/, "").replace(/\/api$/, "");
+}
+function getAccountEntries(amiko) {
+    if (!amiko?.accounts || Object.keys(amiko.accounts).length === 0) {
+        return [];
+    }
+    return Object.entries(amiko.accounts).map(([accountId, config]) => [
+        normalizeAccountId(accountId),
+        config,
+    ]);
+}
+export function listAmikoAccountIds(cfg) {
+    const amiko = cfg.channels?.amiko;
+    const accounts = getAccountEntries(amiko);
+    if (accounts.length === 0)
+        return [DEFAULT_ACCOUNT_ID];
+    return accounts.map(([accountId]) => accountId).sort();
+}
+export function resolveDefaultAmikoAccountId(cfg) {
+    const amiko = cfg.channels?.amiko;
+    if (!amiko)
+        return DEFAULT_ACCOUNT_ID;
+    if (amiko.defaultAccount)
+        return normalizeAccountId(amiko.defaultAccount);
+    const accounts = getAccountEntries(amiko);
+    if (accounts.length === 0)
+        return DEFAULT_ACCOUNT_ID;
+    const hasMain = accounts.some(([accountId]) => accountId === DEFAULT_ACCOUNT_ID);
+    if (hasMain)
+        return DEFAULT_ACCOUNT_ID;
+    return accounts
+        .map(([accountId]) => accountId)
+        .sort()[0] ?? DEFAULT_ACCOUNT_ID;
+}
+export function resolveAmikoAccountConfig(amiko, accountId) {
+    const normalizedAccountId = normalizeAccountId(accountId);
+    if (!amiko.accounts || Object.keys(amiko.accounts).length === 0) {
+        return {
+            name: amiko.name,
+            enabled: amiko.enabled,
+            twinId: amiko.twinId,
+            token: amiko.token,
+            platformApiBaseUrl: amiko.platformApiBaseUrl ?? amiko.apiBaseUrl,
+            chatApiBaseUrl: amiko.chatApiBaseUrl ?? amiko.apiBaseUrl,
+            apiBaseUrl: amiko.apiBaseUrl,
+            webhookPath: amiko.webhookPath,
+            webhookSecret: amiko.webhookSecret,
+        };
+    }
+    const accountMap = Object.fromEntries(getAccountEntries(amiko));
+    const perAccount = accountMap[normalizedAccountId] ?? {};
+    return {
+        name: perAccount.name ?? amiko.name,
+        enabled: perAccount.enabled ?? amiko.enabled,
+        twinId: perAccount.twinId ?? amiko.twinId,
+        token: perAccount.token ?? amiko.token,
+        platformApiBaseUrl: perAccount.platformApiBaseUrl ??
+            perAccount.apiBaseUrl ??
+            amiko.platformApiBaseUrl ??
+            amiko.apiBaseUrl,
+        chatApiBaseUrl: perAccount.chatApiBaseUrl ??
+            perAccount.apiBaseUrl ??
+            amiko.chatApiBaseUrl ??
+            amiko.apiBaseUrl,
+        apiBaseUrl: perAccount.apiBaseUrl ?? amiko.apiBaseUrl,
+        webhookPath: perAccount.webhookPath ?? amiko.webhookPath,
+        webhookSecret: perAccount.webhookSecret ?? amiko.webhookSecret,
+    };
+}
+export function resolveAmikoAccount(params) {
+    const { cfg, accountId } = params;
+    const normalizedAccountId = normalizeAccountId(accountId);
+    const amiko = cfg.channels?.amiko ?? {};
+    const config = resolveAmikoAccountConfig(amiko, normalizedAccountId);
+    if (!config.twinId?.trim()) {
+        throw new Error(`Amiko account "${normalizedAccountId}" has no twinId configured`);
+    }
+    if (!config.token?.trim()) {
+        throw new Error(`Amiko account "${normalizedAccountId}" has no token configured`);
+    }
+    const platformApiBaseUrl = normalizeBaseUrl(config.platformApiBaseUrl ?? config.apiBaseUrl, DEFAULT_PLATFORM_API_BASE_URL);
+    const chatApiBaseUrl = normalizeBaseUrl(config.chatApiBaseUrl ?? config.apiBaseUrl, DEFAULT_CHAT_API_BASE_URL);
+    return {
+        accountId: normalizedAccountId,
+        twinId: config.twinId,
+        name: config.name,
+        enabled: config.enabled !== false,
+        token: config.token,
+        platformApiBaseUrl,
+        chatApiBaseUrl,
+        config,
+    };
+}
+export function listEnabledAmikoAccounts(cfg) {
+    return listAmikoAccountIds(cfg).filter((id) => {
+        try {
+            const account = resolveAmikoAccount({ cfg, accountId: id });
+            return account.enabled;
+        }
+        catch {
+            return false;
+        }
+    });
+}
+//# sourceMappingURL=accounts.js.map