@mawaru/sdk 0.32.0 → 0.34.0

package/_schemas/ai-manifest.test.ts

@@ -1,6 +1,8 @@
 import { describe, expect, it } from "vitest"
+import { MODEL_SERIES } from "../../agent-runner/_agents/models.js"
 import {
   AI_MODEL_GROUPS,
+  AI_MODEL_SERIES,
   AI_MODELS,
   agentOfModel,
   aiManifestSchema,
@@ -52,12 +54,12 @@ describe("aiManifestSchema", () => {
       outputs: { main: textOutput },
     })
     expect(manifest.name).toBeUndefined()
-    expect(manifest.model).toBe("claude-opus-5")
+    expect(manifest.model).toBe("claude-opus")
     expect(manifest.skills).toEqual([])
     expect(manifest.env).toEqual([])
   })
 
-  it("model は AI_MODELS の enum（バージョン固定。外の値は拒否）", () => {
+  it("model は AI_MODELS の enum（系列か固定 ID。外の値は拒否）", () => {
     for (const model of AI_MODELS) {
       expect(aiManifestSchema.parse({ ...valid, model }).model).toBe(model)
     }
@@ -80,19 +82,36 @@ describe("aiManifestSchema", () => {
     expect(
       aiManifestSchema.parse({ ...valid, model: "gpt-6-astra" }).model,
     ).toBe("gpt-6-astra")
-    for (const model of AI_MODEL_GROUPS.claude.models) {
+    const { claude, codex } = AI_MODEL_GROUPS
+    for (const model of [...claude.series, ...claude.models]) {
       expect(agentOfModel(model)).toBe("claude")
     }
-    for (const model of AI_MODEL_GROUPS.codex.models) {
+    for (const model of [...codex.series, ...codex.models]) {
       expect(agentOfModel(model)).toBe("codex")
     }
-    // 各グループの既定はそのグループの選択肢に含まれる
-    expect(AI_MODEL_GROUPS.claude.models).toContain(
-      AI_MODEL_GROUPS.claude.default,
-    )
-    expect(AI_MODEL_GROUPS.codex.models).toContain(
-      AI_MODEL_GROUPS.codex.default,
+    // 各グループの既定はそのグループの系列（最新追従）
+    expect(claude.series).toContain(claude.default)
+    expect(codex.series).toContain(codex.default)
+  })
+
+  it("系列（最新追従）を選べる。既定は claude-opus", () => {
+    for (const model of ["claude-opus", "gpt-sol"]) {
+      expect(aiManifestSchema.parse({ ...valid, model }).model).toBe(model)
+    }
+    expect(AI_MODEL_GROUPS.claude.default).toBe("claude-opus")
+  })
+
+  it("系列の一覧は runner の対応表と一致し、読み替え先は同じグループの固定 ID", () => {
+    // runner は npm 公開パッケージで sdk に依存できず、系列名は二重管理になる。
+    // どちらかに足し忘れたらここで落ちる
+    expect(Object.keys(MODEL_SERIES).sort()).toEqual(
+      [...AI_MODEL_SERIES].sort(),
     )
+    for (const group of Object.values(AI_MODEL_GROUPS)) {
+      for (const series of group.series) {
+        expect(group.models).toContain(MODEL_SERIES[series])
+      }
+    }
   })
 
   it("inputs は key 自由・1件以上（in / instruction の固定構成は廃止）", () => {

package/_schemas/ai-manifest.ts

@@ -6,12 +6,19 @@ import { jsonSchemaSchema, PORT_KEY_PATTERN } from "./node.js"
 // config.json に agent のようなフィールドは持たず、model の接頭辞（claude-* / gpt-*）で決まる
 // （runner の _agents/index.ts と同じ規則。AI実行エージェントの抽象化（Claude CodeとCodex）.md）。
 //
-// モデルはエイリアス（"opus" 等）を採らずバージョンを固定する：実行のたびに黙って別モデルへ
-// 乗り換わると品質も費用も再現しないため。新モデルが出たらこの配列を足して SDK を publish する。
-// 既定は Opus：下書き品質が価値の中心。費用はユーザー持ち
+// model に書けるのは「系列」か「固定 ID」のどちらか
+// （docs/tasks: AIノードのモデルを常に最新にする（系列指定）.md）。
+// - series＝系列（claude-opus 等）。その系列の最新モデルで走る。どの実 ID に当たるかは
+//   runner の対応表（agent-runner の _agents/models.ts）が実行時に決めるので、新モデルが
+//   出たら対応表を直すだけで全ノードが追従する（各 repo の config.json は触らない）。
+//   系列名の一覧はここと runner の二重管理（ai-manifest.test.ts が一致を検証する）
+// - models＝固定 ID。そのバージョンで走り続ける（新モデルで崩れたノードを戻す手段）
+// 系列をまたいでは上がらない（費用はユーザー持ち。Opus 指定が Fable になることは無い）。
+// 既定は Opus の系列：下書き品質が価値の中心
 export const AI_MODEL_GROUPS = {
   claude: {
     name: "Claude Code",
+    series: ["claude-fable", "claude-opus", "claude-sonnet", "claude-haiku"],
     models: [
       "claude-fable-5-1",
       "claude-fable-5",
@@ -20,25 +27,34 @@ export const AI_MODEL_GROUPS = {
       "claude-sonnet-5",
       "claude-haiku-4-5",
     ],
-    default: "claude-opus-5",
+    default: "claude-opus",
   },
+  // astra＝最上位 / sol＝主力 / luna＝軽量。terra は GPT-5.6 世代にしか無いので系列にしない
   codex: {
     name: "Codex",
+    series: ["gpt-astra", "gpt-sol", "gpt-luna"],
     models: [
+      "gpt-6.1-sol",
       "gpt-6-astra",
+      "gpt-6-sol",
+      "gpt-6-luna",
       "gpt-5.6-sol",
       "gpt-5.6-terra",
       "gpt-5.6-luna",
-      "gpt-5.5",
     ],
-    default: "gpt-6-astra",
+    default: "gpt-astra",
   },
 } as const
 export const AI_AGENT_IDS = ["claude", "codex"] as const
 export const aiAgentIdSchema = z.enum(AI_AGENT_IDS)
 export type AiAgentId = z.infer<typeof aiAgentIdSchema>
 
+export const AI_MODEL_SERIES = [
+  ...AI_MODEL_GROUPS.claude.series,
+  ...AI_MODEL_GROUPS.codex.series,
+] as const
 export const AI_MODELS = [
+  ...AI_MODEL_SERIES,
   ...AI_MODEL_GROUPS.claude.models,
   ...AI_MODEL_GROUPS.codex.models,
 ] as const

package/_schemas/graph.test.ts

@@ -908,6 +908,16 @@ describe("saveGraphBodySchema（refs：ループ変数の定義スキーマ）",
     ).toThrow(/required/)
   })
 
+  it("properties に予約キー input（run の起動入力）は置けない", () => {
+    expect(() =>
+      saveGraphBodySchema.parse({
+        nodes: [makeNode()],
+        connections: [],
+        refs: { type: "object", properties: { input: { type: "string" } } },
+      }),
+    ).toThrow(/input/)
+  })
+
   it("object 以外の type・旧「値の袋」形は拒否する", () => {
     for (const refs of [
       { type: "string" },

package/_schemas/graph.ts

@@ -20,6 +20,12 @@ import {
 export const refsBagSchema = z.record(portKeySchema, z.unknown())
 export type RefsBag = z.infer<typeof refsBagSchema>
 
+// 予約キー：run の起動入力（runs.start_payload）。Run.start が袋に写し、全 step
+// （Program の refs.json・AI のプロンプト・承認ビューの ctx）から読める。
+// ループ定義には置けず、起動指定・end のパッチでも書けない
+// （起動入力をrefsに入れて全ノードから参照できるようにする.md）
+export const REFS_INPUT_KEY = "input"
+
 // ループ変数の定義＝袋全体を表す 1 つの object JSON Schema
 // （ループ変数（refs）のJSON Schema化.md）。properties のキーが変数名、
 // default が静的なデフォルト値、required は「run 起動時に値が確定して
@@ -31,6 +37,13 @@ export const loopRefsSchema = z
     required: z.array(portKeySchema).optional(),
   })
   .superRefine((refs, ctx) => {
+    if (REFS_INPUT_KEY in refs.properties) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["properties", REFS_INPUT_KEY],
+        message: `properties のキー ${REFS_INPUT_KEY} は予約キー（run の起動入力）です`,
+      })
+    }
     for (const key of refs.required ?? []) {
       if (!(key in refs.properties)) {
         ctx.addIssue({

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

@@ -2,13 +2,15 @@ import { z } from "zod";
 export declare const AI_MODEL_GROUPS: {
     readonly claude: {
         readonly name: "Claude Code";
+        readonly series: readonly ["claude-fable", "claude-opus", "claude-sonnet", "claude-haiku"];
         readonly models: readonly ["claude-fable-5-1", "claude-fable-5", "claude-opus-5", "claude-opus-4-8", "claude-sonnet-5", "claude-haiku-4-5"];
-        readonly default: "claude-opus-5";
+        readonly default: "claude-opus";
     };
     readonly codex: {
         readonly name: "Codex";
-        readonly models: readonly ["gpt-6-astra", "gpt-5.6-sol", "gpt-5.6-terra", "gpt-5.6-luna", "gpt-5.5"];
-        readonly default: "gpt-6-astra";
+        readonly series: readonly ["gpt-astra", "gpt-sol", "gpt-luna"];
+        readonly models: readonly ["gpt-6.1-sol", "gpt-6-astra", "gpt-6-sol", "gpt-6-luna", "gpt-5.6-sol", "gpt-5.6-terra", "gpt-5.6-luna"];
+        readonly default: "gpt-astra";
     };
 };
 export declare const AI_AGENT_IDS: readonly ["claude", "codex"];
@@ -17,22 +19,32 @@ export declare const aiAgentIdSchema: z.ZodEnum<{
     codex: "codex";
 }>;
 export type AiAgentId = z.infer<typeof aiAgentIdSchema>;
-export declare const AI_MODELS: readonly ["claude-fable-5-1", "claude-fable-5", "claude-opus-5", "claude-opus-4-8", "claude-sonnet-5", "claude-haiku-4-5", "gpt-6-astra", "gpt-5.6-sol", "gpt-5.6-terra", "gpt-5.6-luna", "gpt-5.5"];
+export declare const AI_MODEL_SERIES: readonly ["claude-fable", "claude-opus", "claude-sonnet", "claude-haiku", "gpt-astra", "gpt-sol", "gpt-luna"];
+export declare const AI_MODELS: readonly ["claude-fable", "claude-opus", "claude-sonnet", "claude-haiku", "gpt-astra", "gpt-sol", "gpt-luna", "claude-fable-5-1", "claude-fable-5", "claude-opus-5", "claude-opus-4-8", "claude-sonnet-5", "claude-haiku-4-5", "gpt-6.1-sol", "gpt-6-astra", "gpt-6-sol", "gpt-6-luna", "gpt-5.6-sol", "gpt-5.6-terra", "gpt-5.6-luna"];
 export declare const aiModelSchema: z.ZodEnum<{
+    "claude-fable": "claude-fable";
+    "claude-opus": "claude-opus";
+    "claude-sonnet": "claude-sonnet";
+    "claude-haiku": "claude-haiku";
     "claude-fable-5-1": "claude-fable-5-1";
     "claude-fable-5": "claude-fable-5";
     "claude-opus-5": "claude-opus-5";
     "claude-opus-4-8": "claude-opus-4-8";
     "claude-sonnet-5": "claude-sonnet-5";
     "claude-haiku-4-5": "claude-haiku-4-5";
+    "gpt-astra": "gpt-astra";
+    "gpt-sol": "gpt-sol";
+    "gpt-luna": "gpt-luna";
+    "gpt-6.1-sol": "gpt-6.1-sol";
     "gpt-6-astra": "gpt-6-astra";
+    "gpt-6-sol": "gpt-6-sol";
+    "gpt-6-luna": "gpt-6-luna";
     "gpt-5.6-sol": "gpt-5.6-sol";
     "gpt-5.6-terra": "gpt-5.6-terra";
     "gpt-5.6-luna": "gpt-5.6-luna";
-    "gpt-5.5": "gpt-5.5";
 }>;
 export type AiModel = z.infer<typeof aiModelSchema>;
-export declare const DEFAULT_AI_MODEL: "claude-opus-5";
+export declare const DEFAULT_AI_MODEL: "claude-opus";
 export declare const agentOfModel: (model: AiModel) => AiAgentId;
 export declare const aiInputDeclSchema: z.ZodObject<{
     schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
@@ -44,17 +56,26 @@ export declare const aiManifestSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     prompt: z.ZodString;
     model: z.ZodDefault<z.ZodEnum<{
+        "claude-fable": "claude-fable";
+        "claude-opus": "claude-opus";
+        "claude-sonnet": "claude-sonnet";
+        "claude-haiku": "claude-haiku";
         "claude-fable-5-1": "claude-fable-5-1";
         "claude-fable-5": "claude-fable-5";
         "claude-opus-5": "claude-opus-5";
         "claude-opus-4-8": "claude-opus-4-8";
         "claude-sonnet-5": "claude-sonnet-5";
         "claude-haiku-4-5": "claude-haiku-4-5";
+        "gpt-astra": "gpt-astra";
+        "gpt-sol": "gpt-sol";
+        "gpt-luna": "gpt-luna";
+        "gpt-6.1-sol": "gpt-6.1-sol";
         "gpt-6-astra": "gpt-6-astra";
+        "gpt-6-sol": "gpt-6-sol";
+        "gpt-6-luna": "gpt-6-luna";
         "gpt-5.6-sol": "gpt-5.6-sol";
         "gpt-5.6-terra": "gpt-5.6-terra";
         "gpt-5.6-luna": "gpt-5.6-luna";
-        "gpt-5.5": "gpt-5.5";
     }>>;
     auth_mode: z.ZodOptional<z.ZodEnum<{
         subscription: "subscription";

package/dist/_schemas/ai-manifest.js

@@ -5,12 +5,19 @@ import { jsonSchemaSchema, PORT_KEY_PATTERN } from "./node.js";
 // config.json に agent のようなフィールドは持たず、model の接頭辞（claude-* / gpt-*）で決まる
 // （runner の _agents/index.ts と同じ規則。AI実行エージェントの抽象化（Claude CodeとCodex）.md）。
 //
-// モデルはエイリアス（"opus" 等）を採らずバージョンを固定する：実行のたびに黙って別モデルへ
-// 乗り換わると品質も費用も再現しないため。新モデルが出たらこの配列を足して SDK を publish する。
-// 既定は Opus：下書き品質が価値の中心。費用はユーザー持ち
+// model に書けるのは「系列」か「固定 ID」のどちらか
+// （docs/tasks: AIノードのモデルを常に最新にする（系列指定）.md）。
+// - series＝系列（claude-opus 等）。その系列の最新モデルで走る。どの実 ID に当たるかは
+//   runner の対応表（agent-runner の _agents/models.ts）が実行時に決めるので、新モデルが
+//   出たら対応表を直すだけで全ノードが追従する（各 repo の config.json は触らない）。
+//   系列名の一覧はここと runner の二重管理（ai-manifest.test.ts が一致を検証する）
+// - models＝固定 ID。そのバージョンで走り続ける（新モデルで崩れたノードを戻す手段）
+// 系列をまたいでは上がらない（費用はユーザー持ち。Opus 指定が Fable になることは無い）。
+// 既定は Opus の系列：下書き品質が価値の中心
 export const AI_MODEL_GROUPS = {
     claude: {
         name: "Claude Code",
+        series: ["claude-fable", "claude-opus", "claude-sonnet", "claude-haiku"],
         models: [
             "claude-fable-5-1",
             "claude-fable-5",
@@ -19,23 +26,32 @@ export const AI_MODEL_GROUPS = {
             "claude-sonnet-5",
             "claude-haiku-4-5",
         ],
-        default: "claude-opus-5",
+        default: "claude-opus",
     },
+    // astra＝最上位 / sol＝主力 / luna＝軽量。terra は GPT-5.6 世代にしか無いので系列にしない
     codex: {
         name: "Codex",
+        series: ["gpt-astra", "gpt-sol", "gpt-luna"],
         models: [
+            "gpt-6.1-sol",
             "gpt-6-astra",
+            "gpt-6-sol",
+            "gpt-6-luna",
             "gpt-5.6-sol",
             "gpt-5.6-terra",
             "gpt-5.6-luna",
-            "gpt-5.5",
         ],
-        default: "gpt-6-astra",
+        default: "gpt-astra",
     },
 };
 export const AI_AGENT_IDS = ["claude", "codex"];
 export const aiAgentIdSchema = z.enum(AI_AGENT_IDS);
+export const AI_MODEL_SERIES = [
+    ...AI_MODEL_GROUPS.claude.series,
+    ...AI_MODEL_GROUPS.codex.series,
+];
 export const AI_MODELS = [
+    ...AI_MODEL_SERIES,
     ...AI_MODEL_GROUPS.claude.models,
     ...AI_MODEL_GROUPS.codex.models,
 ];

package/dist/_schemas/graph.d.ts

@@ -1,6 +1,7 @@
 import { z } from "zod";
 export declare const refsBagSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 export type RefsBag = z.infer<typeof refsBagSchema>;
+export declare const REFS_INPUT_KEY = "input";
 export declare const loopRefsSchema: z.ZodObject<{
     type: z.ZodLiteral<"object">;
     properties: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;

package/dist/_schemas/graph.js

@@ -6,6 +6,11 @@ import { hasInboundConflict, isSchemaSubset, kindPortsViolation, resolvePortSche
 // key はポート key と同じ規則（^[a-z][a-z0-9_]*$）。実行系ボディ
 // （run 起動の上書き・step end のパッチ）が使う契約
 export const refsBagSchema = z.record(portKeySchema, z.unknown());
+// 予約キー：run の起動入力（runs.start_payload）。Run.start が袋に写し、全 step
+// （Program の refs.json・AI のプロンプト・承認ビューの ctx）から読める。
+// ループ定義には置けず、起動指定・end のパッチでも書けない
+// （起動入力をrefsに入れて全ノードから参照できるようにする.md）
+export const REFS_INPUT_KEY = "input";
 // ループ変数の定義＝袋全体を表す 1 つの object JSON Schema
 // （ループ変数（refs）のJSON Schema化.md）。properties のキーが変数名、
 // default が静的なデフォルト値、required は「run 起動時に値が確定して
@@ -17,6 +22,13 @@ export const loopRefsSchema = z
     required: z.array(portKeySchema).optional(),
 })
     .superRefine((refs, ctx) => {
+    if (REFS_INPUT_KEY in refs.properties) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["properties", REFS_INPUT_KEY],
+            message: `properties のキー ${REFS_INPUT_KEY} は予約キー（run の起動入力）です`,
+        });
+    }
     for (const key of refs.required ?? []) {
         if (!(key in refs.properties)) {
             ctx.addIssue({

package/dist/typegen.js

@@ -1,6 +1,7 @@
 import { createHash } from "node:crypto";
 import { existsSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
+import { REFS_INPUT_KEY } from "./_schemas/graph.js";
 import { programManifestSchema, } from "./_schemas/program-manifest.js";
 // 生成ファイルに刻む config.json 内容のハッシュ。validate が drift（config を変えて
 // typegen し忘れ）の検出に使う
@@ -139,8 +140,12 @@ export const renderTypesFile = (manifest, rawConfig) => {
     const inputSchema = manifest.inputs.in ?? {};
     const outputEntries = Object.entries(manifest.outputs).map(([key, schema]) => `  ${propertyKey(key)}: ${tsTypeFromJsonSchema(schema, 1)}`);
     // refs＝ループ変数の袋（実行時に refs.json で渡される）。config の refs はループ定義
-    // からの転写（キー→推定型）なので、宣言が無ければ型も出さない
-    const refEntries = Object.entries(manifest.refs).map(([key, schema]) => `  ${propertyKey(key)}: ${tsTypeFromJsonSchema(schema, 1)}`);
+    // からの転写（キー→推定型）。予約キー input（run の起動入力）は定義に現れないが
+    // 必ず袋に載るので、宣言が無くても Refs / Ctx を出す
+    const refEntries = [
+        `  ${propertyKey(REFS_INPUT_KEY)}: unknown`,
+        ...Object.entries(manifest.refs).map(([key, schema]) => `  ${propertyKey(key)}: ${tsTypeFromJsonSchema(schema, 1)}`),
+    ];
     return [
         "// このファイルは mawaru typegen が config.json から自動生成した（手で編集しない）",
         `${CONFIG_HASH_PREFIX}${configHash(rawConfig)}`,
@@ -152,16 +157,13 @@ export const renderTypesFile = (manifest, rawConfig) => {
         "// run の戻り値：ちょうど1つの出口ポートのキーで返す { <出口キー>: 値 }",
         outputUnionType(Object.keys(manifest.outputs)),
         "",
-        ...(refEntries.length > 0
-            ? [
-                `export type Refs = {\n${refEntries.join("\n")}\n}`,
-                "",
-                "// run の第2引数：refs＝届いた袋の読み、setRefs＝袋へのパッチの宣言",
-                "// （書いたキーだけが完了時に袋へマージされ、下流のノードから読める）",
-                "export type Ctx = { refs: Refs; setRefs: (patch: Partial<Refs>) => void }",
-                "",
-            ]
-            : []),
+        `export type Refs = {\n${refEntries.join("\n")}\n}`,
+        "",
+        "// run の第2引数：refs＝届いた袋の読み、setRefs＝袋へのパッチの宣言",
+        "// （書いたキーだけが完了時に袋へマージされ、下流のノードから読める。",
+        "// input は run の起動入力＝読み専用）",
+        "export type Ctx = { refs: Refs; setRefs: (patch: Partial<Refs>) => void }",
+        "",
     ].join("\n");
 };
 // nodes/program/ 直下の各 dir の config.json から types.d.ts を生成する

package/docs/development.md

@@ -30,7 +30,9 @@ skills/<dir>/      # AI ノードが参照する skill（SKILL.md）
   - `{ <出口ポートのkey>: <データ> }` の**単一キーのオブジェクト**（どの出口から出るかを戻り値自身が運ぶ）
   - `"pending"` — 完了保留（外部イベントで後から end が届く）
 - `ctx` — ループ変数の袋の読み書き：
-  - `ctx.refs` — 届いた袋（loop に定義された変数の、この step 開始時点の値）
+  - `ctx.refs` — 届いた袋（loop に定義された変数の、この step 開始時点の値）。
+    予約キー `ctx.refs.input` は **run の起動入力**（開始ノードに渡された値。コンポーネントの
+    中ならコンポーネントの入力）。読み専用で、loop の定義には置けず `setRefs` でも書けない
   - `ctx.setRefs({ key: value })` — 袋へのパッチの宣言。**完了時にだけ**反映され、以降の
     ノードが `ctx.refs` で読める（動的な値を下流へ渡す唯一の経路）。何度呼んでもトップレベル
     キー後勝ちで畳まれる。`"pending"` を返す実行では反映されない。loop に定義の無いキーを
@@ -47,7 +49,9 @@ skills/<dir>/      # AI ノードが参照する skill（SKILL.md）
 - `config.json` — 正は `_schemas/ai-manifest.ts`。`prompt`（必須）・`model`・
   `skills`（トップレベル `skills/` 配下のディレクトリ名）・`env`・`inputs` / `outputs`
 - `model` が実行主体を決める：`claude-*` は Claude Code、`gpt-*` は Codex で走る
-  （選択肢は `AI_MODEL_GROUPS`）。認証は repo の Actions secrets に置く：Claude Code は
+  （選択肢は `AI_MODEL_GROUPS`）。値は系列（`claude-opus`・`gpt-sol` 等。その系列の最新モデルで
+  走り、新モデルが出れば自動で切り替わる）か、固定 ID（`claude-opus-5` 等。そのバージョンで
+  走り続ける）。省略時は `claude-opus`。認証は repo の Actions secrets に置く：Claude Code は
   `ANTHROPIC_API_KEY`（または `CLAUDE_CODE_OAUTH_TOKEN`）、Codex は明示的な `auth_mode` と対応する認証情報（下記「Codex の認証方式」参照）
   （`env` に宣言しなくても渡される）
 - `inputs` は1件以上・key 自由。値は `{ "schema": <JSON Schema>, "resume": true }` の形
@@ -89,7 +93,7 @@ Codex の AI 定義は `auth_mode` を必ず指定する。エディタの「認
 ```json
 {
   "prompt": "入力に返信してください",
-  "model": "gpt-5.6-luna",
+  "model": "gpt-luna",
   "auth_mode": "subscription",
   "inputs": { "in": { "schema": {} } },
   "outputs": { "main": { "type": "string" } }

package/package.json

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

package/skills/create-loop/SKILL.md

@@ -87,7 +87,8 @@ repo との矛盾・使用中ノードの削除は 409。**graph PUT は冪等
    - kind 別の固定ポート構成（human / wait / ai）は `port-spec.ts` の `kindPortsViolation` に従う
    - ループ変数（refs＝run 全体で読める key→値 の袋）が要るならトップレベルの `refs` に入れる。
      ノード単位の宣言やバインドは無い。handler は実行時に `refs.json` で全量を受け取り、
-     `end` の `refs` パッチで値を更新できる（config.json の `refs` はループ定義からの転写＝生成物）
+     `end` の `refs` パッチで値を更新できる（config.json の `refs` はループ定義からの転写＝生成物）。
+     キー `input` は予約（run の起動入力が自動で入る。定義に置くと 422）
    - `position_x` / `position_y` は左→右に流れる単純配置（例: x を 320 刻み、y は 240）
 5. **保存**：`PUT loops/{loopId}/graph`。400 / 422 / 409 ならメッセージを読んで直して再送。
 6. **報告**：エディタ URL `{MAWARU_APP_URL}/loops/{loopId}/edit` をユーザーに渡し、