@elizaos/plugin-line 2.0.0-alpha.7 → 2.0.11-beta.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shaw Walters and elizaOS Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,185 @@
+# @elizaos/plugin-line
+
+LINE Messaging API plugin for elizaOS agents. Enables chatbot integration with LINE, a popular messaging platform in Japan, Taiwan, and Thailand.
+
+## Features
+
+- **Text Messages**: Send and receive text messages
+- **Rich Messages (Flex)**: Create visually rich card messages
+- **Location Messages**: Share locations with map pins
+- **Quick Replies**: Provide suggested reply options
+- **Group/Room Support**: Operate in groups and multi-user rooms
+- **User Profiles**: Access user display names, pictures, and language
+- **Webhook Integration**: Receive messages via LINE webhooks
+
+## Installation
+
+```bash
+# npm
+npm install @elizaos/plugin-line
+
+# bun
+bun add @elizaos/plugin-line
+```
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Description | Required |
+|----------|-------------|----------|
+| `LINE_CHANNEL_ACCESS_TOKEN` | Channel access token from LINE Developers Console | Yes |
+| `LINE_CHANNEL_SECRET` | Channel secret for webhook verification | Yes |
+| `LINE_WEBHOOK_PATH` | Webhook endpoint path | No |
+| `LINE_DM_POLICY` | DM policy: open, pairing, allowlist, disabled | No |
+| `LINE_GROUP_POLICY` | Group policy: open, allowlist, disabled | No |
+| `LINE_ALLOW_FROM` | Comma-separated user IDs for allowlist | No |
+| `LINE_ENABLED` | Enable/disable the plugin | No |
+
+### Agent Configuration
+
+```json
+{
+  "plugins": ["@elizaos/plugin-line"],
+  "pluginParameters": {
+    "LINE_CHANNEL_ACCESS_TOKEN": "your-channel-access-token",
+    "LINE_CHANNEL_SECRET": "your-channel-secret",
+    "LINE_DM_POLICY": "pairing",
+    "LINE_GROUP_POLICY": "allowlist"
+  }
+}
+```
+
+## Setup
+
+1. Create a LINE Developers account at https://developers.line.biz/
+2. Create a new Messaging API channel
+3. Get your Channel Access Token (issue a long-lived token)
+4. Get your Channel Secret
+5. Set up webhook URL pointing to your server
+
+## Usage
+
+### Actions
+
+LINE messaging routes through the canonical `MESSAGE` action using
+`source: "line"`.
+
+| Primary action | Operation | Description |
+|----------------|-----------|-------------|
+| `MESSAGE` | `send` | Send text, flex, or location content to a user, group, or room |
+| `MESSAGE` | `read_channel` | Read recent LINE conversation history when available |
+| `MESSAGE` | `list_channels` | List recent LINE targets when available |
+
+### Providers
+
+LINE does not register standalone planner providers. Chat and user context is
+exposed through the LINE message connector hooks.
+
+## LINE ID Formats
+
+- **User IDs**: Start with `U` followed by 32 hex characters (e.g., `U1234567890abcdef1234567890abcdef`)
+- **Group IDs**: Start with `C` followed by 32 hex characters
+- **Room IDs**: Start with `R` followed by 32 hex characters
+
+## Message Limits
+
+- Text messages: 5000 characters max
+- Alt text (for flex/template): 400 characters max
+- Location title/address: 100 characters max
+- Messages per push: 5 max (batched automatically)
+
+## Webhook Setup
+
+1. Configure your webhook URL in the LINE Developers Console
+2. Ensure your server verifies webhook signatures using the channel secret
+3. The plugin provides middleware for Express-style webhook handling
+
+```typescript
+import { LineService } from "@elizaos/plugin-line";
+
+// Get the middleware
+const middleware = lineService.createMiddleware();
+
+// Use with Express
+app.post("/webhooks/line", middleware, async (req, res) => {
+  const events = req.body.events;
+  await lineService.handleWebhookEvents(events);
+  res.status(200).end();
+});
+```
+
+## Flex Messages
+
+LINE Flex Messages allow rich visual content. The plugin supports creating info card bubbles:
+
+```typescript
+const flexMessage = {
+  altText: "Update Notification",
+  contents: {
+    type: "bubble",
+    body: {
+      type: "box",
+      layout: "vertical",
+      contents: [
+        { type: "text", text: "Title", weight: "bold", size: "xl" },
+        { type: "text", text: "Body content", margin: "md", wrap: true }
+      ]
+    }
+  }
+};
+```
+
+## Security Policies
+
+### DM Policies
+
+| Policy | Description |
+|--------|-------------|
+| `open` | Accept DMs from anyone |
+| `pairing` | Accept DMs and remember senders |
+| `allowlist` | Only accept from LINE_ALLOW_FROM list |
+| `disabled` | Don't accept any DMs |
+
+### Group Policies
+
+| Policy | Description |
+|--------|-------------|
+| `open` | Respond to anyone in groups |
+| `allowlist` | Only respond to allowed users |
+| `disabled` | Don't respond in groups |
+
+## Development
+
+### Building
+
+```bash
+bun run --cwd plugins/plugin-line build
+```
+
+### Testing
+
+```bash
+bun run --cwd plugins/plugin-line test
+```
+
+## API Reference
+
+### LineService
+
+#### Methods
+
+- `isConnected()`: Check connection status
+- `getBotInfo()`: Get bot profile
+- `sendMessage(to, text, options?)`: Send text message
+- `sendFlexMessage(to, flex)`: Send flex message
+- `sendTemplateMessage(to, template)`: Send template message
+- `sendLocationMessage(to, location)`: Send location
+- `replyMessage(replyToken, messages)`: Reply using token
+- `getUserProfile(userId)`: Get user profile
+- `getGroupInfo(groupId)`: Get group info
+- `leaveChat(chatId, chatType)`: Leave group/room
+
+## License
+
+MIT

