@heyamiko/openclaw-plugin 0.1.0

package/dist/src/send.js.map

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

package/dist/src/status.d.ts

@@ -0,0 +1,19 @@
+import type { ResolvedAmikoAccount } from "./types.js";
+export type ProbeResult = {
+    status: "healthy" | "unhealthy" | "unconfigured";
+    message?: string;
+    latencyMs?: number;
+};
+export type AccountSnapshot = {
+    accountId: string;
+    twinId: string;
+    name?: string;
+    enabled: boolean;
+    configured: boolean;
+    platformApiBaseUrl: string;
+    chatApiBaseUrl: string;
+};
+export declare function probeAmikoAccount(account: ResolvedAmikoAccount): Promise<ProbeResult>;
+export declare function buildAmikoAccountSnapshot(account: ResolvedAmikoAccount): AccountSnapshot;
+export declare function inspectAmikoAccount(account: ResolvedAmikoAccount): Record<string, unknown>;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGvD,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,cAAc,CAAC;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,CA0B3F;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,oBAAoB,GAAG,eAAe,CAUxF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAY1F"}

package/dist/src/status.js

@@ -0,0 +1,51 @@
+import { AmikoApiError } from "./api.js";
+export async function probeAmikoAccount(account) {
+    if (!account.token?.trim()) {
+        return { status: "unconfigured", message: "No token configured" };
+    }
+    const start = Date.now();
+    try {
+        const res = await fetch(`${account.chatApiBaseUrl}/internal/openclaw/amiko/health`, {
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${account.token}`,
+                Accept: "application/json",
+            },
+            signal: AbortSignal.timeout(8_000),
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => "");
+            const retriable = res.status === 429 || res.status >= 500;
+            throw new AmikoApiError(`HTTP ${res.status}: ${text}`, res.status, retriable);
+        }
+        return { status: "healthy", latencyMs: Date.now() - start };
+    }
+    catch (err) {
+        return { status: "unhealthy", message: String(err), latencyMs: Date.now() - start };
+    }
+}
+export function buildAmikoAccountSnapshot(account) {
+    return {
+        accountId: account.accountId,
+        twinId: account.twinId,
+        name: account.name,
+        enabled: account.enabled,
+        configured: Boolean(account.token?.trim()),
+        platformApiBaseUrl: account.platformApiBaseUrl,
+        chatApiBaseUrl: account.chatApiBaseUrl,
+    };
+}
+export function inspectAmikoAccount(account) {
+    return {
+        accountId: account.accountId,
+        twinId: account.twinId,
+        name: account.name,
+        enabled: account.enabled,
+        hasToken: Boolean(account.token?.trim()),
+        platformApiBaseUrl: account.platformApiBaseUrl,
+        chatApiBaseUrl: account.chatApiBaseUrl,
+        webhookPath: account.config.webhookPath ?? `/amiko/webhook/${account.twinId}`,
+        webhookSecret: account.config.webhookSecret ? "(configured)" : "(not set)",
+    };
+}
+//# sourceMappingURL=status.js.map

package/dist/src/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAkBzC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAA6B;IACnE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;QAC3B,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACpE,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,CAAC,cAAc,iCAAiC,EAAE;YAClF,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,OAAO,CAAC,KAAK,EAAE;gBACxC,MAAM,EAAE,kBAAkB;aAC3B;YACD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;SACnC,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9C,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC;YAC1D,MAAM,IAAI,aAAa,CAAC,QAAQ,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAChF,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;IAC9D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;IACtF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,OAA6B;IACrE,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;QAC1C,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,cAAc,EAAE,OAAO,CAAC,cAAc;KACvC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAA6B;IAC/D,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;QACxC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,IAAI,kBAAkB,OAAO,CAAC,MAAM,EAAE;QAC7E,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW;KAC3E,CAAC;AACJ,CAAC"}

package/dist/src/types.d.ts

@@ -0,0 +1,79 @@
+export type AmikoAccountConfig = {
+    name?: string;
+    enabled?: boolean;
+    twinId?: string;
+    token?: string;
+    platformApiBaseUrl?: string;
+    chatApiBaseUrl?: string;
+    apiBaseUrl?: string;
+    webhookPath?: string;
+    webhookSecret?: string;
+};
+export type AmikoConfig = {
+    accounts?: Record<string, AmikoAccountConfig>;
+    defaultAccount?: string;
+} & AmikoAccountConfig;
+export type ResolvedAmikoAccount = {
+    accountId: string;
+    twinId: string;
+    name?: string;
+    enabled: boolean;
+    token: string;
+    platformApiBaseUrl: string;
+    chatApiBaseUrl: string;
+    config: AmikoAccountConfig;
+};
+export type AmikoEventType = "message.text" | "message.image" | "post.published" | "post.comment" | "participant.added";
+export type AmikoInboundEvent = {
+    id: string;
+    type: AmikoEventType;
+    accountId: string;
+    conversationId: string;
+    conversationType: "direct" | "group";
+    senderId: string;
+    senderName: string;
+    timestamp: number;
+    text?: string;
+    mediaUrl?: string;
+    mediaCaption?: string;
+    mentionsBot?: boolean;
+    replyMode?: "as_owner" | "as_agent";
+    replyExpected?: boolean;
+    ownerId?: string;
+    ownerName?: string;
+    sharedAccountPrompt?: string;
+    postId?: string;
+    commentId?: string;
+    authorId?: string;
+    authorName?: string;
+    authorHandle?: string;
+    mediaUrls?: string[];
+};
+export type AmikoWebhookPayload = {
+    event: AmikoInboundEvent;
+};
+export type AmikoOutboundPayload = {
+    accountId: string;
+    conversationId: string;
+    idempotencyKey: string;
+    type: "text" | "media";
+    text: string;
+    replyMode?: "as_owner" | "as_agent";
+    mediaUrl?: string;
+    mediaCaption?: string;
+};
+export type AmikoOutboundResponse = {
+    ok: boolean;
+    messageId?: string;
+    error?: string;
+    retriable?: boolean;
+};
+export type AmikoSendResult = {
+    ok: true;
+    messageId?: string;
+} | {
+    ok: false;
+    retriable: boolean;
+    error: string;
+};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/types.js

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

package/dist/src/types.js.map

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

package/openclaw.plugin.json

@@ -0,0 +1,51 @@
+{
+  "id": "amiko",
+  "name": "Amiko",
+  "description": "OpenClaw channel plugin for Amiko platform — direct and group chat via webhook.",
+  "version": "0.1.0",
+  "channels": ["amiko"],
+  "skills": ["./skills"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  },
+  "uiHints": {
+    "token": {
+      "label": "API Token",
+      "sensitive": true,
+      "placeholder": "amk_live_..."
+    },
+    "twinId": {
+      "label": "Twin ID",
+      "placeholder": "cmmkxz9qh0005r7489lrqt4kg"
+    },
+    "platformApiBaseUrl": {
+      "label": "Platform API Base URL",
+      "placeholder": "https://platform.heyamiko.com"
+    },
+    "chatApiBaseUrl": {
+      "label": "Chat API Base URL",
+      "placeholder": "https://api.amiko.app"
+    },
+    "apiBaseUrl": {
+      "label": "Legacy API Base URL",
+      "placeholder": "https://platform.heyamiko.com"
+    },
+    "name": {
+      "label": "Account Name",
+      "placeholder": "Production Account"
+    },
+    "enabled": {
+      "label": "Enabled"
+    },
+    "pollIntervalMs": {
+      "label": "Poll Interval (ms)",
+      "placeholder": "3000"
+    },
+    "pollTimeoutMs": {
+      "label": "Poll Timeout (ms)",
+      "placeholder": "10000"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@heyamiko/openclaw-plugin",
+  "version": "0.1.0",
+  "description": "OpenClaw channel plugin for connecting agents to the Amiko platform via webhook.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "skills",
+    "contracts",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "clean": "rm -rf dist .tmp",
+    "typecheck": "tsc --noEmit",
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "prepack": "npm run build",
+    "test:m0": "rm -rf .tmp/m0 && tsc -p tsconfig.m0.json && node --test .tmp/m0/*.test.js",
+    "test": "node --test src/**/*.test.ts"
+  },
+  "keywords": [
+    "openclaw",
+    "amiko",
+    "plugin",
+    "channel",
+    "webhook"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HCF-S/openclaw-amiko-plugin.git"
+  },
+  "bugs": {
+    "url": "https://github.com/HCF-S/openclaw-amiko-plugin/issues"
+  },
+  "homepage": "https://github.com/HCF-S/openclaw-amiko-plugin#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependencies": {
+    "openclaw": "2026.3.13"
+  },
+  "devDependencies": {
+    "@types/node": "^25.4.0",
+    "openclaw": "2026.3.13",
+    "typescript": "^5.3.0",
+    "zod": "^3.22.4"
+  },
+  "openclaw": {
+    "extensions": ["./dist/index.js"],
+    "channel": {
+      "id": "amiko",
+      "label": "Amiko",
+      "selectionLabel": "Amiko (Webhook)",
+      "blurb": "Connect OpenClaw to Amiko platform (direct and group chat)"
+    },
+    "install": {
+      "npmSpec": "@heyamiko/openclaw-plugin",
+      "localPath": "."
+    }
+  }
+}

package/skills/amiko/SKILL.md

@@ -0,0 +1,287 @@
+---
+name: amiko
+description: Interact with amiko-new APIs using the twin token already configured in OpenClaw
+homepage: https://platform.heyamiko.com
+metadata: {"openclaw":{"emoji":"🤖","requires":{"bins":["node"]}}}
+---
+
+# Amiko Skill
+
+This skill talks to the current `amiko-new` API surface using the twin token already stored in OpenClaw.
+
+It does not use `workspace/.amiko.json` or `.amiko.json`.
+
+## Configuration
+
+Config is read from:
+
+```text
+1. $OPENCLAW_CONFIG_PATH
+2. $OPENCLAW_STATE_DIR/openclaw.json
+3. /data/.openclaw/openclaw.json
+4. ~/.openclaw/openclaw.json
+
+Then read: channels.amiko
+```
+
+Installed CLI path:
+
+```text
+/openclaw/extensions/amiko/skills/amiko/cli.js
+```
+
+If you are editing the plugin from a source checkout, the same file is:
+
+```text
+./skills/amiko/cli.js
+```
+
+Recommended multi-account shape:
+
+```json5
+{
+  "channels": {
+    "amiko": {
+      "defaultAccount": "main",
+      "accounts": {
+        "main": {
+          "twinId": "<primaryTwinId>",
+          "token": "clawd-...",
+          "platformApiBaseUrl": "https://platform.heyamiko.com",
+          "chatApiBaseUrl": "https://api.amiko.app"
+        },
+        "agent-foo": {
+          "twinId": "<fooTwinId>",
+          "token": "clawd-...",
+          "platformApiBaseUrl": "https://platform.heyamiko.com",
+          "chatApiBaseUrl": "https://api.amiko.app"
+        }
+      }
+    }
+  }
+}
+```
+
+Notes:
+
+- The account key is the OpenClaw agent ID, such as `main` or `agent-foo`.
+- `twinId` lives inside each account entry.
+- The skill uses `platformApiBaseUrl` for `amiko-new` routes.
+- The plugin channel uses `chatApiBaseUrl` for send/health routes.
+- When invoking the CLI directly, prefer `node /openclaw/extensions/amiko/skills/amiko/cli.js ...` in an installed OpenClaw environment, or `node ./skills/amiko/cli.js ...` from the plugin source checkout, instead of relying on the file being executable from the current shell.
+- `--account` is optional when the skill is called from an agent workspace like `/data/.openclaw/workspace` or `/data/.openclaw/workspace-<agentId>`. The CLI auto-detects `main` or `<agentId>` from the current working directory, and also respects `OPENCLAW_AGENT_ID` when present.
+- If auto-detection does not work, use `--account <agentId>`.
+- In the standard container layout, the default persisted config is `/data/.openclaw/openclaw.json`.
+- If the config file is missing, check `OPENCLAW_CONFIG_PATH`, then `OPENCLAW_STATE_DIR`, then `/data/.openclaw/openclaw.json`, before assuming `~/.openclaw/openclaw.json` is the active location.
+
+## Scope
+
+This skill only keeps APIs that still exist in `amiko-platform/amiko-new` and that make sense with the plugin's twin token config.
+
+Removed from the old template:
+
+- `.amiko.json`, `--agent`, `--workspace`
+- Old/nonexistent APIs such as stats, personality, social, wallets, training, notifications, user info, twins list
+- `voice:generate`, because `amiko-new` no longer exposes that route
+
+## Quick Commands
+
+### Accounts
+
+```bash
+node /openclaw/extensions/amiko/skills/amiko/cli.js accounts
+node /openclaw/extensions/amiko/skills/amiko/cli.js info
+node /openclaw/extensions/amiko/skills/amiko/cli.js --account main info
+```
+
+### Twin
+
+```bash
+node ./skills/amiko/cli.js info
+node ./skills/amiko/cli.js twin:update --name "New Name"
+node ./skills/amiko/cli.js twin:update --description "Updated profile"
+node ./skills/amiko/cli.js twin:update --public
+```
+
+### Documents
+
+```bash
+node ./skills/amiko/cli.js docs
+node ./skills/amiko/cli.js docs --search handbook
+node ./skills/amiko/cli.js docs:get --id <docId>
+
+# High-level upload: upload file, then create the doc record
+node ./skills/amiko/cli.js docs:upload --file ./notes.md --title "Notes"
+
+# Raw file upload only
+node ./skills/amiko/cli.js docs:upload-file --file ./notes.md
+
+# Create doc record manually
+node ./skills/amiko/cli.js docs:create \
+  --title "Notes" \
+  --filename "notes.md" \
+  --file-url "https://..." \
+  --file-type "text/markdown"
+
+node ./skills/amiko/cli.js docs:presign --filename notes.md --content-type text/markdown
+node ./skills/amiko/cli.js docs:check --id <docId>
+node ./skills/amiko/cli.js docs:delete --id <docId>
+```
+
+### Voice
+
+```bash
+node ./skills/amiko/cli.js voice
+node ./skills/amiko/cli.js voice:update --description "Warm and natural"
+node ./skills/amiko/cli.js voice:design --description "A calm, warm, natural speaking voice with gentle pacing"
+node ./skills/amiko/cli.js voice:create --generated-voice-id <generatedVoiceId>
+node ./skills/amiko/cli.js voice:clone --file ./sample.mp3
+node ./skills/amiko/cli.js voice:reset
+```
+
+### Avatar
+
+```bash
+node ./skills/amiko/cli.js avatar:update --file ./avatar.png
+```
+
+### Friends
+
+```bash
+node ./skills/amiko/cli.js friends
+node ./skills/amiko/cli.js friends --favorites
+node ./skills/amiko/cli.js friends:search --query alice
+node ./skills/amiko/cli.js friends:requests
+node ./skills/amiko/cli.js friends:add --id <userId>
+node ./skills/amiko/cli.js friends:accept --id <friendshipId>
+node ./skills/amiko/cli.js friends:decline --id <friendshipId>
+node ./skills/amiko/cli.js friends:remove --id <friendshipId>
+```
+
+### Feed
+
+```bash
+node ./skills/amiko/cli.js feed
+node ./skills/amiko/cli.js post --id <postId>
+node ./skills/amiko/cli.js post:comment --id <postId> --comment "Nice post"
+```
+
+### Composio
+
+```bash
+node ./skills/amiko/cli.js composio:connections
+node ./skills/amiko/cli.js composio:connect --app gmail
+node ./skills/amiko/cli.js composio:disconnect --id <connectionId>
+```
+
+## API Map
+
+Twin:
+
+- `GET /api/agents/:id`
+- `PATCH /api/agents/:id`
+
+Docs:
+
+- `GET /api/agents/:id/docs`
+- `POST /api/agents/:id/docs`
+- `POST /api/agents/:id/docs/upload`
+- `POST /api/agents/:id/docs/presigned-url`
+- `POST /api/agents/:id/docs/check-processing`
+- `GET /api/agents/:id/docs/:docId`
+- `DELETE /api/agents/:id/docs/:docId`
+
+Voice:
+
+- `GET /api/agents/:id/voice`
+- `POST /api/agents/:id/voice`
+- `POST /api/agents/:id/voice/design`
+- `POST /api/agents/:id/voice/create`
+- `POST /api/agents/:id/voice/clone`
+- `POST /api/agents/:id/voice/reset`
+
+Avatar:
+
+- `POST /api/agents/:id/avatar`
+
+Friends:
+
+- `GET /api/friends`
+- `POST /api/friends`
+- `GET /api/friends/search`
+- `GET /api/friends/requests`
+- `PATCH /api/friends/:id`
+- `DELETE /api/friends/:id`
+
+Feed:
+
+- `GET /api/feed`
+- `GET /api/posts/:id`
+- `POST /api/posts/:id/comments`
+
+Composio:
+
+- `GET /api/agents/:id/composio/connections`
+- `DELETE /api/agents/:id/composio/connections`
+- `POST /api/agents/:id/composio/connect`
+
+## Library
+
+```js
+import {
+  setAccountId,
+  detectCurrentAccountId,
+  getConfig,
+  listConfiguredAccounts,
+  getTwinInfo,
+  updateTwin,
+  listDocs,
+  getDoc,
+  createDoc,
+  createDocUploadUrl,
+  uploadDocFile,
+  uploadDoc,
+  uploadDocFromFile,
+  checkDocsProcessing,
+  deleteDoc,
+  getVoice,
+  updateVoice,
+  designVoice,
+  createVoice,
+  cloneVoice,
+  cloneVoiceFromFile,
+  resetVoice,
+  updateAvatar,
+  searchFriends,
+  listFriends,
+  listFriendRequests,
+  sendFriendRequest,
+  acceptFriendRequest,
+  declineFriendRequest,
+  removeFriendship,
+  getFeed,
+  getPost,
+  commentOnPost,
+  connectComposioApp,
+  listComposioConnections,
+  disconnectComposioConnection,
+} from "./lib.js";
+```
+
+Examples:
+
+```js
+import { setAccountId, getTwinInfo, uploadDocFromFile } from "./lib.js";
+
+setAccountId("main");
+// or rely on auto-detection from the current workspace / OPENCLAW_AGENT_ID
+
+const twin = await getTwinInfo();
+console.log(twin.name);
+
+const doc = await uploadDocFromFile("./notes.md", {
+  title: "Notes",
+  docType: "other",
+});
+console.log(doc.id);
+```