OWL リリースノート¶
このドキュメントでは、OWL CLI(owl)、OWL Registry(registry)、および両者が共有する共通ツールカタログの変更を記録します。
1.9.1(2026/11/20)¶
この OWL CLI hotfix は、CLI の自動更新後に旧版 Registry のツール引数と互換性がなくなる問題を修正します。
不具合修正¶
- DQL の自動事前検査で、旧 checker に未定義の
start_time、end_timeを送信し、クエリが実行できなくなる問題を修正しました。CLI は最初に対象 Registry の checker schema を読み取ります。checker が時間コンテキストをサポートしない場合、owl execは追加された自動時間検査をスキップし、元のクエリと時間引数を保持します。owl validateを明示的に実行した場合は、旧 schema に従って基本的な DQL 検証を行い、checker の結果を保持します。 - CLI の引数準備と静的検証は、Registry が公開する schema に従います。省略された引数にのみ schema の既定値を適用します。システムツールと DPoP イベントの子呼び出しも、先にツール定義を確認します。ユーザーが指定した識別情報、フィルター、カーソル引数が未対応の場合はエラーを返し、リクエスト範囲の変更を防ぎます。
- 同一組織のワークスペース一覧では、schema に定義された既定値と引数範囲を使用します。レスポンスにページサイズがない場合は、実際のリクエスト値を使用します。schema が許可する大きなページと、サーバーが返すカーソルによるページ送りをサポートします。
アップグレードと互換性に関する説明¶
- この引数互換性の修正は、CLI を単独で更新して利用できます。DQL の構文と機能は、対象 Registry とお客様の環境にある
dqlcheckによって決まります。checker が時間コンテキストをサポートする場合は時間検査を継続します。schema の取得や checker の実行に失敗した場合は、引き続きエラーを返します。 - 業務ルールは Registry と上流サービスが検証します。
owl validateの静的検証に成功しても、業務リクエストの成功を保証するものではありません。
1.9.0(2026/11/18)¶
新機能¶
owl login --dpopとowl logoutを追加し、Studio の一時認証コードでログインし、DPoP 認証情報を取り消せるようにしました。CLI はローカルで秘密鍵を生成してリクエストに署名し、Agent はOWL_TEMP_CODEから一時コードを提供できます。owl profile add <alias>:Studio の一時コードを使用して DPoP アカウントを追加します。--fromはサイトおよび ID 以外の設定のみを提供します。複数のプロファイルの使用。- Registry は DPoP ログイン、取り消し、ツールリクエストの転送をサポートし、元の HTTPS URL と DPoP proof をバインドして署名したうえで、対応する AIAPI に渡します。Linux/macOS と Windows のインストーラーは、CLI がサポートしている場合に新しいログインフローを使用します。
不具合修正と改善¶
- 標準 Registry イメージを固定 digest の Alpine 3.24 に更新し、
brotli-libs>=1.2.1-r0を要求するようにして、CVE-2026-111497を修正しました。この項目は UOS イメージには該当しません。DPoP リクエストでは汎用の転送リトライを使用せず、有効な新しい nonce challenge の後に一度だけリトライします。
アップグレードと互換性に関する説明¶
- 対象サイトの Studio/AIAPI と Registry が DPoP をサポートしていることを確認してから、共用インストールチャネルを更新してください。管理者は AIAPI の署名ターゲットと、それに一致する
siteIdを設定する必要があります(イメージではOWL_AIAPI_SIGNING_SITE_IDを使用)。Ingress が TLS を終端する場合はaiapiSigning.dpopTrustedProxiesを設定し、パスを書き換える場合はdpopUseOriginalURIを有効にし、Ingress で転送ヘッダーを上書きします。 - 既存の API キープロファイルは引き続き使用できます。
profile addとprofile add --fromでは引き続き新しいアカウントの一時コードが必要で、ソースファイルの API キー、token_file、DPoP バインディングはコピーされません。旧スクリプトはOWL_TEMP_CODEを提供するように変更する必要があります。 - DPoP 認証情報は、対象サイトがサポートする HTTP ツールでのみ使用でき、外部 MCP ツールや個人用 API キー管理ツールには使用できません。DPoP の
workspace useにはワークスペース UUID が必要です。 - 同じインストール内では、同じサイトと同じアカウントの複数の別名が DPoP ログイン状態を共有するため、1 つからログアウトすると残りの別名からも同時にログアウトします。ワークスペース一覧、API キー取得、キーに依存するワークスペース管理コマンドでは、引き続き API キープロファイルを使用する必要があります。バックアップ時は、秘密鍵を含む
dpop/ディレクトリを適切に保管してください。複数のプロファイルの使用。
1.8.0(2026/11/04)¶
新機能¶
- Registry は、設定済みの Studio/AIAPI ターゲットに送信元 IP V2 署名を追加しました。HTTP API、リモート MCP、および関連する子呼び出しは署名を共有し、送信ごとおよびトランスポート層のリトライごとに nonce と署名を再生成します。
owl.field_schema.searchを追加し、キーワード、タイプ、namespace、measurement で現在権限のあるワークスペースのフィールド設定を検索し、タイプ、単位、単位のソースを返します。ページネーションをサポートし、デフォルトは 100 件、最大 1000 件です。全件取得用のowl.field_schema.getは保持されます。検索はフィールドが不明な場合またはコンテキストが無効になった場合にのみ行い、空の結果はストレージにデータがないことを意味しません。- イベント offset、コメントページ番号、インフラストラクチャと同一組織のトレースカーソル、トポロジグループ化パラメータ、および Monitor/SLO/Member のオプションのページネーションを補完しました。後続ページでは同じフィルター条件、時間範囲、権限コンテキストが保持されます。追加されたページネーションフィールドを省略する既存の呼び出しは、元のセマンティクスを維持します。
- ノートの変更と削除で
expected_etagをサポートし、読み取り時のバージョンにバインドします。書き込みエラーでは完了段階、リソースの識別情報、復旧情報を保持し、書き込み失敗と書き込み後の読み戻し失敗を区別できるようにします。
不具合修正と改善¶
- 送信元 IP は
X-Forwarded-Forの最初のアドレスを優先し、ヘッダー全体が欠落しているか空白の場合にのみ接続相手側にフォールバックします。空でないヘッダーの最初のアドレスが無効な場合は署名を拒否し、後続のアドレスに切り替えません。保護対象のターゲットでは自動リダイレクトを禁止します。 - CLI、REST、MCP は上流の構造化エラー、DQL 診断、書き込み復旧情報を保持します。CLI はパラメータヘルプ、組み合わせ検証、クラスタリングクエリの時間事前チェックを改善しました。P95 の例を修正し、LN、クエリ limit、Pipeline サンプル、LLM アプリケーションカテゴリの契約を補完しました。クラスタリングの処理量は、完全な時間ウィンドウのカバレッジを表すものではありません。
- 外部 MCP は失敗状態と複数パートのテキストの順序および境界を保持します。タイムアウト、キャンセル、stdio プロセスの終了、パイプ読み取り、npx の復旧を修正し、単一メッセージの上限を 1 MiB としました。出力と stderr の認証情報マスキングを強化しました。ツールのリスク注釈は検出およびキャッシュとともに伝播されますが、権限や承認の代替にはなりません。
アップグレードと互換性に関する説明¶
- 追加された契約をサポートする Studio を先にデプロイしてから、Registry をアップグレードしてツールカタログを更新してください。CLI では
owl syncを実行し、MCP クライアントではツールを再検出します。ツールカタログの同期では CLI バイナリは更新されません。新しいヘルプ、ローカル検証、完全なエラー診断を利用するには、CLI をアップグレードする必要があります。 - Registry イメージの組み込み設定では、署名がデフォルトで有効になっています。管理者は
OWL_AI_API_BASE_URLとOWL_AIAPI_SIGNING_SECRET_BASE64を設定し、Studio が V2 をサポートしていることを確認する必要があります。双方は同じ 32 バイトキーの標準 Base64 値を使用します。アドレスまたはキーが欠落していると起動に失敗します。既存のカスタム設定ではaiapiSigningを同期する必要があります。省略した場合は引き続き無効です。stdio を使用する場合やこの機能を使用しないデプロイでは、aiapiSigning.enabled: falseを明示的に設定してください。 - Ingress ゲートウェイは
X-Forwarded-Forを正しく設定およびクリーンアップする必要があります。Studio/ゲートウェイは保護対象パスの署名欠落リクエストを独立して拒否し、ホワイトリスト、権限、時間ウィンドウ、nonce の重複排除を実施します。Owl のみをアップグレードしても、保護チェーン全体が有効になるわけではありません。 - ノートのバージョン競合が発生した場合は再読み取りして確認し、ETag を自動で置き換えて再送信しないでください。
expected_etagを省略した場合は読み取り後の書き込み保護が提供されません。モニター更新で状態、アラートポリシー、タグを省略した場合は元の値が保持され、明示的な空リストはクリアを意味します。書き込みが完了しているのに読み戻しに失敗した場合は、重複して作成しないでください。送信状態が不明な場合は先に確認してください。
1.7.0(2026/10/28)¶
新機能¶
owl.catalog.entity_create、owl.catalog.entity_modify、およびチーム検索用のowl.workspace.member.group_listを追加しました。カタログ検索では名前、URN、属性によるフィルタリングをサポートします。- CLI に
runtime-profile/v1を追加しました。エグゼキューターがユーザーごとに独立したプロファイルと認証情報を注入し、認証情報は設定に書き込まれません。 owl.data.read_dql_docsを追加し、検索で返されたツール参照に従って、Registry から DQL ドキュメント本文をページ単位で読み取ります。
不具合修正と改善¶
- DQL 検証では、元のクエリ、解析またはバインドの診断、利用可能な行・列情報を保持し、クエリエラーとバリデーター使用不可を区別します。
- CLI コマンドログのリクエストヘッダー長を制限し、長いインラインパラメータによる転送失敗を回避しました。業務パラメータは引き続き完全なリクエストボディで転送されます。
- インフラストラクチャのフィルターから上流がサポートしない
likeを削除し、=、!=、inをサポートしました。
アップグレードと互換性に関する説明¶
- CLI と Registry をセットでアップグレードした後、
owl syncを実行し、MCP クライアントでツールを再検出してください。カタログへの書き込みは対応する AIAPI / Backend に依存します。使用方法はカタログエンティティの作成と変更を参照してください。 - DQL ドキュメントを読み取る際は、返された
read_referenceを使用し、Agent のローカルでreferences_dirを読み取らないでください。ランタイムプロファイルを有効にする対応順序は、Owl → Agent 完全リリースパッケージ → ユーザーモードを有効にして再インストールです。ロールバックする前にユーザーモードを無効にして再インストールしてください。
1.6.1(2026/10/23)¶
セキュリティ修正¶
- CLI、標準 Registry、UOS Registry のビルドツールチェーンを Go 1.27.3 にアップグレードし、
crypto/x509の CVE-2026-111943 を修正しました。アドバイザリに記載された信頼できない中間証明書を信頼しないようにします。ソースからのビルドには Go 1.27.3 以降が必要です。
1.6.0(2026/10/21)¶
新機能¶
owl.event.resolve:イベントドキュメント ID、イベントまたはインシデント ID、リンクからイベント詳細を解決します。owl.account.workspace.same_org.list:CLI ツールのエントリポイントを追加し、同一組織の Trace クエリの候補ワークスペースを検出します。
不具合修正と改善¶
- CLI、HTTP、MCP でパラメータと時間範囲の検証を統一し、インフラストラクチャのフィルター条件、ワークスペースのページネーション、イベント詳細パラメータの検証を強化しました。
owl exec -f jsonの事前チェックが失敗すると、構造化 JSON と非ゼロの終了コードを返します。 owl syncは、いずれかのカテゴリのダウンロードに失敗すると失敗を返し、失敗したカテゴリの既存キャッシュとローカルバージョンを保持します。初回の自動同期が失敗すると後続の実行がブロックされます。キャッシュ期限切れ後の自動同期失敗は従来どおり警告を出し、既存のキャッシュを使用します。
アップグレードと互換性に関する説明¶
- CLI と Registry をセットでアップグレードした後、
owl syncを実行し、MCP クライアントでツールを再検出してください。owl.event.getは引き続き一覧で返された元のdoc_idを使用します。イベント ID、インシデント ID、またはリンクを使用する場合はowl.event.resolveを使用します。 - v1.6.0 では 13 桁の整数ミリ秒タイムスタンプを統一的に検証し、終了時間が開始時間より大きいことを要求します。ペアで提供する必要があるパラメータは片方だけを渡すことはできません。必須要件と最大スパンは各ツールのスキーマに従います。
owl.data.queryの時間範囲は最長 7 日です。 owl.data.queryの DQL ではインラインの時間ウィンドウを省略でき、クエリウィンドウはstart_time/end_timeで指定します。インラインの絶対ウィンドウは外部ウィンドウと一致している必要があり、相対ウィンドウは拒否されます。PromQL の範囲セレクターはルックバック期間を表し、クエリウィンドウとしては扱われず、DQL 検証にも入りません。Registry には利用可能なdqlcheckが必要です。検証が利用できない場合、DQL クエリは実行されません。リクエストのウィンドウは、バックエンドが実際に実行した時間範囲や結果がカバーする時間範囲とは同一ではありません。
1.5.0(2026/10/14)¶
OWL CLI の新機能¶
- CLI に独立したプロファイル管理とアカウント切り替え機能を追加しました。
owl profile add/list/current/rename/removeで複数の完全な設定を保存および管理し、owl switch、--profile、またはOWL_PROFILEで設定を永続的または一時的に選択できます。各名前付きプロファイルは、設定、認証情報、キャッシュ、データ、ログを個別に保存します。(#21) - CLI に Bash および PowerShell のオフライン補完を追加し、コマンド、プロファイルの別名、カテゴリ、ツール名、ツールパラメータ、スキーマの列挙値を候補表示できます。補完は現在のプロファイルのローカルキャッシュのみを読み取り、ネットワークに接続せず、ツールも実行しません。(#24)
OWL CLI の不具合修正と改善¶
- Bash 補完の候補マッチングを強化し、スキーマ内の shell 特殊文字、スペース、URL をすべてリテラル値として扱います。(#24)
owl profile remove --purgeのクリーンアップに失敗した場合に、設定と認証情報が先に削除される可能性がある問題を修正しました。失敗後は権限を修正して再試行できます。(#21)
OWL Registry と共通ツールカタログ¶
owl.external_datasource.listとowl.external_datasource.queryを追加し、現在のワークスペースでアクセス可能な外部データソースを検出し、一覧で返されたdatasource_uuidを使用して単一の制限付き読み取り専用 SQL を実行できます。(#13)- Registry のログでは、
sql、rows、ネストされたargumentsなどの機密フィールドが完全にマスクされます。(#13) owl.metric.list、owl.rum.list、owl.apm.list、owl.network.list、owl.profile.list、owl.logging.list、owl.billing.list、およびowl.infrastructure.list/getでは、13 桁のミリ秒単位のstart_timeとend_timeを渡す必要があります。時間ウィンドウは最長 7 日です。(#25)owl.llm.listの時間範囲は引き続き任意です。start_timeとend_timeの両方を省略した場合は、直近 24 時間をクエリします。(#25)- DQL クエリツールの
dql_namespace/namespaceスキーマに、完全な列挙と一般的なデータ型のマッピングを追加しました。owl.data.show_dql_namespaceは完全な型の意味を提供し、返されるdql_namespace値がowl.data.queryでは引き続き同名のフィールドを使用し、simple query とログクラスタリングツールではそのままnamespaceに渡す必要があることを明確にします。既存のフィールド名とリクエスト転送の動作は変更されません。
アップグレードと互換性に関する説明¶
- プロファイルが選択されていない場合は、引き続き元の
${OWL_DIR}/config.yamlを使用します。ルート設定はdefaultとして保持され、自動移行は行われません。CLI の--confは非推奨です。設定をインポートした後は--profileに切り替えることを推奨します。Registry サービスの--configには影響しません。(#21) - Registry または共通カタログをアップグレードした後、
owl syncを実行してください。上記の discovery および infrastructure ツールを呼び出す際は、時間範囲を明示的に渡す必要があります。owl.llm.listは引き続き時間範囲を省略できます。(#25)
1.4.0(2026/09/23)¶
新機能¶
- 認可されたクロスワークスペースデータクエリを追加しました。
owl.workspace.data_authorized.listで認可されたワークスペースを検出し、workspace_uuidsとtarget_regionを DQL ツールに渡します。現在のワークスペース内のクエリではワークスペースを検出する必要はありません。同一組織のクロスワークスペース Trace では引き続き専用のツールを使用します。 workspaceカテゴリを追加し、認可されたワークスペース一覧とowl.workspace.member.listを含めました。旧名owl.member.listは呼び出し別名として保持され、CLI と MCP の両方で新しいツールのパラメータと権限検証を再利用します。owl.incident.getを追加し、インシデント UUID から詳細とページネーションされた関連イベント参照を取得し、owl.event.getでイベント内容を読み取ります。
不具合修正と改善¶
- 過去の
testing-<SHA>ビルドがowl updateでアップグレードできない問題を修正しました。Linux/macOS と Windows のインストーラーは、現在の設定チャネルの正式バージョンへの移行をサポートし、既存の設定と SHA256 検証を保持します。通常のバージョンは引き続きアップグレードのみでダウングレードは行わず、同一バージョンはインストールをスキップし、認識できないバージョンは引き続きエラーになります。(#226) - CLI と MCP は AIAPI のエラー診断フィールドと trace ID を保持し、クロスワークスペースクエリの失敗原因を特定しやすくしました。
- パラメータの事前チェックで JSON Schema の union 型をサポートし、各型ブランチの制約検証を保持します。
- 静的 MCP ツールに OpenAI メタデータを追加し、OAuth Bearer token が上流に転送される問題を修正しました。
アップグレード要件¶
- 対象サイトに対応する AIAPI がデプロイされていることを確認してください。これには
/api/v1/workspace/data_authorized/list、クロスワークスペースクエリの契約、/api/v1/incident/getが含まれます。 - CLI と Registry のプログラムをセットでアップグレードし、
owl syncを実行してカタログを全量更新してください。MCP クライアントではツールを再検出します。旧版 CLI は別名をサポートしていないため、カタログを同期するだけでは旧コマンドが使用できるとは限りません。 - 旧
memberカテゴリは削除されました。認可されたワークスペースの検出には、統一的にowl.workspace.data_authorized.listを使用します。詳細は移行手順を参照してください。
1.3.0(2026/08/26)¶
今回のリリースは機能イテレーションリリースであり、主な更新内容は次のとおりです。
新機能¶
- CLI にグローバルな
--confパラメータを追加し、設定ファイルを明示的に選択できるようにしました。設定の表示と書き込みは、選択したファイルに従います。 - CLI に
registry.insecure_skip_verifyとregistry.request_timeout設定を追加し、制御された開発環境や長時間かかるデータクエリで使用できるようにしました。TLS 検証のスキップはデフォルトで無効、リクエストタイムアウトのデフォルトは 150 秒です。 - Registry に、OAuth Broker を統合するサイトルーティングと token issuer/audience の検証を追加しました。ターゲット AI API はサーバー側のホワイトリストで決定されます。
- Center MCP は設定に応じて静的ツールを直接公開し、指定したツールを除外できます。デフォルトでは引き続き既存の facade ツールを使用します。
- Registry に OpenAI Apps のチャレンジエンドポイントを追加しました。token が設定されていない場合は無効のままで、404 を返します。
- Registry のローカルデプロイ補助フローを追加し、リモート AI API と S3 サービスを設定できるようにしました。
不具合修正/改善¶
- OAuth 上流の未認可レスポンスを保持し、呼び出し元が認証情報の問題を正しく識別できるようにしました。
owl.data.simple_query_fileのlimitは、実行前に 1 から 10000 の範囲で検証されるようになりました。- データクエリツールのタイムアウトを 130 秒に調整し、Registry クライアントのデフォルトタイムアウトを 150 秒に調整して設定可能にしました。
- Registry イメージにバージョンとリビジョン情報を書き込み、リリースプロセスの回帰テストを追加して、ビルド成果物の追跡性を向上させました。
互換性の調整¶
- 既存の CLI コマンドとデフォルト設定パスは変更されません。
--confは新しいエントリポイントであり、TLS 検証のスキップはデフォルトで無効です。 - MCP はデフォルトで引き続き facade ツールを公開します。サイトルーティングと OpenAI Apps のチャレンジは、いずれも明示的に設定したうえで有効にする必要があります。
- まだ完全に設計されていない Agent Protocol(
owl agent --stdioを含む)は、今回のリリースには含まれません。
1.2.1(2026/08/07)¶
今回のリリースは hotfix 修正であり、内容は次のとおりです。
不具合修正¶
- data タイプのツールが生成する結果ファイル ID が長すぎる問題を修正しました。新しいファイルでは 22 文字の URL-safe ランダム ID を使用し、長いパラメータによってファイル名やパスが長くなるリスクを減らし、Agent が後続のコマンドで参照しやすくしました。(#8)
owl.data.simple_queryとowl.data.simple_query_fileがパラメータスキーマのみを検証し、自動生成された DQL を検証していなかった問題を修正しました。実行前に同等の DQL を構築し、Registry の DQL 検証機能を呼び出すことで、無効なクエリ断片を事前にブロックします。(#7)
機能改善¶
- simple query で生成された DQL の検証に失敗すると、構造化された
generated_dql/dql.builderErrorの問題を返し、Agent がwhere_clause、select_clause、group_by_clauseなどのパラメータを特定して修正しやすくしました。(#7)
互換性の調整¶
- data ファイルのインデックス形式と安定した
queryKeyは変更されず、既存のインデックスと結果ファイルは引き続き読み取れます。新しく生成されるファイルの ID とファイル名のみが短くなります。(#8) - 正当な simple query の呼び出し方法とリモート実行経路は変更されません。無効な DQL のみが、リクエスト送信前のより早い段階で失敗します。(#7)
1.2.0(2026/08/05)¶
今回のリリースは機能イテレーションリリースであり、主な更新内容は次のとおりです。
新機能¶
- CLI に
owl validate、owl tool validate、owl capabilitiesを追加しました。対象ツールを実行せずにパラメータスキーマとツール固有の構文を検証でき、構造化された結果を Agent の判断と修正に利用できます。(#6) - アカウントのワークスペースとローカルプロファイルの管理機能を追加しました。ワークスペース一覧、アクセスキーの取得、ワークスペースの切り替え、現在のコンテキストの表示が含まれます。プロファイルはワークスペースの認証情報と現在のコンテキストの管理に使用され、キャッシュと data ファイルは引き続き設定された共有パスを使用します。(
3da3e8e) - 同一組織のワークスペース検出を追加し、データクエリで
same_org_workspace_uuidsを使用して同一組織の複数のワークスペースをクエリできるようにしました。クロスワークスペースの Trace 検索に利用できます。(71fa73e) owl execにバージョン更新の通知を追加しました。CLI は更新チャネルに従ってスロットリングしながら新しいバージョンを確認し、JSON 出力のnoticeフィールドでアップグレードを通知します。このフィールドは既存の解析に影響しません。(7c7113c)- 共通ツールカタログに mdsearch のドキュメント検索と SLO 一覧機能を追加しました。(
135c8ff、18f87b0) - 共通ツールカタログに Studio Notes V2 のノート一覧、作成、変更、削除機能を追加しました。(
a72af5f) - 共通ツールカタログにデータ転送ルールの検出と非同期クエリ機能を追加しました。(
6c37c93、c6dcd80) - 共通ツールカタログに Dashboard 一覧機能を追加しました。(
6c98f0b) - Linux、macOS、Windows の 5 プラットフォーム向け OSS 自動リリースパイプラインを追加しました。テストチャネルで検証が完了した後、同じビルド成果物を本番チャネルに昇格できます。(
9fba8e2)
不具合修正¶
- HTTP ツールの上流がクライアントエラーを返した際に、Registry が元のステータスとエラー情報を失う問題を修正しました。CLI はより正確で実行可能な失敗原因を取得できるようになりました。(
e1267e0) - Dashboard の大きな結果が依然として text パスで返される問題を修正しました。関連ツールは結果を data ファイルに保存するようになり、大きなペイロードが Agent のコンテキストを占有するのを回避します。(
68cac16) - データ転送クエリの結果が依然として text パスで返される問題を修正しました。クエリ結果は data ファイルに書き込まれるようになりました。(
30aa6fc) - ワークスペースの認証情報の切り替えおよび表示時に、アカウント情報が混同される可能性がある問題を修正しました。設定出力ではデフォルトでキーが非表示になり、明示的に要求した場合にのみ元の secret が表示されます。(
3da3e8e) - Streamable MCP セッションは、確立前に認証が完了するようになりました。未認可のリクエストではセッション状態が作成されません。(
2a5d8e9)
機能改善¶
owl execとowl validateのパラメータ解析および事前チェックロジックを統一し、すべてのパラメータ問題を一度に返せるようにしました。検証前に通常の初回利用時またはキャッシュ期限切れ時の自動同期が実行されます。それでもtool_not_foundが返される場合は、明示的にowl syncを実行してから再試行してください。(#6)- CLI 操作は安定した operation ID を保持し、Registry リクエストと上流の失敗の間で追跡情報を透過的に伝達するため、層をまたいだ問題の特定が容易になります。(
386abc0) - ログ内の機密 token は、問題の関連付けに使用できる先頭と末尾の文字のみを保持し、中間部分はマスクしたままにして、完全な認証情報がログに記録されるのを防ぎます。(
6a6d0ad)
互換性の調整¶
list、show、exec、schemaなどの既存の短縮コマンドおよびtool/tools名前空間は引き続き互換性があります。validateとcapabilitiesは新しいエントリポイントです。(#6)- 旧版の
token、auth.token、workspaces.<name>.token、auth.token_file設定は引き続き読み取れます。新しく書き込まれる認証情報は統一的にapi-keyを使用し、古い設定を積極的に削除することはありません。(3da3e8e) owl.data.queryの PromQL モードは DQL バリデーターに入りません。既存の正当なクエリと MCP ツールの呼び出し方法は変更されません。(#6)
1.0.11(2026/05/25)¶
今回のリリースはイテレーションリリースであり、主な更新内容は次のとおりです。
新機能¶
dataカテゴリに CLI 専用ツールowl.data.simple_query_fileを追加しました。CLI が最新の共通ツールカタログを同期した後、simple query パラメータで既存の simple query バックエンド API を呼び出し、既存の data ファイルライフサイクルで結果を保存できます。owl.data.simple_query_fileと MCP ツールowl.data.simple_queryは独立した公開面を維持し、大きな結果が MCP の text/context パスで返されるのを回避します。
機能改善¶
- 実際の public config を使用した回帰テストを追加し、
owl.data.simple_query_fileの CLI での可視性、MCP での非可視性、outputType: data、認証方式、パラメータスキーマをカバーしました。
互換性の調整¶
- 既存の MCP ツール
owl.data.simple_queryは、outputType: textと MCP 専用の公開方法を変更せずに維持します。
1.0.10(2026/05/18)¶
今回のリリースは hotfix 修正であり、内容は次のとおりです。
不具合修正¶
registry.endpointに末尾スラッシュ付きのアドレスを設定した場合、CLI が Registry API パスを結合する際に二重スラッシュが生成され、owl syncが nginx 404 を返す可能性がある問題を修正しました。- Registry Client は構築時に endpoint を正規化するようになり、
http://testing-owl-api.dataflux.cn/とhttp://testing-owl-api.dataflux.cnを同じ Registry アドレスとして扱えます。
機能改善¶
- Registry Client と
SyncAllの回帰テストを追加し、末尾スラッシュ付き endpoint でのカテゴリ同期パスをカバーして、今後の URL 結合の劣化を防ぎます。
互換性の調整¶
- ユーザー設定の形式は変更しません。末尾スラッシュなしの既存 endpoint は元の動作を維持し、末尾スラッシュ付き endpoint も互換性があります。
1.0.9(2026/05/12)¶
今回のリリースはイテレーションリリースであり、主な更新内容は次のとおりです。
新機能¶
dataカテゴリにowl.logging.cluster_task.createを追加しました。CLI が最新の共通ツールカタログを同期した後、非同期ログクラスタリング分析タスクを作成できます。dataカテゴリにowl.logging.cluster_task.getを追加しました。create で返されたtask_idを使用して、非同期ログクラスタリング分析の結果をクエリできます。- ログクラスタリングタスクは完全な
queryを渡すことができ、namespace、conditions、timeRange、analysisField、indexesを指定してバックエンドにクエリを組み立てさせることもできます。
機能改善¶
dataカテゴリの説明とバージョンを更新し、共通カタログにログクラスタリングタスクの作成およびクエリ機能が含まれていることを明確にしました。- loader と Registry server の回帰テストを追加し、ログクラスタリングタスクのスキーマ解析、必須パラメータ検証、REST 実行の転送をカバーしました。
互換性の調整¶
- 今回の変更はツールの追加であり、既存の
owl.logging.list、owl.data.query、その他の data カテゴリツールの呼び出し方法は変更されません。
1.0.8(2026/05/07)¶
今回のリリースはイテレーションリリースであり、主な更新内容は次のとおりです。
新機能¶
dataカテゴリの検出経路にowl.logging.listとowl.billing.listを追加しました。CLI が最新の共通ツールカタログを同期した後、ログとクラウド請求の source / field を直接検出できます。owl.metric.listはmode=tagでメトリクスの tag key を検出でき、sourceでフィールドまたは tag の結果をフィルタリングできます。- data の結果ファイル名は、読みやすいプレフィックスを保持したうえで UUID を追加し、重複クエリや複数セッションの同時実行時に同名ファイルが上書きされるのを回避します。
- data ファイルインデックスに安定した
queryKeyを追加し、同一クエリの識別に使用できるようにするとともに、旧版index.jsonとの互換性を維持します。
不具合修正¶
- 検出ツールのスキーマが
sourceパラメータを宣言していないため、owl exec ... --source ...がローカルパラメータ検証で拒否される問題を修正しました。 - AIAPI discovery list が
success:falseの業務エラーを返した場合に、Registry REST と MCP HTTP ツールの外層が依然として成功と誤報告する可能性がある問題を修正しました。 - インストーラーの
--owl-dir/-OwlDirでカスタム Owl ディレクトリを指定した後、後から直接owl config showを実行するとデフォルトの設定ディレクトリにフォールバックする可能性がある問題を修正しました。
機能改善¶
- README と使用ドキュメントのデータ検出例を更新し、
mode=field、mode=tag、owl.logging.list、owl.billing.listの呼び出し方法を追加しました。 - 共通カタログの同期メッセージを調整し、共通カタログがヒットした際に誤解を招きやすい
Scope: public catalogが出力されないようにしました。 owl data cleanはデフォルトで 1 日前のファイルをクリーンアップし、--days 0または負の値は 1 日として扱います。owl data cleanは index に登録された期限切れファイルのみをクリーンアップし、未登録の孤立ファイルは従来どおり、積極的にスキャンして削除することはありません。- Linux/macOS と Windows のインストーラーは、インストール先の横に
.owldirパスを記録し、カスタムディレクトリを使用していない場合またはアンインストール時に古い記録をクリーンアップします。これにより、CLI はOWL_DIR環境変数がない場合でもカスタム設定、キャッシュ、データディレクトリを引き続き特定できます。 - loader、executor、Registry REST、MCP の discovery スキーマと業務エラーの回帰テストを追加しました。
- CLI 設定解析とインストーラーのカスタムディレクトリ回帰テストを追加し、
.owldir記録の読み取り、config showのパス表示、インストール後のディレクトリ配置をカバーしました。
互換性の調整¶
owl execのパラメータ形式は変更されず、引き続き--key value、key=value、-pJSON、--stdinをサポートします。- メトリクス以外の discovery ツールでは
mode=source|fieldのみ使用できます。mode=tagはowl.metric.listにのみ適用されます。
1.0.7(2026/04/29)¶
今回のリリースはイテレーションリリースであり、主な更新内容は次のとおりです。
新機能¶
- CLI に
tool名前空間を追加し、tools別名を保持しました。このエントリポイントはlist、show、exec、schemaなどのトップレベルコマンドに加える補助形式として、Agent がコマンド形式を推測する際の耐障害性を向上させます。 categoryにcategories別名を追加し、Agent が自然なコマンド推測方法でカテゴリ機能を検出しやすくしました。
不具合修正¶
owl help tool、owl help categoriesなどのヘルプトピックを解決できない問題を修正しました。- 一部の
--help呼び出しで設定の初期化や Registry 依存関係が早期に発生する問題を修正し、ヘルプコマンドが未設定の環境でも直接返せるようになりました。
機能改善¶
- ヘルプトピックの回帰テストを追加し、トピック別のヘルプ表示(例:
owl help tool)とコマンド別のヘルプ表示(例:owl tool --help)が同じ情報を返すことを確認しました。 - README のツール表示コマンド例を調整し、
tool名前空間の使用例を追加しました。
互換性の調整¶
list、show、exec、schemaなどの既存トップレベルコマンドは引き続き主要な使用方法であり、互換性を維持して既存スクリプトを壊さないようにします。- すでに公開されていない一部のサンプルツールと Skill 設定をクリーンアップしました。
1.0.6(2026/04/28)¶
今回のリリースはイテレーションリリースであり、主な更新内容は次のとおりです。
新機能¶
owl updateコマンドを追加しました。インストーラーが記録した更新チャネルに基づいて、対応するプラットフォームのインストールスクリプトをダウンロードして実行できます。- Linux/macOS のインストールスクリプトに
--upgrade、Windows のインストールスクリプトに-Upgradeを追加し、リモートバージョンが更新されている場合にのみローカル CLI をアップグレードできるようにしました。 - インストーラーは設定に
update.base_urlとupdate.channelを書き込み、後続のowl updateに更新元を提供します。
不具合修正¶
- アップグレード時に既存のインストールパスを安定して特定できない問題を修正しました。アップグレードフローは Owl ディレクトリ内の
binpathを優先して読み取り、次にPATH内のowlにフォールバックします。 - ローカルバージョンがリモートバージョン以上の場合でも上書きインストールされる可能性がある問題を修正しました。現在はバイナリの置き換えをスキップし、更新チャネル設定のみを更新します。
機能改善¶
- インストーラーにセマンティックバージョンの比較ロジックを追加し、アップグレード前にローカルの
owl --versionとリモート channel のversionを読み取って比較します。 - 更新フローは Linux/macOS ではインストールスクリプトを同期的に実行し、Windows では独立した PowerShell プロセスでインストーラーを起動して、実行中のバイナリを置き換えるリスクを低減します。
1.0.5(2026/04/28)¶
今回のリリースは hotfix 修正であり、内容は次のとおりです。
不具合修正¶
- Linux/macOS インストーラーが macOS 標準の Bash 3.2 でチェックサム比較を実行すると
bad substitutionを報告する問題を修正しました。 - Bash 4 構文
${var,,}を POSIX ツールチェーンで使用可能なtr '[:upper:]' '[:lower:]'に置き換え、チェックサムの大文字小文字正規化ロジックが旧 Bash と互換性を持つようにしました。
機能改善¶
- 5 プラットフォームの CLI パッケージを再ビルドし、リリースディレクトリのバージョン、manifest のバージョン、パッケージ内の
owl --version出力を一致させました。 skill.mdとskill.en.mdの 2 つの Skill ドキュメントを保持し、中国語と英語の Agent Skill 配布を引き続きサポートします。
1.0.4(2026/04/27)¶
今回のリリースは installer channel リリースであり、主な更新内容は次のとおりです。
新機能¶
skill.en.mdをリリースし、英語の Agent Skill 説明ファイルを追加しました。- 一時コードによるインストールとカスタム Owl ディレクトリをサポートするインストーラーのサポートファイルを、
1.0.4channel ディレクトリにリリースしました。
不具合修正¶
- 前バージョンの本番 channel インストールスクリプトに
OWL_DIR/OwlDirのサポートが欠けている問題を修正しました。 - 既存の
1.0.3channel が同期キャッシュの影響を受けている場合に、同じバージョンのリリースを直接上書きするのを避け、新しい channel ディレクトリで修正後のインストールエントリポイントを提供するようにしました。
1.0.3(2026/04/27)¶
今回のリリースはイテレーションリリースであり、主な更新内容は次のとおりです。
新機能¶
- インストーラーに
OWL_TEMP_CODEのサポートを追加し、OWL_REGISTRY_ENDPOINTからai-apiアドレスを導出して、/api/v1/account/accesskey/exchangeで実際の token を交換できるようにしました。 skill.mdを追加し、Agent 統合シナリオ向けに channel とともに配布される Skill 説明を提供します。
不具合修正¶
bash -c "$(curl .../install.sh)"のエントリポイントでBASH_SOURCE[0]の読み取りが失敗する可能性がある問題を修正し、$0フォールバック付きのスクリプトエントリポイント解析に変更しました。- インライン installer helper で予期しない改行の書き方が発生する問題を修正し、リリース版
install.shを直接実行可能な自己完結型スクリプトに近づけました。
機能改善¶
- 一時コードで token を交換する際に、
OWL_TOKENと交換結果が一致するか検証し、一致しない場合はインストールを直ちに中止します。 OWL_TEMP_CODEリクエストはデフォルトでローカルプロキシをバイパスし、一時認証情報の交換がプロキシ設定の影響を受ける可能性を低減します。
1.0.2(2026/04/24)¶
今回のリリースはイテレーションリリースであり、主な更新内容は次のとおりです。
新機能¶
- CLI とインストーラーがカスタム Owl 作業ディレクトリをサポートしました。
OWL_DIR、--owl-dir、-OwlDirを追加しました。 - インストーラーが
OWL_OWNER/--owl-ownerをサポートし、cloud-init または root でのインストール後に設定ディレクトリをサービスユーザーに引き渡しやすくしました。 - インストール完了後、バイナリパスを Owl ディレクトリ内の
binpathに記録し、後続のアップグレードや Agent 実行時の特定に使用できるようにしました。
不具合修正¶
- インストーラーが
registry.endpointとauth.tokenを永続化する際に、常に現在のユーザーディレクトリに書き込む問題を修正しました。現在は指定された Owl ディレクトリに書き込みます。 - カスタムディレクトリのシナリオで
config showが表示するディレクトリが不正確になる問題を修正しました。
機能改善¶
- README に cloud-init / systemd のサービスユーザー向けインストール手順を追加し、
OWL_DIRとOWL_OWNERの推奨用法を明確にしました。 - インストールスクリプト内のアンインストール通知、設定ディレクトリの初期化、パス記録ロジックで、解析後の Owl ディレクトリを統一的に使用するようにしました。
1.0.1(2026/04/23)¶
今回のリリースは hotfix 修正であり、内容は次のとおりです。
新機能¶
- CLI に初回利用時の自動同期機能を追加しました。ローカルキャッシュが空の場合、またはキャッシュが
registry.sync_intervalを超えた場合に、list、show、exec、schema、categoryなどのコマンドが自動的にowl syncをトリガーします。 sync.auto設定項目を追加し、自動同期を無効にできるようにしました。
不具合修正¶
1.0.0の Linux/macOS tar パッケージ内でowlバイナリに実行権限が欠けている問題を修正しました。owl syncの増分同期時に、リモートで削除された category のキャッシュがクリーンアップされない問題を修正しました。HOMEがない一部の cloud-init / systemd / container 環境で、インストールスクリプトがset -uにより早期終了する可能性がある問題を修正しました。
機能改善¶
- 自動同期の失敗時に初回同期とキャッシュ更新を区別します。初回同期の失敗時はエラーを返し、既存キャッシュの更新失敗時は古いキャッシュを保持して warning を出力します。
- リリースディレクトリで
1.0.0と1.0.1channel の成果物を復元および追跡し、installer の回帰テストと CRLF/LF 監査を追加しました。
1.0.0(2026/04/13)¶
今回のリリースは初回リリースであり、主な更新内容は次のとおりです。
新機能¶
- Owl CLI の最初の channel バージョンをリリースし、Linux、macOS、Windows の合計 5 つのプラットフォームパッケージを提供しました。
install.sh、install.ps1、owl-install.ps1、SHA256SUMSを提供し、リモート channel インストール、バージョン指定インストール、ローカルパッケージインストール、チェックサム検証をサポートしました。- CLI は設定の初期化、ログインによる token の書き込み、ツールカタログの同期、カテゴリ表示、ツール表示、ツール実行、OpenAI function schema の出力、キャッシュ管理、データファイル管理をサポートします。
機能改善¶
- リリースディレクトリには README と USAGE ドキュメントが含まれ、テスト/本番チャネルのインストール、実行時設定、オフラインインストール、アンインストール、一般的なコマンドについて説明しています。
- ビルドパイプラインはマルチプラットフォームのクロスコンパイルをサポートし、
versionmanifest で現在のバージョン、過去のバージョン、リリース日時、commit、プラットフォーム一覧を記録します。
既知の問題¶
- Linux/macOS の tar パッケージ内で
owlバイナリの権限が0644であり、直接展開した後は実行できません。この問題は1.0.1で修正されています。