omni-compression

概要

RTK（コマンド出力）、Caveman（文章）、スタック圧縮モードを設定します。言語パックやカスタムルールを管理し、プロンプト圧縮によってトークンを60～90％削減できるかテストします。

認証

すべてのリクエストには、有効なBearerトークンまたはセッションCookieが必要です。POST /api/auth/loginでトークンを取得するか、ローカル開発ではREQUIRE_API_KEY=falseを設定してください。

エンドポイント

POST /api/compression/preview

メッセージペイロードの圧縮をプレビューします

curl -X POST http://localhost:20128/api/compression/preview \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/compression/language-packs

Cavemanの圧縮言語パックを一覧表示します

curl http://localhost:20128/api/compression/language-packs \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/compression/rules

Cavemanの圧縮ルールのメタデータを一覧表示します

curl http://localhost:20128/api/compression/rules \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/compression/compare

POST compression › compare

curl -X POST http://localhost:20128/api/compression/compare \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

POST /api/compression/compare/verify

POST compression › compare › verify

curl -X POST http://localhost:20128/api/compression/compare/verify \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/compression/engines

GET compression › engines

curl http://localhost:20128/api/compression/engines \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/compression/retrieve

POST compression › retrieve

curl -X POST http://localhost:20128/api/compression/retrieve \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

ペイロード

リクエスト／レスポンスのスキーマの詳細は、GET /api/openapi/specまたはdocs/openapi.yamlにあるOpenAPI仕様全体を参照してください。

OmniRoute — 圧縮

OMNIROUTE_URLとOMNIROUTE_KEYが必要です。設定方法についてはエントリーポイントSKILLを参照してください。

概要

OmniRouteは、プロバイダーに転送する前にトークンのペイロードを圧縮します。コードの変更は不要です。一度設定すれば、すべてのリクエストに透過的に適用されます。

エンジン	最適な用途	一般的な削減率
RTK	ターミナル／ビルド／テスト／gitの出力	60～90%
Caveman	人間が書いた文章、チャット履歴	入力の46%
スタック（rtk → caveman）	コーディングを伴う混合セッション	78～95%
MCPアクセシビリティフィルター	ブラウザー／アクセシビリティツールの結果	60～80%

現在の設定を取得する

curl $OMNIROUTE_URL/api/settings/compression \
  -H "Authorization: Bearer $OMNIROUTE_KEY"

RTKを有効にする（コーディングエージェントに最適）

curl -X PUT $OMNIROUTE_URL/api/settings/compression \
  -H "Authorization: Bearer $OMNIROUTE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "mode": "rtk", "enabled": true }'

スタックモードを有効にする（削減効果を最大化）

curl -X PUT $OMNIROUTE_URL/api/settings/compression \
  -H "Authorization: Bearer $OMNIROUTE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "stacked",
    "enabled": true,
    "stackedPipeline": ["rtk", "caveman"]
  }'

Cavemanを有効にする（文章／チャット）

curl -X PUT $OMNIROUTE_URL/api/settings/compression \
  -H "Authorization: Bearer $OMNIROUTE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "mode": "standard", "enabled": true }'

Cavemanの強度：lite（安全）、standard（バランス重視）、aggressive（長時間のセッション向け）、ultra（コンテキストの復元）。

有効化する前に圧縮をプレビューする

curl -X POST $OMNIROUTE_URL/api/compression/preview \
  -H "Authorization: Bearer $OMNIROUTE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "rtk",
    "text": "$ npm test\n> jest\n\nPASS src/a.test.ts (2.1s)\nPASS src/b.test.ts (1.8s)\n..."
  }'

レスポンスにはcompressed、original_length、compressed_length、savings_pctが含まれます。

MCPアクセシビリティツリーフィルター（ブラウザーエージェントでの使用）

OmniRouteをブラウザー／Playwright MCPツールと併用すると、冗長なアクセシビリティツリーのツール結果が自動的に圧縮されます。デフォルトで有効です。しきい値は次のように設定します。

curl -X PUT $OMNIROUTE_URL/api/settings/compression \
  -H "Authorization: Bearer $OMNIROUTE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mcpAccessibility": {
      "enabled": true,
      "collapseThreshold": 30,
      "maxTextChars": 50000
    }
  }'

collapseThreshold：繰り返しがN回以上ある場合に、隣接する行をまとめます（デフォルトは30）。
maxTextChars：N文字を超えると、ナビゲーションのヒントを付けて切り捨てます（デフォルトは50000）。

言語パック（Caveman）

Cavemanは、pt-BR、es、de、fr、ja向けの言語対応ルールをサポートしています。

curl -X PUT $OMNIROUTE_URL/api/settings/compression \
  -H "Authorization: Bearer $OMNIROUTE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "standard",
    "cavemanConfig": {
      "language": "pt-BR",
      "autoDetectLanguage": true
    }
  }'

MCP経由

omniroute_compression_status     → current settings + savings analytics
omniroute_compression_configure  → update mode/threshold/language
omniroute_set_compression_engine → switch engine at runtime

圧縮を無効にする

curl -X PUT $OMNIROUTE_URL/api/settings/compression \
  -H "Authorization: Bearer $OMNIROUTE_KEY" \
  -d '{ "enabled": false }'

エラー

• 400 invalid mode → off、lite、standard、aggressive、ultra、rtk、またはstackedを使用してください
• 400 invalid stackedPipeline → 配列には有効なエンジンID（rtk、caveman）を含める必要があります