package/package.json

@@ -1,14 +1,30 @@
 {
   "name": "@elizaos/plugin-line",
-  "version": "2.0.0-alpha.7",
+  "version": "2.0.11-beta.7",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
+      "eliza-source": {
+        "types": "./src/index.ts",
+        "import": "./src/index.ts",
+        "default": "./src/index.ts"
+      },
       "import": "./dist/index.js",
       "default": "./dist/index.js"
+    },
+    "./*.css": "./dist/*.css",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "eliza-source": {
+        "types": "./src/*.ts",
+        "import": "./src/*.ts",
+        "default": "./src/*.ts"
+      },
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
     }
   },
   "files": [
@@ -16,29 +32,28 @@
   ],
   "scripts": {
     "build": "bun run build.ts",
-    "test": "vitest run --config vitest.config.ts --passWithNoTests",
+    "test": "vitest run --config vitest.config.ts",
     "test:watch": "vitest --config vitest.config.ts",
     "lint": "bunx @biomejs/biome check --write --unsafe .",
     "lint:check": "bunx @biomejs/biome check .",
     "format": "bunx @biomejs/biome format --write .",
     "format:check": "bunx @biomejs/biome format .",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsgo --noEmit"
   },
   "dependencies": {
-    "@elizaos/core": "2.0.0-alpha.3",
-    "@line/bot-sdk": "^10.5.0",
-    "zod": "^4.3.6"
+    "@elizaos/core": "2.0.11-beta.7",
+    "@line/bot-sdk": "^11.0.0"
   },
   "devDependencies": {
-    "@types/node": "^20.0.0",
-    "typescript": "^5.6.0",
-    "vitest": "^2.0.0",
-    "@biomejs/biome": "^2.3.11"
+    "@biomejs/biome": "^2.4.14",
+    "@types/node": "^22.19.17",
+    "typescript": "^6.0.3",
+    "vitest": "^4.0.0"
   },
   "publishConfig": {
     "access": "public"
   },
-  "milady": {
+  "eliza": {
     "platforms": [
       "node"
     ],
@@ -92,5 +107,6 @@
         "sensitive": false
       }
     }
-  }
+  },
+  "gitHead": "cdbc876f793d96073d7eb0d09715a031ce0cd32e"
 }

package/dist/accounts.d.ts

