arkor build / start

Studio なしでトレーナーをバンドルして実行する。

​

arkor build と arkor start

arkor build と arkor start は Studio の Run training ボタンのヘッドレス相当です。UI を起動せずにトレーナーを動かしたいとき（CI、サーバー、別スクリプトから）に使ってください。

Studio の Run training は内部的に arkor start（エントリー引数なし）をスポーンするので、両フローでランタイムパスは同一です。

​

arkor build

pnpm

pnpm build

src/arkor/index.ts を esbuild で .arkor/build/index.mjs にバンドルします。

​

概要

arkor build [entry]

​

引数

引数	デフォルト	説明
entry	src/arkor/index.ts	バンドルするソースエントリー。相対パスでも絶対パスでも動きます。

​

出力

.arkor/build/index.mjs（outDir のデフォルトは .arkor/build）。出力は単一の ESM ファイル、Node 22.6 をターゲットにし、packages: "external" で bare specifier（arkor、node_modules 内のもの）はバンドルせず、成果物はあなたの node_modules からランタイム SDK を解決します。インライン化されるのは相対 import のみです。

エントリーが存在しない場合、arkor build は src/arkor/index.ts を作るか明示的なエントリーを渡すよう促すメッセージで例外が発生します。

​

arkor start

pnpm

pnpm start

.arkor/build/index.mjs を実行します。ランナーはバンドルを import し、登録済みトレーナーを見つけ（export const arkor を最優先、次に export const trainer、最後にデフォルトエクスポート）、trainer.start() の後に trainer.wait() を呼びます。

​

概要

arkor start [entry]

​

引数

引数	デフォルト	説明
entry	なし	渡されたとき、arkor start は実行 前 にこのエントリーでプロジェクトをリビルドします。省略時は既存ビルド成果物を再利用し、無ければデフォルトエントリーで自動ビルドしてから走ります。

無ければ自動ビルドする挙動は、Studio の “Run training” が 2 回 spawn を連鎖させずに済むためのものです。スクリプトからは通常、arkor build と arkor start を明示的に呼んで、ビルド失敗が走り出す前に表に出るようにしたいはずです。

​

振る舞いまとめ

状況	arkor start の挙動
entry 引数あり	与えられたエントリーでリビルドして実行。
成果物なし、entry なし	デフォルトエントリーで自動ビルドして実行。
成果物あり、entry なし	成果物を再利用してそのまま実行。

「成果物の再利用」のパスがあるおかげで、Studio はトレーナーの編集を train エンドポイントではなく /api/manifest のリビルド経由で表に出せます。CLI 中心のワークフローでは、src/arkor/ を編集したら毎回 arkor build を走らせてください。

​

よくあるエラー

arkor build:

メッセージ	意味	対処
Build entry not found: <abs-path>. Create src/arkor/index.ts or pass an explicit entry argument.（ビルドエントリーが見つかりません: <abs-path>。src/arkor/index.ts を作成するか、明示的なエントリー引数を渡してください）	デフォルトエントリーが存在せず明示的なエントリーも渡されなかった。	プロジェクトルート（src/arkor/index.ts を含むディレクトリー）から実行するか、エントリーを渡す。例: arkor build path/to/entry.ts。

arkor start:

メッセージ	意味	対処
Build entry not found: <abs-path>. Create src/arkor/index.ts or pass an explicit entry argument.（ビルドエントリーが見つかりません: <abs-path>。src/arkor/index.ts を作成するか、明示的なエントリー引数を渡してください）	arkor start はエントリー引数を渡したとき、または .arkor/build/index.mjs が無いとき先に arkor build を走らせます。不正なエントリーパスはランナー段階ではなくここで表に出ます。	存在するエントリーを渡すか、省略してデフォルトの src/arkor/index.ts に任せる。
Training entry must export 'arkor' (from createArkor({...})) or 'trainer' (from createTrainer({...})), or default-export one of them.（学習エントリーは createArkor({...}) の arkor か createTrainer({...}) の trainer をエクスポートするか、いずれかをデフォルトエクスポートする必要があります）	バンドルの import は成功したが、サポートしているエクスポート形をどれも露出していない。	受け付ける 3 つの形（名前付き arkor、名前付き trainer、デフォルト）は プロジェクト構成 § src/arkor/ を参照。

runTrainer（プログラム）:

メッセージ	意味	対処
Training entry not found: <abs-path>. Provide a path or create src/arkor/index.ts.（学習エントリーが見つかりません: <abs-path>。パスを指定するか src/arkor/index.ts を作成してください）	ランナーを直接呼んだとき（例: import { runTrainer } from "arkor"）に存在しないパスを渡した場合に表に出ます。CLI はこのパスに当たりません。arkor start ならビルド段階で先に失敗します。	存在するパスを渡すか、import "./src/arkor/index.ts" を先にしてモジュールロード時に検知。

​

例

ビルドして開始（2 ステップ）:

pnpm

pnpm build
pnpm start

別エントリーでリビルドを強制（1 ステップ）:

pnpm

pnpm start src/arkor/experiment.ts

トレーナー編集後、古い成果物をリビルド:

pnpm

# src/arkor/trainer.ts を編集した後:
pnpm build && pnpm start