@gakr-gakr/line 0.1.0

package/api.ts

@@ -0,0 +1,11 @@
+export type {
+  ChannelAccountSnapshot,
+  ChannelPlugin,
+  AutoBotConfig,
+  AutoBotPluginApi,
+  PluginRuntime,
+} from "autobot/plugin-sdk/core";
+export type { ReplyPayload } from "autobot/plugin-sdk/reply-runtime";
+export type { ResolvedLineAccount } from "./runtime-api.js";
+export { linePlugin } from "./src/channel.js";
+export { lineSetupPlugin } from "./src/channel.setup.js";

package/autobot.plugin.json

@@ -0,0 +1,15 @@
+{
+  "id": "line",
+  "activation": {
+    "onStartup": false
+  },
+  "channels": ["line"],
+  "channelEnvVars": {
+    "line": ["LINE_CHANNEL_ACCESS_TOKEN", "LINE_CHANNEL_SECRET"]
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/channel-plugin-api.ts

@@ -0,0 +1 @@
+export { linePlugin } from "./src/channel.js";

package/contract-api.ts

@@ -0,0 +1,5 @@
+export {
+  listLineAccountIds,
+  resolveDefaultLineAccountId,
+  resolveLineAccount,
+} from "./src/accounts.js";

package/index.ts

@@ -0,0 +1,54 @@
+import {
+  defineBundledChannelEntry,
+  type AutoBotPluginCommandDefinition,
+  type AutoBotPluginApi,
+} from "autobot/plugin-sdk/channel-entry-contract";
+
+type RegisteredLineCardCommand = AutoBotPluginCommandDefinition;
+
+let lineCardCommandPromise: Promise<RegisteredLineCardCommand> | null = null;
+
+async function loadLineCardCommand(api: AutoBotPluginApi): Promise<RegisteredLineCardCommand> {
+  lineCardCommandPromise ??= (async () => {
+    let registered: RegisteredLineCardCommand | null = null;
+    const { registerLineCardCommand } = await import("./src/card-command.js");
+    registerLineCardCommand({
+      ...api,
+      registerCommand(command: RegisteredLineCardCommand) {
+        registered = command;
+      },
+    });
+    if (!registered) {
+      throw new Error("LINE card command registration unavailable");
+    }
+    return registered;
+  })();
+  return await lineCardCommandPromise;
+}
+
+export default defineBundledChannelEntry({
+  id: "line",
+  name: "LINE",
+  description: "LINE Messaging API channel plugin",
+  importMetaUrl: import.meta.url,
+  plugin: {
+    specifier: "./channel-plugin-api.js",
+    exportName: "linePlugin",
+  },
+  runtime: {
+    specifier: "./runtime-api.js",
+    exportName: "setLineRuntime",
+  },
+  registerFull(api) {
+    api.registerCommand({
+      name: "card",
+      description: "Send a rich card message (LINE).",
+      acceptsArgs: true,
+      requireAuth: false,
+      async handler(ctx) {
+        const command = await loadLineCardCommand(api);
+        return await command.handler(ctx);
+      },
+    });
+  },
+});

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@gakr-gakr/line",
+  "version": "0.1.0",
+  "description": "AutoBot LINE channel plugin",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/autobot/autobot"
+  },
+  "type": "module",
+  "dependencies": {
+    "@line/bot-sdk": "11.0.0",
+    "zod": "4.4.3"
+  },
+  "devDependencies": {
+    "@gakr-gakr/plugin-sdk": "workspace:*",
+    "@gakr-gakr/autobot": "workspace:*",
+    "autobot": "workspace:@gakr-gakr/autobot@*"
+  },
+  "peerDependencies": {
+    "@gakr-gakr/autobot": ">=0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@gakr-gakr/autobot": {
+      "optional": true
+    }
+  },
+  "autobot": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "setupEntry": "./setup-entry.ts",
+    "channel": {
+      "id": "line",
+      "label": "LINE",
+      "selectionLabel": "LINE (Messaging API)",
+      "detailLabel": "LINE Bot",
+      "docsPath": "/channels/line",
+      "docsLabel": "line",
+      "blurb": "LINE Messaging API webhook bot.",
+      "systemImage": "message",
+      "order": 75,
+      "quickstartAllowFrom": true
+    },
+    "install": {
+      "npmSpec": "@gakr-gakr/line",
+      "defaultChoice": "npm",
+      "minHostVersion": ">=2026.4.10"
+    },
+    "compat": {
+      "pluginApi": ">=2026.5.19"
+    },
+    "build": {
+      "autobotVersion": "2026.5.19"
+    },
+    "release": {
+      "publishToClawHub": true,
+      "publishToNpm": true
+    }
+  }
+}

