@mawaru/sdk 0.29.0 → 0.30.0

package/_schemas/ai-manifest.test.ts

@@ -21,6 +21,21 @@ const valid = {
 }
 
 describe("aiManifestSchema", () => {
+  it("認証方式を保持し、不明な方式は拒否する", () => {
+    for (const auth_mode of ["subscription", "api"]) {
+      expect(
+        aiManifestSchema.parse({ ...valid, model: "gpt-6-astra", auth_mode })
+          .auth_mode,
+      ).toBe(auth_mode)
+    }
+    expect(() =>
+      aiManifestSchema.parse({ ...valid, auth_mode: "auto" }),
+    ).toThrow()
+    // 旧定義を編集できるよう読み込みは許可する。実行には明示選択が必要。
+    expect(
+      aiManifestSchema.parse({ ...valid, model: "gpt-6-astra" }).auth_mode,
+    ).toBeUndefined()
+  })
   it("フル指定の manifest を受け付ける", () => {
     const manifest = aiManifestSchema.parse(valid)
     expect(manifest.name).toBe("返信下書き")

package/_schemas/ai-manifest.ts

@@ -79,6 +79,8 @@ export const aiManifestSchema = z
     // repo に置く時点で完成品なので必須（DB 時代の「書きかけ空文字」は廃止）
     prompt: z.string().min(1),
     model: aiModelSchema.default(DEFAULT_AI_MODEL),
+    // 旧定義も編集のため読める。Codex の実行・保存時には明示選択を必須にする
+    auth_mode: z.enum(["subscription", "api"]).optional(),
     // 同 repo のトップレベル skills/ 配下のディレクトリ名
     skills: z
       .array(

package/dist/_schemas/ai-manifest.d.ts

@@ -56,6 +56,10 @@ export declare const aiManifestSchema: z.ZodObject<{
         "gpt-5.6-luna": "gpt-5.6-luna";
         "gpt-5.5": "gpt-5.5";
     }>>;
+    auth_mode: z.ZodOptional<z.ZodEnum<{
+        subscription: "subscription";
+        api: "api";
+    }>>;
     skills: z.ZodDefault<z.ZodArray<z.ZodString>>;
     env: z.ZodDefault<z.ZodArray<z.ZodString>>;
     verbose: z.ZodOptional<z.ZodBoolean>;

package/dist/_schemas/ai-manifest.js

@@ -69,6 +69,8 @@ export const aiManifestSchema = z
     // repo に置く時点で完成品なので必須（DB 時代の「書きかけ空文字」は廃止）
     prompt: z.string().min(1),
     model: aiModelSchema.default(DEFAULT_AI_MODEL),
+    // 旧定義も編集のため読める。Codex の実行・保存時には明示選択を必須にする
+    auth_mode: z.enum(["subscription", "api"]).optional(),
     // 同 repo のトップレベル skills/ 配下のディレクトリ名
     skills: z
         .array(z

package/docs/development.md

@@ -48,7 +48,7 @@ skills/<dir>/      # AI ノードが参照する skill（SKILL.md）
   `skills`（トップレベル `skills/` 配下のディレクトリ名）・`env`・`inputs` / `outputs`
 - `model` が実行主体を決める：`claude-*` は Claude Code、`gpt-*` は Codex で走る
   （選択肢は `AI_MODEL_GROUPS`）。認証は repo の Actions secrets に置く：Claude Code は
-  `ANTHROPIC_API_KEY`（または `CLAUDE_CODE_OAUTH_TOKEN`）、Codex は `OPENAI_API_KEY`
+  `ANTHROPIC_API_KEY`（または `CLAUDE_CODE_OAUTH_TOKEN`）、Codex は明示的な `auth_mode` と対応する認証情報（下記「Codex の認証方式」参照）
   （`env` に宣言しなくても渡される）
 - `inputs` は1件以上・key 自由。値は `{ "schema": <JSON Schema>, "resume": true }` の形
   （`resume` は省略可。true の口から入力が届いた実行は、同じノードの直近セッションを
@@ -76,3 +76,55 @@ skills/<dir>/      # AI ノードが参照する skill（SKILL.md）
 
 - `npx mawaru validate` — リポジトリ規約の検証（CI 向け。error で exit 1）
 - config.json を変えたら `npx mawaru typegen` で型を更新し、ズレをコンパイルで検出する
+
+### Codex の認証方式
+
+Codex の AI 定義は `auth_mode` を必ず指定する。エディタの「認証方式」で選択できる。
+
+- `subscription`：ChatGPT の Codex 利用枠を使う。
+- `api`：OpenAI の API キーで従量課金する。
+
+既存の Codex 定義にも明示的な選択が必要。未指定・認証不足・枠切れ・認証エラーでも別方式へ切り替えない。Claude の認証設定は従来どおり。
+
+```json
+{
+  "prompt": "入力に返信してください",
+  "model": "gpt-5.6-luna",
+  "auth_mode": "subscription",
+  "inputs": { "in": { "schema": {} } },
+  "outputs": { "main": { "type": "string" } }
+}
+```
+
+API を選ぶ場合は実行 repo の Actions Secret に `OPENAI_API_KEY` または `CODEX_API_KEY` を登録する。両方ある場合は Codex 固有の `CODEX_API_KEY` を使う。
+
+#### サブスクを Actions で使う
+
+非公開の実行 repo で、更新した `mawaru-runner.yml` を `npx @mawaru/sdk init` で反映する。
+
+1. 自動実行専用の Codex ログインをファイル形式で作る。日常利用のログインキャッシュを複数の repo・マシンへ配布しない。
+2. GitHub の実行 repo に `mawaru-codex` Environment を作成する。
+3. **Environment Secret** に `CODEX_AUTH_JSON`（ログインキャッシュの内容）と `CODEX_AUTH_WRITE_TOKEN`（その repo の Environment Secrets を更新できるトークン）を登録する。標準の `GITHUB_TOKEN` には Secret 更新権限がない。Fine-grained PAT では対象 repo を限定し、Environments の書き込み権限を付ける。
+4. AI 定義で `auth_mode: "subscription"` を選ぶ。
+
+認証ファイルを表示せず登録する例（`OWNER/REPO` は実行 repo に置き換える）：
+
+```sh
+# CODEX_HOME を普段のログインと分けて、初回ログインする
+CODEX_HOME="$HOME/.mawaru-codex" codex -c 'cli_auth_credentials_store="file"' login
+# 値をコマンド引数・履歴・チャットへ貼り付けない
+gh secret set CODEX_AUTH_JSON --repo OWNER/REPO --env mawaru-codex < "$HOME/.mawaru-codex/auth.json"
+gh secret set CODEX_AUTH_WRITE_TOKEN --repo OWNER/REPO --env mawaru-codex
+```
+
+runner は認証を作業ディレクトリ外に展開し、Codex が更新した認証を実行の成否にかかわらず Environment Secret へ戻す。同じ repo の AI ジョブは直列に実行する。GitHub の待機キューは最大100件で、それを超える投入は避ける。repo Secret はキュー投入時の古い値を読むため、サブスク認証の保存先には使わない。実行中の強制キャンセル・書き戻し失敗・ログイン失効時は、新しくログインして `CODEX_AUTH_JSON` を再登録する。
+
+API 選択時はサブスク認証を読み込まず、サブスク選択時は API キーを Codex に渡さない。サブスク認証は利用枠無制限を意味しない。追加購入済みクレジットの消費は ChatGPT アカウント側の設定に従う。
+
+#### ローカルで使う
+
+`auth_mode: "subscription"` を設定したうえで、`CODEX_AUTH_FILE` に自動実行用の auth.json の絶対パスを指定して runner を実行する。更新済み認証は同じファイルへ戻すため、親ディレクトリにも書き込み権限が必要。同じファイルを使う mawaru の並行実行はエラーで止める。
+
+API 選択時は `OPENAI_API_KEY` / `CODEX_API_KEY` を runner の環境変数、または既存の `SECRETS_JSON` 経由で渡す。
+
+参考：[Codexの認証](https://learn.chatgpt.com/docs/auth)、[CIでの認証維持](https://learn.chatgpt.com/docs/auth/ci-cd-auth)、[GitHubのSecret読み込み時点](https://docs.github.com/en/actions/reference/security/secrets)、[待機キューの上限](https://docs.github.com/en/actions/how-tos/write-workflows/choose-when-workflows-run/control-workflow-concurrency)。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mawaru/sdk",
-  "version": "0.29.0",
+  "version": "0.30.0",
   "description": "mawaru 実行 repo の開発 SDK。契約スキーマ（config.json 規約・ループ graph API）の正 ＋ typegen / validate CLI",
   "type": "module",
   "bin": {

package/templates/mawaru-runner.yml

@@ -20,6 +20,15 @@ on:
 jobs:
   run:
     runs-on: ubuntu-latest
+    # 認証の更新を次のジョブ開始時に読むため、repo Secret ではなく環境Secretを使う。
+    environment:
+      name: mawaru-codex
+      deployment: false
+    # 同じ repo の AI ジョブを直列化。通常の concurrency は待機中ジョブを置換するため max。
+    concurrency:
+      group: ${{ github.event.client_payload.agent && 'mawaru-ai-auth' || github.run_id }}
+      cancel-in-progress: false
+      queue: max
     steps:
       # 自分の Actions run の URL を mawaru に自己申告する（画面のリンク表示用）。
       # repository_dispatch は起動した run の ID を返さないため、URL を知っているのは
@@ -55,7 +64,10 @@ jobs:
       # backstop は GHA のジョブ上限（6時間）に任せる。step の停止は mawaru の run キャンセル
       - name: run
         id: run
-        env: { SECRETS_JSON: "${{ toJSON(secrets) }}" }
+        env:
+          SECRETS_JSON: "${{ toJSON(secrets) }}"
+          MAWARU_CODEX_AUTH_STORAGE: github-environment
+          MAWARU_CODEX_PRIVATE_REPO: "${{ github.event.repository.private }}"
         run: npx --yes "${{ github.event.client_payload.runner }}" payload.json
 
       # ラッパー自体が起動できなかった事故（npx 失敗等）の backstop。