メインコンテンツへスキップ

​
概要

Refrain SDK は、TypeScript/JavaScript アプリケーションから手順書を実行するためのプログラマティックアクセスを提供します。process.env を一切読まず、全ての設定を明示的に受け取ります。

​
インストール

npm install @refrainai/sdk

​
クイックスタート

import { Refrain, loadRunbook } from "@refrainai/sdk";

// 1. クライアントを作成
const client = new Refrain({
  ai: {
    modelId: "claude-sonnet-4-6",
    provider: "anthropic",
    apiKey: "sk-ant-...",
  },
  headless: true,
});

// 2. 手順書を読み込み
const runbook = await loadRunbook("./runbooks/login-flow.yaml");

// 3. 実行
const report = await client.execute(runbook, {
  contextMarkdown: "# ログイン情報\n- ステージング環境の認証情報を使用",
  variables: { username: "[email protected]" },
  secrets: { password: "secret123" },
});

// 4. 結果を確認
console.log(`${report.succeeded}/${report.totalSteps} ステップ成功`);

// 5. クリーンアップ
await client.dispose();

​
主なエクスポート

エクスポート型説明
Refrainclassローカル実行用メインクライアント
loadRunbookfunction手順書 YAML ファイルの読み込みとパース

​
設計原則

  • process.env 不使用 — 全設定をコンストラクタとメソッド引数で明示的に渡す
  • 非対話型 — ユーザープロンプトなし。未解決の必須変数はエラー
  • プラン対応 — プランティアで利用できない機能はサイレントに無効化
  • 包括的な診断情報 — ステップ結果にリトライ回数、解決方法、失敗カテゴリを含む

​
次のステップ

ローカル実行

Refrain クラス、設定、実行オプション。

型リファレンス

全エクスポート型のカテゴリ別一覧。

使用例

よくあるユースケースの実践例。