package/runtime-api.ts

@@ -0,0 +1,182 @@
+// Private runtime barrel for the bundled LINE extension.
+// Keep this barrel thin and aligned with the local extension surface.
+
+export type {
+  ChannelAccountSnapshot,
+  ChannelPlugin,
+  AutoBotConfig,
+  AutoBotPluginApi,
+  PluginRuntime,
+} from "autobot/plugin-sdk/core";
+export type {
+  ChannelGatewayContext,
+  ChannelStatusIssue,
+} from "autobot/plugin-sdk/channel-contract";
+export { clearAccountEntryFields } from "autobot/plugin-sdk/core";
+export { buildChannelConfigSchema } from "autobot/plugin-sdk/channel-config-schema";
+export type { ReplyPayload } from "autobot/plugin-sdk/reply-runtime";
+export type { ChannelSetupDmPolicy, ChannelSetupWizard } from "autobot/plugin-sdk/setup";
+export {
+  buildComputedAccountStatusSnapshot,
+  buildTokenChannelStatusSummary,
+} from "autobot/plugin-sdk/status-helpers";
+export {
+  DEFAULT_ACCOUNT_ID,
+  formatDocsLink,
+  setSetupChannelEnabled,
+  splitSetupEntries,
+} from "autobot/plugin-sdk/setup";
+export { setLineRuntime } from "./src/runtime.js";
+export { firstDefined, normalizeAllowFrom } from "./src/bot-access.js";
+export { downloadLineMedia } from "./src/download.js";
+export { probeLineBot } from "./src/probe.js";
+export { buildTemplateMessageFromPayload } from "./src/template-messages.js";
+export {
+  createQuickReplyItems,
+  pushFlexMessage,
+  pushLocationMessage,
+  pushMessageLine,
+  pushMessagesLine,
+  pushTemplateMessage,
+  pushTextMessageWithQuickReplies,
+  sendMessageLine,
+} from "./src/send.js";
+export { monitorLineProvider } from "./src/monitor.js";
+export { hasLineDirectives, parseLineDirectives } from "./src/reply-payload-transform.js";
+export {
+  listLineAccountIds,
+  normalizeAccountId,
+  resolveDefaultLineAccountId,
+  resolveLineAccount,
+} from "./src/accounts.js";
+export { type NormalizedAllowFrom } from "./src/bot-access.js";
+export { resolveLineChannelAccessToken } from "./src/channel-access-token.js";
+export {
+  LineChannelConfigSchema,
+  LineConfigSchema,
+  type LineConfigSchemaType,
+} from "./src/config-schema.js";
+export {
+  resolveExactLineGroupConfigKey,
+  resolveLineGroupConfigEntry,
+  resolveLineGroupLookupIds,
+  resolveLineGroupsConfig,
+} from "./src/group-keys.js";
+export {
+  type CodeBlock,
+  convertCodeBlockToFlexBubble,
+  convertLinksToFlexBubble,
+  convertTableToFlexBubble,
+  extractCodeBlocks,
+  extractLinks,
+  extractMarkdownTables,
+  hasMarkdownToConvert,
+  type MarkdownLink,
+  type MarkdownTable,
+  type ProcessedLineMessage,
+  processLineMessage,
+  stripMarkdown,
+} from "./src/markdown-to-line.js";
+export {
+  createAudioMessage,
+  createFlexMessage,
+  createImageMessage,
+  createLocationMessage,
+  createTextMessageWithQuickReplies,
+  createVideoMessage,
+  getUserDisplayName,
+  getUserProfile,
+  pushImageMessage,
+  replyMessageLine,
+  showLoadingAnimation,
+} from "./src/send.js";
+export { validateLineSignature } from "./src/signature.js";
+export {
+  type ButtonsTemplate,
+  type CarouselColumn,
+  type CarouselTemplate,
+  type ConfirmTemplate,
+  createButtonMenu,
+  createButtonTemplate,
+  createCarouselColumn,
+  createConfirmTemplate,
+  createImageCarousel,
+  createImageCarouselColumn,
+  createLinkMenu,
+  createProductCarousel,
+  createTemplateCarousel,
+  createYesNoConfirm,
+  type ImageCarouselColumn,
+  type ImageCarouselTemplate,
+  type TemplateMessage,
+} from "./src/template-messages.js";
+export type {
+  LineChannelData,
+  LineConfig,
+  LineProbeResult,
+  ResolvedLineAccount,
+} from "./src/types.js";
+export { createLineNodeWebhookHandler, readLineWebhookRequestBody } from "./src/webhook-node.js";
+export {
+  createLineWebhookMiddleware,
+  type LineWebhookOptions,
+  startLineWebhook,
+  type StartLineWebhookOptions,
+} from "./src/webhook.js";
+export { parseLineWebhookBody } from "./src/webhook-utils.js";
+export { datetimePickerAction, messageAction, postbackAction, uriAction } from "./src/actions.js";
+export type { Action } from "./src/actions.js";
+export {
+  createActionCard,
+  createAgendaCard,
+  createAppleTvRemoteCard,
+  createCarousel,
+  createDeviceControlCard,
+  createEventCard,
+  createImageCard,
+  createInfoCard,
+  createListCard,
+  createMediaPlayerCard,
+  createNotificationBubble,
+  createReceiptCard,
+  toFlexMessage,
+} from "./src/flex-templates.js";
+export type {
+  CardAction,
+  FlexBox,
+  FlexBubble,
+  FlexButton,
+  FlexCarousel,
+  FlexComponent,
+  FlexContainer,
+  FlexImage,
+  FlexText,
+  ListItem,
+} from "./src/flex-templates.js";
+export {
+  cancelDefaultRichMenu,
+  createDefaultMenuConfig,
+  createGridLayout,
+  createRichMenu,
+  createRichMenuAlias,
+  deleteRichMenu,
+  deleteRichMenuAlias,
+  getDefaultRichMenuId,
+  getRichMenu,
+  getRichMenuIdOfUser,
+  getRichMenuList,
+  linkRichMenuToUser,
+  linkRichMenuToUsers,
+  setDefaultRichMenu,
+  unlinkRichMenuFromUser,
+  unlinkRichMenuFromUsers,
+  uploadRichMenuImage,
+} from "./src/rich-menu.js";
+export type {
+  CreateRichMenuParams,
+  RichMenuArea,
+  RichMenuAreaRequest,
+  RichMenuRequest,
+  RichMenuResponse,
+  RichMenuSize,
+} from "./src/rich-menu.js";