@@ -1,152 +0,0 @@
-import type { IAgentRuntime } from "@elizaos/core";
-/**
- * Default account identifier used when no specific account is configured
- */
-export declare const DEFAULT_ACCOUNT_ID = "default";
-/**
- * Token source indicator
- */
-export type LineTokenSource = "config" | "env" | "character" | "none";
-/**
- * Group-specific configuration
- */
-export interface LineGroupConfig {
-    /** If false, ignore messages from this group */
-    enabled?: boolean;
-    /** Allowlist for users in this group */
-    allowFrom?: Array<string | number>;
-    /** Require bot mention to respond */
-    requireMention?: boolean;
-    /** Custom system prompt for this group */
-    systemPrompt?: string;
-    /** Skills enabled for this group */
-    skills?: string[];
-}
-/**
- * Configuration for a single LINE account
- */
-export interface LineAccountConfig {
-    /** Optional display name for this account */
-    name?: string;
-    /** If false, do not start this LINE account */
-    enabled?: boolean;
-    /** Channel access token */
-    channelAccessToken?: string;
-    /** Channel secret */
-    channelSecret?: string;
-    /** Path to file containing channel access token */
-    tokenFile?: string;
-    /** Path to file containing channel secret */
-    secretFile?: string;
-    /** Allowlist for DM senders */
-    allowFrom?: Array<string | number>;
-    /** Allowlist for groups */
-    groupAllowFrom?: Array<string | number>;
-    /** DM access policy */
-    dmPolicy?: "open" | "allowlist" | "pairing" | "disabled";
-    /** Group message access policy */
-    groupPolicy?: "open" | "allowlist" | "disabled";
-    /** Max media size in MB */
-    mediaMaxMb?: number;
-    /** Custom webhook path */
-    webhookPath?: string;
-    /** Group-specific configurations */
-    groups?: Record<string, LineGroupConfig>;
-}
-/**
- * Multi-account LINE configuration structure
- */
-export interface LineMultiAccountConfig {
-    /** Default/base configuration applied to all accounts */
-    enabled?: boolean;
-    channelAccessToken?: string;
-    channelSecret?: string;
-    tokenFile?: string;
-    secretFile?: string;
-    dmPolicy?: "open" | "allowlist" | "pairing" | "disabled";
-    groupPolicy?: "open" | "allowlist" | "disabled";
-    mediaMaxMb?: number;
-    webhookPath?: string;
-    /** Per-account configuration overrides */
-    accounts?: Record<string, LineAccountConfig>;
-    /** Group configurations at base level */
-    groups?: Record<string, LineGroupConfig>;
-}
-/**
- * Token resolution result
- */
-export interface LineTokenResolution {
-    token: string;
-    source: LineTokenSource;
-}
-/**
- * Resolved LINE account with all configuration merged
- */
-export interface ResolvedLineAccount {
-    accountId: string;
-    enabled: boolean;
-    name?: string;
-    channelAccessToken: string;
-    channelSecret: string;
-    tokenSource: LineTokenSource;
-    configured: boolean;
-    config: LineAccountConfig;
-}
-/**
- * Normalizes an account ID, returning the default if not provided
- */
-export declare function normalizeAccountId(accountId?: string | null): string;
-/**
- * Gets the multi-account configuration from runtime settings
- */
-export declare function getMultiAccountConfig(runtime: IAgentRuntime): LineMultiAccountConfig;
-/**
- * Lists all configured account IDs
- */
-export declare function listLineAccountIds(runtime: IAgentRuntime): string[];
-/**
- * Resolves the default account ID to use
- */
-export declare function resolveDefaultLineAccountId(runtime: IAgentRuntime): string;
-/**
- * Resolves the channel access token for a LINE account
- */
-export declare function resolveLineToken(runtime: IAgentRuntime, accountId: string): LineTokenResolution;
-/**
- * Resolves the channel secret for a LINE account
- */
-export declare function resolveLineSecret(runtime: IAgentRuntime, accountId: string): string;
-/**
- * Resolves a complete LINE account configuration
- */
-export declare function resolveLineAccount(runtime: IAgentRuntime, accountId?: string | null): ResolvedLineAccount;
-/**
- * Lists all enabled LINE accounts
- */
-export declare function listEnabledLineAccounts(runtime: IAgentRuntime): ResolvedLineAccount[];
-/**
- * Checks if multi-account mode is enabled
- */
-export declare function isMultiAccountEnabled(runtime: IAgentRuntime): boolean;
-/**
- * Resolves group configuration for a specific group
- */
-export declare function resolveLineGroupConfig(runtime: IAgentRuntime, accountId: string, groupId: string): LineGroupConfig | undefined;
-/**
- * Checks if a user is allowed based on policy and allowlist
- */
-export declare function isLineUserAllowed(params: {
-    userId: string;
-    accountConfig: LineAccountConfig;
-    isGroup: boolean;
-    groupId?: string;
-    groupConfig?: LineGroupConfig;
-}): boolean;
-/**
- * Checks if mention is required in a group
- */
-export declare function isLineMentionRequired(params: {
-    accountConfig: LineAccountConfig;
-    groupConfig?: LineGroupConfig;
-}): boolean;
-//# sourceMappingURL=accounts.d.ts.map

package/dist/accounts.d.ts.map

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