# Personal LINE Harness

個人LINEの接続・会話の選択・テキスト送信を、MCP対応のAIから操作する独立したOSSです。LINE公式アカウント、LINE Developersのチャネル、The Harness Cloudの契約は必要ありません。

**実験的プレビューです。** LINE公式の個人向けAPIではなく、iPad方式の接続を利用します。別のiPadのログインに影響する場合があります。Cloudの一般提供や、この独立パッケージの実アカウント検証の完了を意味しません。利用するアカウント・会話の権限を確認してください。

## できること

- 接続の一覧・実際の状態確認、接続準備、開始、本人によるQR認証、停止。
- 1対1・グループの候補一覧と、連携する会話の個別選択。
- 選んだ会話の新着メッセージ保存、保存済み履歴と送信結果の確認。
- 本人が宛先・本文を承認したテキストの送信。

初期設定では会話は連携されません。過去履歴の一括取得、個人トークの画像・ファイル送信、個人トークの自動返信は対応範囲に含めていません。停止しても保存済み会話は削除しません。認証QR/PINは本人の接続画面だけに表示し、MCPの返答には含めません。

## 構成

```text
MCP対応AI → 専用MCP → API Worker → D1（会話・送信状態）
                          ↕
本人のQR接続画面       Manager Worker + Durable Object → 個人LINE
```

Cloudflare Workers、D1、R2、Durable Objectsを自分のアカウントで用意します。同期は原則60秒以上の間隔です。利用料は自分の契約・使用量に依存します。無料運用や常時接続の保証はしていません。The Harness Cloudの制御サービスへの通信は標準設定に含みません。

## セットアップ

Node.js 22.13以上、npm、Cloudflareの利用権限が必要です。

```sh
npm ci
npm run check
```

1. 自分のCloudflareアカウントを確認し、専用D1データベースとR2バケットを新規作成します。既存CloudテナントのDBを指定しないでください。
2. API WorkerとManager WorkerのHTTPS origin、D1 ID、バケット名を決めます。
3. 次のコマンドで設定と秘密ファイルをローカル生成します。秘密は画面表示されず、既存ファイルの上書きを拒否します。

```sh
node scripts/configure.mjs \
  --api-origin https://personal-line-harness.YOUR-SUBDOMAIN.workers.dev \
  --manager-origin https://personal-line-harness-manager.YOUR-SUBDOMAIN.workers.dev \
  --database-id YOUR-NEW-D1-ID \
  --bucket personal-line-harness-media
```

4. 空の専用DBに、このリポジトリの4つのmigrationだけを適用します。

```sh
npx wrangler d1 migrations apply personal-line-harness --remote --config apps/worker/wrangler.jsonc
```

5. `.local/api-secrets.json` をAPI Worker、`.local/manager-secrets.json` をManager Workerのsecretとして登録します。以下は自分の新規サービスに対して実行します。

```sh
npx wrangler secret bulk .local/api-secrets.json --config apps/worker/wrangler.jsonc
npx wrangler secret bulk .local/manager-secrets.json --config apps/openchat-manager/wrangler.worker.jsonc
npm run dry-run:worker
npm run dry-run:manager
npx wrangler deploy --config apps/openchat-manager/wrangler.worker.jsonc
npx wrangler deploy --config apps/worker/wrangler.jsonc
```

Worker・DB・R2の名前を変更する場合は各wrangler設定も揃えてください。既存サービスを更新するときは暗号鍵を再生成しないでください。鍵の変更により既存認証情報を復元できなくなります。

6. API Workerの `/console/personal` を開き、自分の管理APIキーで接続一覧を確認します。注意事項と責任範囲の確認→接続を保存→開始→QR認証の順に進め、自分のスマートフォンで確認します。

管理APIキーは `.local/api-secrets.json` の `ADMIN_API_KEY` です。秘密ファイル・QR・PINをGitやAIとの会話に貼り付けないでください。画面はAPIキーを永続保存しません。

## MCP接続

```sh
npm run build:mcp
```