package/secret-contract-api.ts

@@ -0,0 +1,4 @@
+// Line does not expose secret-contract surfaces.
+export const secretTargetRegistryEntries: readonly [] = [];
+
+export function collectRuntimeConfigAssignments(): void {}

package/setup-api.ts

@@ -0,0 +1,2 @@
+export { lineSetupAdapter } from "./src/setup-core.js";
+export { lineSetupWizard } from "./src/setup-surface.js";

package/setup-entry.ts

@@ -0,0 +1,9 @@
+import { defineBundledChannelSetupEntry } from "autobot/plugin-sdk/channel-entry-contract";
+
+export default defineBundledChannelSetupEntry({
+  importMetaUrl: import.meta.url,
+  plugin: {
+    specifier: "./api.js",
+    exportName: "lineSetupPlugin",
+  },
+});

package/src/account-helpers.ts

@@ -0,0 +1,16 @@
+type LineCredentialAccount = {
+  channelAccessToken?: string;
+  channelSecret?: string;
+};
+
+export function hasLineCredentials(account: LineCredentialAccount): boolean {
+  return Boolean(account.channelAccessToken?.trim() && account.channelSecret?.trim());
+}
+
+export function parseLineAllowFromId(raw: string): string | null {
+  const trimmed = raw.trim().replace(/^line:(?:user:)?/i, "");
+  if (!/^U[a-f0-9]{32}$/i.test(trimmed)) {
+    return null;
+  }
+  return trimmed;
+}

package/src/accounts.ts

@@ -0,0 +1,187 @@
+import {
+  DEFAULT_ACCOUNT_ID,
+  normalizeAccountId as normalizeSharedAccountId,
+  normalizeOptionalAccountId,
+} from "autobot/plugin-sdk/account-id";
+import type { AutoBotConfig } from "autobot/plugin-sdk/account-resolution";
+import { resolveAccountEntry } from "autobot/plugin-sdk/account-resolution";
+import { tryReadSecretFileSync } from "autobot/plugin-sdk/core";
+import type {
+  LineAccountConfig,
+  LineConfig,
+  LineTokenSource,
+  ResolvedLineAccount,
+} from "./types.js";
+
+export { DEFAULT_ACCOUNT_ID } from "autobot/plugin-sdk/account-id";
+
+function readFileIfExists(filePath: string | undefined): string | undefined {
+  return tryReadSecretFileSync(filePath, "LINE credential file", { rejectSymlink: true });
+}
+
+function resolveToken(params: {
+  accountId: string;
+  baseConfig?: LineConfig;
+  accountConfig?: LineAccountConfig;
+}): { token: string; tokenSource: LineTokenSource } {
+  const { accountId, baseConfig, accountConfig } = params;
+
+  if (accountConfig?.channelAccessToken?.trim()) {
+    return { token: accountConfig.channelAccessToken.trim(), tokenSource: "config" };
+  }
+
+  const accountFileToken = readFileIfExists(accountConfig?.tokenFile);
+  if (accountFileToken) {
+    return { token: accountFileToken, tokenSource: "file" };
+  }
+
+  if (accountId === DEFAULT_ACCOUNT_ID) {
+    if (baseConfig?.channelAccessToken?.trim()) {
+      return { token: baseConfig.channelAccessToken.trim(), tokenSource: "config" };
+    }
+
+    const baseFileToken = readFileIfExists(baseConfig?.tokenFile);
+    if (baseFileToken) {
+      return { token: baseFileToken, tokenSource: "file" };
+    }
+
+    const envToken = process.env.LINE_CHANNEL_ACCESS_TOKEN?.trim();
+    if (envToken) {
+      return { token: envToken, tokenSource: "env" };
+    }
+  }
+
+  return { token: "", tokenSource: "none" };
+}
+
+function resolveSecret(params: {
+  accountId: string;
+  baseConfig?: LineConfig;
+  accountConfig?: LineAccountConfig;
+}): string {
+  const { accountId, baseConfig, accountConfig } = params;
+
+  if (accountConfig?.channelSecret?.trim()) {
+    return accountConfig.channelSecret.trim();
+  }
+
+  const accountFileSecret = readFileIfExists(accountConfig?.secretFile);
+  if (accountFileSecret) {
+    return accountFileSecret;
+  }
+
+  if (accountId === DEFAULT_ACCOUNT_ID) {
+    if (baseConfig?.channelSecret?.trim()) {
+      return baseConfig.channelSecret.trim();
+    }
+
+    const baseFileSecret = readFileIfExists(baseConfig?.secretFile);
+    if (baseFileSecret) {
+      return baseFileSecret;
+    }
+
+    const envSecret = process.env.LINE_CHANNEL_SECRET?.trim();
+    if (envSecret) {
+      return envSecret;
+    }
+  }
+
+  return "";
+}
+
+export function resolveLineAccount(params: {
+  cfg: AutoBotConfig;
+  accountId?: string;
+}): ResolvedLineAccount {
+  const cfg = params.cfg;
+  const accountId = normalizeSharedAccountId(params.accountId ?? resolveDefaultLineAccountId(cfg));
+  const lineConfig = cfg.channels?.line as LineConfig | undefined;
+  const accounts = lineConfig?.accounts;
+  const accountConfig =
+    accountId !== DEFAULT_ACCOUNT_ID ? resolveAccountEntry(accounts, accountId) : undefined;
+
+  const { token, tokenSource } = resolveToken({
+    accountId,
+    baseConfig: lineConfig,
+    accountConfig,
+  });
+
+  const secret = resolveSecret({
+    accountId,
+    baseConfig: lineConfig,
+    accountConfig,
+  });
+
+  const {
+    accounts: _ignoredAccounts,
+    defaultAccount: _ignoredDefaultAccount,
+    ...lineBase
+  } = (lineConfig ?? {}) as LineConfig & {
+    accounts?: unknown;
+    defaultAccount?: unknown;
+  };
+  const mergedConfig: LineConfig & LineAccountConfig = {
+    ...lineBase,
+    ...accountConfig,
+  };
+
+  const enabled =
+    accountConfig?.enabled ??
+    (accountId === DEFAULT_ACCOUNT_ID ? (lineConfig?.enabled ?? true) : false);
+
+  const name =
+    accountConfig?.name ?? (accountId === DEFAULT_ACCOUNT_ID ? lineConfig?.name : undefined);
+
+  return {
+    accountId,
+    name,
+    enabled,
+    channelAccessToken: token,
+    channelSecret: secret,
+    tokenSource,
+    config: mergedConfig,
+  };
+}
+
+export function listLineAccountIds(cfg: AutoBotConfig): string[] {
+  const lineConfig = cfg.channels?.line as LineConfig | undefined;
+  const accounts = lineConfig?.accounts;
+  const ids = new Set<string>();
+
+  if (
+    lineConfig?.channelAccessToken?.trim() ||
+    lineConfig?.tokenFile ||
+    process.env.LINE_CHANNEL_ACCESS_TOKEN?.trim()
+  ) {
+    ids.add(DEFAULT_ACCOUNT_ID);
+  }
+
+  if (accounts) {
+    for (const id of Object.keys(accounts)) {
+      ids.add(id);
+    }
+  }
+
+  return Array.from(ids);
+}
+
+export function resolveDefaultLineAccountId(cfg: AutoBotConfig): string {
+  const preferred = normalizeOptionalAccountId(
+    (cfg.channels?.line as LineConfig | undefined)?.defaultAccount,
+  );
+  if (
+    preferred &&
+    listLineAccountIds(cfg).some((accountId) => normalizeSharedAccountId(accountId) === preferred)
+  ) {
+    return preferred;
+  }
+  const ids = listLineAccountIds(cfg);
+  if (ids.includes(DEFAULT_ACCOUNT_ID)) {
+    return DEFAULT_ACCOUNT_ID;
+  }
+  return ids[0] ?? DEFAULT_ACCOUNT_ID;
+}
+
+export function normalizeAccountId(accountId: string | undefined): string {
+  return normalizeSharedAccountId(accountId);
+}