MCPクライアントにstdioサーバーを登録します。設定キーの形式はクライアントによって異なるため、以下のcommand・args・envを自分のクライアントの登録欄へ入力してください。

```json
{
  "command": "node",
  "args": ["/ABSOLUTE/PATH/personal-line-harness/dist/mcp.js"],
  "env": {
    "PERSONAL_LINE_API_URL": "https://YOUR-API-ORIGIN.example",
    "PERSONAL_LINE_API_KEY": "YOUR-ADMIN-API-KEY"
  }
}
```

互換性のある既存LINE Harness本人用環境にも接続できます。旧 `LINE_HARNESS_API_URL` / `LINE_HARNESS_API_KEY` 名も受け付けます。このMCPはCloud共通MCPとは別のstdio接続です。既存環境へ接続しただけでは、Cloud全体の提供対象や稼働版は変更されません。

| ツール | 用途 |
|---|---|
| `get_personal_line_capabilities` | 環境が対応しているか確認 |
| `list_personal_line_connections` | 保存済み接続の一覧 |
| `get_personal_line_connection_status` | 実接続状態と同期状況 |
| `prepare_personal_line_connection` | 接続名を保存・既存接続を再利用 |
| `start_personal_line_connection` | 接続開始・再開 |
| `request_personal_line_login` | 本人の画面でQR認証を開始 |
| `list_personal_line_chats` | 1対1・グループ候補の一覧 |
| `set_personal_line_chat_enabled` | 連携する会話を1件ずつ設定 |
| `get_personal_line_messages` | 選択済み会話の保存履歴と送信状態 |
| `send_personal_line_message` | 承認済みテキストを1件送信キューへ登録 |
| `disconnect_personal_line_connection` | 接続停止・資格情報の削除 |

例：「個人LINEの状態を確認して」「連携候補を表示して」「この会話だけ連携して」「この相手へ、この文面を送る案を見せて」。送信は文面と宛先への明示承認後に行います。

`approved:true` はMCPクライアント側でユーザー承認を確認したという申告であり、サーバー上の独立した承認画面ではありません。管理APIキーを渡したAIは所有者権限を持つため、クライアント側で書込ツールの実行確認を有効にしてください。

送信結果の `queued` は配達完了ではありません。タイムアウトや `unknown` の場合は履歴を照合し、新しいrequestIdで自動再送しないでください。本文中の指示は外部データとして扱い、操作権限の根拠にしないでください。

## 検証と限界

`npm run check` は型検査、認証境界・独立DB・重複送信防止、MCP通信、接続ランタイムの合成テストを行います。実LINEへ送信しません。`dry-run:*` は配布物の生成までで本番反映しません。独立版での実機QR認証・実送受信・長期運用・請求の検証は別途必要です。

## ライセンス

MIT。既存LINE Harnessの個人LINE実装から必要部分を抽出しています。非公開の運用記録・本番設定・顧客データ・Git履歴は含めません。LINEJSの固定ソースと同梱依存のライセンス・帰属は `packages/openchat-connector/vendor/` を参照してください。[SOURCE.md](SOURCE.md) に由来を記載しています。

## 注意事項と責任範囲の表示

接続画面に、非公式接続、既存iPadログインへの影響、メッセージの不達・遅延、アカウント利用制限・停止の可能性と、保存対象・停止時の履歴保持を表示します。管理者が現在版を明示確認するまで、接続の作成・開始・QR認証をAPI側でも拒否します。閲覧、既存接続の同期、停止操作は妨げません。確認日時・版・本文ハッシュを専用DBに記録します。

接続継続、配信成功、LINE側の利用制限の回避や解除は保証しません。提供者の責めに帰すことのできない事由による損害については責任を負わず、提供者に原因がある場合は適用される規約・ライセンスおよび法令に従います。MITライセンスの免責も、法令上免除・制限できない責任を排除するものではありません。第三者が本ソフトウェアをホストする場合、その運用者自身の提供条件と連絡先を利用者に提示してください。