package/src/actions.ts

@@ -0,0 +1,61 @@
+import type { messagingApi } from "@line/bot-sdk";
+
+export type Action = messagingApi.Action;
+
+/**
+ * Create a message action (sends text when tapped)
+ */
+export function messageAction(label: string, text?: string): Action {
+  return {
+    type: "message",
+    label: label.slice(0, 20),
+    text: text ?? label,
+  };
+}
+
+/**
+ * Create a URI action (opens a URL when tapped)
+ */
+export function uriAction(label: string, uri: string): Action {
+  return {
+    type: "uri",
+    label: label.slice(0, 20),
+    uri,
+  };
+}
+
+/**
+ * Create a postback action (sends data to webhook when tapped)
+ */
+export function postbackAction(label: string, data: string, displayText?: string): Action {
+  return {
+    type: "postback",
+    label: label.slice(0, 20),
+    data: data.slice(0, 300),
+    displayText: displayText?.slice(0, 300),
+  };
+}
+
+/**
+ * Create a datetime picker action
+ */
+export function datetimePickerAction(
+  label: string,
+  data: string,
+  mode: "date" | "time" | "datetime",
+  options?: {
+    initial?: string;
+    max?: string;
+    min?: string;
+  },
+): Action {
+  return {
+    type: "datetimepicker",
+    label: label.slice(0, 20),
+    data: data.slice(0, 300),
+    mode,
+    initial: options?.initial,
+    max: options?.max,
+    min: options?.min,
+  };
+}