@mawaru/sdk 0.33.0 → 0.35.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

@@ -1016,6 +1016,54 @@ describe("saveGraphBodySchema：開始/終了ノード（start/end kind）", ()
   })
 })
 
+// 合流は in を複数持てる（key 自由）＋ out(main)
+const joinNode = (inKeys: string[] = ["in_1", "in_2"]): TestNode => ({
+  ...makeNode([...inKeys.map((k) => port("in", k)), port("out", "main")]),
+  kind: "join",
+})
+
+describe("saveGraphBodySchema：合流ノード（join kind）", () => {
+  it("2本の枝を合流させるグラフを受け付ける", () => {
+    const a = makeNode(simplePorts())
+    const b = makeNode(simplePorts())
+    const j = joinNode()
+    const [in1, in2] = j.ports.filter((p) => p.io === "in")
+    const parsed = saveGraphBodySchema.parse({
+      nodes: [a, b, j],
+      connections: [
+        { from_port_id: outOf(a).id, to_port_id: in1?.id },
+        { from_port_id: outOf(b).id, to_port_id: in2?.id },
+      ],
+    })
+    expect(parsed.nodes.map((n) => n.kind)).toContain("join")
+  })
+
+  it("合流は複数置ける", () => {
+    expect(() =>
+      saveGraphBodySchema.parse({
+        nodes: [joinNode(), joinNode()],
+        connections: [],
+      }),
+    ).not.toThrow()
+  })
+
+  it("in が無い合流を拒否する", () => {
+    expect(() =>
+      saveGraphBodySchema.parse({ nodes: [joinNode([])], connections: [] }),
+    ).toThrow(/in ポートが1つ以上/)
+  })
+
+  it("out は main ちょうど1つ", () => {
+    const bad: TestNode = {
+      ...joinNode(),
+      ports: [port("in", "in_1"), port("out", "main"), port("out", "extra")],
+    }
+    expect(() =>
+      saveGraphBodySchema.parse({ nodes: [bad], connections: [] }),
+    ).toThrow(/join/)
+  })
+})
+
 describe("refsDefaultsOf（定義スキーマ→デフォルト値の袋）", () => {
   it("default を持つプロパティだけを値の袋に集める", () => {
     const defaults = refsDefaultsOf({

package/_schemas/graph.ts

@@ -74,6 +74,7 @@ export const editableNodeKindSchema = nodeKindSchema.extract([
   "human",
   "program",
   "wait",
+  "join",
 ])
 export type EditableNodeKind = z.infer<typeof editableNodeKindSchema>
 
@@ -87,6 +88,7 @@ export const graphNodeKindSchema = nodeKindSchema.extract([
   "start",
   "end",
   "component",
+  "join",
 ])
 export type GraphNodeKind = z.infer<typeof graphNodeKindSchema>
 
@@ -384,18 +386,19 @@ export const saveGraphBodySchema = z
         else outCount++
       })
       // end は「in は1つ以上」（複数ルートを別々の in で集約する）。
-      // ai も1つ以上（in は自由ポート：追加・削除・key 自由）。他 kind は1つ固定。
+      // ai も1つ以上（in は自由ポート：追加・削除・key 自由）。join も1つ以上
+      // （待ち合わせる枝ごとに in）。他 kind は1つ固定。
       // key の妥当性は kindPortsViolation が別途見る
-      const inCountOk =
-        node.kind === "end" || node.kind === "ai" ? inCount >= 1 : inCount === 1
+      const multiIn =
+        node.kind === "end" || node.kind === "ai" || node.kind === "join"
+      const inCountOk = multiIn ? inCount >= 1 : inCount === 1
       if (!inCountOk) {
         ctx.addIssue({
           code: "custom",
           path: ["nodes", i, "ports"],
-          message:
-            node.kind === "end" || node.kind === "ai"
-              ? "in ポートが1つ以上必要です"
-              : "in ポートはちょうど1つ必要です",
+          message: multiIn
+            ? "in ポートが1つ以上必要です"
+            : "in ポートはちょうど1つ必要です",
         })
       }
       if (outCount < 1) {

package/_schemas/node.ts

@@ -13,6 +13,9 @@ export const nodeKindSchema = z.enum([
   // コンポーネント（kind='component' の loop を配置して呼ぶ。子 run・戻り値あり。
   // docs/tasks/done/コンポーネント（ループの部品化と再利用）.md）
   "component",
+  // 合流（線のつながった入口が全部揃うまで待ち、key ごとにまとめて流す。
+  // docs/tasks/wip/合流ノード（並行分岐の待ち合わせ）.md）
+  "join",
 ])
 export type NodeKind = z.infer<typeof nodeKindSchema>
 

package/_schemas/port-spec.test.ts

@@ -782,6 +782,111 @@ describe("型伝播：fan-in（同じ in ポートへの流入2本以上）", ()
   })
 })
 
+describe("合流（join）", () => {
+  const findings = {
+    type: "object",
+    properties: { findings: { type: "array" } },
+    required: ["findings"],
+  }
+  const source = (schema: JsonSchema) => {
+    const out = port("out", "main", schema)
+    return {
+      node: { id: uuid(), kind: "program", ports: [port("in", "in"), out] },
+      out,
+    }
+  }
+  const named = (key: string, name: string): GraphPort => ({
+    ...port("in", key),
+    name,
+  })
+
+  it("join は in の key 自由・1つ以上、out は main ちょうど1つ", () => {
+    expect(
+      kindPortsViolation("join", [
+        port("in", "in_1"),
+        port("in", "in_2"),
+        port("out", "main"),
+      ]),
+    ).toBeNull()
+    expect(
+      kindPortsViolation("join", [port("in", "in_1"), port("out", "done")]),
+    ).toMatch(/join/)
+    expect(
+      kindPortsViolation("join", [
+        port("in", "in_1"),
+        port("out", "main"),
+        port("out", "extra"),
+      ]),
+    ).toMatch(/join/)
+    expect(kindPortsViolation("join", [port("out", "main")])).toMatch(/join/)
+  })
+
+  it("各 in は自分の上流から、out main は線のつながった in を key ごとに持つ object", () => {
+    const a = source(findings)
+    const b = source({ type: "string" })
+    const in1 = named("in_1", "スキャン")
+    const in2 = named("in_2", "依存チェック")
+    const loose = named("in_3", "未接続")
+    const out = port("out", "main")
+    const join = { id: uuid(), kind: "join", ports: [in1, in2, loose, out] }
+    const resolved = resolvePortSchemas(
+      [a.node, b.node, join],
+      [
+        { from_port_id: a.out.id, to_port_id: in1.id },
+        { from_port_id: b.out.id, to_port_id: in2.id },
+      ],
+    )
+    expect(resolved.get(in1.id)).toEqual(findings)
+    expect(resolved.get(in2.id)).toEqual({ type: "string" })
+    // 未接続の in は待たない＝出口にも出ない
+    expect(resolved.get(out.id)).toEqual({
+      type: "object",
+      properties: {
+        in_1: { ...findings, title: "スキャン" },
+        in_2: { type: "string", title: "依存チェック" },
+      },
+      required: ["in_1", "in_2"],
+    })
+  })
+
+  it("out main の型は下流の program の in へ鏡映される", () => {
+    const a = source(findings)
+    const in1 = port("in", "in_1")
+    const out = port("out", "main")
+    const join = { id: uuid(), kind: "join", ports: [in1, out] }
+    const nextIn = port("in", "in")
+    const next = {
+      id: uuid(),
+      kind: "program",
+      ports: [nextIn, port("out", "main")],
+    }
+    const resolved = resolvePortSchemas(
+      [a.node, join, next],
+      [
+        { from_port_id: a.out.id, to_port_id: in1.id },
+        { from_port_id: out.id, to_port_id: nextIn.id },
+      ],
+    )
+    expect(resolved.get(nextIn.id)).toEqual({
+      type: "object",
+      properties: { in_1: { ...findings, title: "in_1" } },
+      required: ["in_1"],
+    })
+  })
+
+  it("線が1本も無ければ out main は未宣言", () => {
+    const out = port("out", "main")
+    const join = {
+      id: uuid(),
+      kind: "join",
+      ports: [port("in", "in_1"), out],
+    }
+    expect(resolvePortSchemas([join], []).get(out.id)).toEqual(
+      UNDECLARED_SCHEMA,
+    )
+  })
+})
+
 describe("file 型（nominal）", () => {
   it("fileSchema はマーカー付き object、isFileSchema で識別できる", () => {
     const schema = fileSchema()

package/_schemas/port-spec.ts

@@ -198,6 +198,19 @@ export const kindPortsViolation = (
     }
     return null
   }
+  // join は out が main 1つ固定・in は1つ以上（待ち合わせる枝ごとに in。key 自由。
+  // 合流ノード（並行分岐の待ち合わせ）.md）
+  if (kind === "join") {
+    const outKeys = ports.filter((p) => p.io === "out").map((p) => p.key)
+    if (
+      outKeys.length !== 1 ||
+      outKeys[0] !== "main" ||
+      !ports.some((p) => p.io === "in")
+    ) {
+      return `join のポート構成は in 1つ以上と out "main" ちょうど1つです`
+    }
+    return null
+  }
   if (kind === "human") {
     const inKeys = ports.filter((p) => p.io === "in").map((p) => p.key)
     const outKeys = ports.filter((p) => p.io === "out").map((p) => p.key)
@@ -338,7 +351,8 @@ export type PropagationOptions<N> = {
 // resolvePortSchemas 内で行うが、初期スキーマを未宣言にするためここに含める。
 // start も導出ノード：out main は接続先の in から逆向きに転写し、in は out と同型
 // （run 入力契約＝接続先の入力宣言。開始ノードの入力契約を接続先から導出.md）
-const DERIVED_KINDS = new Set(["wait", "human", "end", "start"])
+// join も導出ノード（各 in は上流から、out main は線のつながった in を key ごとに持つ object）
+const DERIVED_KINDS = new Set(["wait", "human", "end", "start", "join"])
 
 // in を接続鏡映（sticky）するノード：接続元 out が具体型のときだけ上書き
 const MIRROR_KINDS = new Set(["program", "ai"])
@@ -428,6 +442,36 @@ export const resolvePortSchemas = <N extends PropagationNode>(
         }
         continue
       }
+      // join：各 in を自分の上流から導出（end と同じ）。out main は線のつながった in を
+      // key ごとに持つ object（「両方」を1段入れて持つ。中身を平らに混ぜると key が
+      // ぶつかる）。待つのは線のつながった in だけなので、未接続の in は出口に出さない
+      if (node.kind === "join") {
+        const properties: Record<string, JsonSchema> = {}
+        for (const port of node.ports) {
+          if (port.io !== "in") continue
+          const srcs = inbound.get(port.id) ?? []
+          const schema = mergeInboundSchemas(
+            srcs.map((id) => resolved.get(id) ?? UNDECLARED_SCHEMA),
+          )
+          assign(port.id, schema)
+          if (srcs.length > 0) {
+            properties[port.key] = { ...schema, title: port.name }
+          }
+        }
+        const outMain = node.ports.find(
+          (p) => p.io === "out" && p.key === "main",
+        )
+        const keys = Object.keys(properties)
+        if (outMain) {
+          assign(
+            outMain.id,
+            keys.length > 0
+              ? { type: "object", properties, required: keys }
+              : UNDECLARED_SCHEMA,
+          )
+        }
+        continue
+      }
       const isMirror = MIRROR_KINDS.has(node.kind)
       if (!DERIVED_KINDS.has(node.kind) && !isMirror) continue
       // 鏡映（program / ai）：全ての in が対象。具体型が流れてきたときだけ上書きする

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

@@ -11,6 +11,7 @@ export type LoopRefs = z.infer<typeof loopRefsSchema>;
 export declare const EMPTY_LOOP_REFS: LoopRefs;
 export declare const refsDefaultsOf: (refs: LoopRefs) => RefsBag;
 export declare const editableNodeKindSchema: z.ZodEnum<{
+    join: "join";
     ai: "ai";
     human: "human";
     program: "program";
@@ -19,6 +20,7 @@ export declare const editableNodeKindSchema: z.ZodEnum<{
 export type EditableNodeKind = z.infer<typeof editableNodeKindSchema>;
 export declare const graphNodeKindSchema: z.ZodEnum<{
     start: "start";
+    join: "join";
     ai: "ai";
     human: "human";
     program: "program";
@@ -131,6 +133,7 @@ export declare const graphNodeSchema: z.ZodObject<{
     node_key: z.ZodOptional<z.ZodUUID>;
     kind: z.ZodEnum<{
         start: "start";
+        join: "join";
         ai: "ai";
         human: "human";
         program: "program";
@@ -230,6 +233,7 @@ export declare const saveGraphBodySchema: z.ZodObject<{
         node_key: z.ZodOptional<z.ZodUUID>;
         kind: z.ZodEnum<{
             start: "start";
+            join: "join";
             ai: "ai";
             human: "human";
             program: "program";

package/dist/_schemas/graph.js

@@ -52,6 +52,7 @@ export const editableNodeKindSchema = nodeKindSchema.extract([
     "human",
     "program",
     "wait",
+    "join",
 ]);
 // グラフ一括保存で受け付ける kind（パレット作成の4種＋構造ノード start/end）。
 // start/end はパレットに出さないが、seed 済みなので全置換ボディには常に含まれる
@@ -63,6 +64,7 @@ export const graphNodeKindSchema = nodeKindSchema.extract([
     "start",
     "end",
     "component",
+    "join",
 ]);
 // Wait ノードの kind 別設定（node_waits の wait_type に対応する判別ユニオン）。
 // duration=経過秒、cron=cron 式（次に来る該当時刻まで1回待つ）。
@@ -319,14 +321,16 @@ export const saveGraphBodySchema = z
                 outCount++;
         });
         // end は「in は1つ以上」（複数ルートを別々の in で集約する）。
-        // ai も1つ以上（in は自由ポート：追加・削除・key 自由）。他 kind は1つ固定。
+        // ai も1つ以上（in は自由ポート：追加・削除・key 自由）。join も1つ以上
+        // （待ち合わせる枝ごとに in）。他 kind は1つ固定。
         // key の妥当性は kindPortsViolation が別途見る
-        const inCountOk = node.kind === "end" || node.kind === "ai" ? inCount >= 1 : inCount === 1;
+        const multiIn = node.kind === "end" || node.kind === "ai" || node.kind === "join";
+        const inCountOk = multiIn ? inCount >= 1 : inCount === 1;
         if (!inCountOk) {
             ctx.addIssue({
                 code: "custom",
                 path: ["nodes", i, "ports"],
-                message: node.kind === "end" || node.kind === "ai"
+                message: multiIn
                     ? "in ポートが1つ以上必要です"
                     : "in ポートはちょうど1つ必要です",
             });

package/dist/_schemas/node.d.ts

@@ -1,6 +1,7 @@
 import { z } from "zod";
 export declare const nodeKindSchema: z.ZodEnum<{
     start: "start";
+    join: "join";
     ai: "ai";
     human: "human";
     program: "program";

package/dist/_schemas/node.js

@@ -12,6 +12,9 @@ export const nodeKindSchema = z.enum([
     // コンポーネント（kind='component' の loop を配置して呼ぶ。子 run・戻り値あり。
     // docs/tasks/done/コンポーネント（ループの部品化と再利用）.md）
     "component",
+    // 合流（線のつながった入口が全部揃うまで待ち、key ごとにまとめて流す。
+    // docs/tasks/wip/合流ノード（並行分岐の待ち合わせ）.md）
+    "join",
 ]);
 // ポート key（input/output 用の参照キー）の規則（db.md §2）。
 // name（ユーザーが見る表示名）は自由テキスト

package/dist/_schemas/port-spec.js

@@ -165,6 +165,17 @@ export const kindPortsViolation = (kind, ports) => {
         }
         return null;
     }
+    // join は out が main 1つ固定・in は1つ以上（待ち合わせる枝ごとに in。key 自由。
+    // 合流ノード（並行分岐の待ち合わせ）.md）
+    if (kind === "join") {
+        const outKeys = ports.filter((p) => p.io === "out").map((p) => p.key);
+        if (outKeys.length !== 1 ||
+            outKeys[0] !== "main" ||
+            !ports.some((p) => p.io === "in")) {
+            return `join のポート構成は in 1つ以上と out "main" ちょうど1つです`;
+        }
+        return null;
+    }
     if (kind === "human") {
         const inKeys = ports.filter((p) => p.io === "in").map((p) => p.key);
         const outKeys = ports.filter((p) => p.io === "out").map((p) => p.key);
@@ -263,7 +274,8 @@ export const COPY_UPSTREAM_SCHEMA = "T";
 // resolvePortSchemas 内で行うが、初期スキーマを未宣言にするためここに含める。
 // start も導出ノード：out main は接続先の in から逆向きに転写し、in は out と同型
 // （run 入力契約＝接続先の入力宣言。開始ノードの入力契約を接続先から導出.md）
-const DERIVED_KINDS = new Set(["wait", "human", "end", "start"]);
+// join も導出ノード（各 in は上流から、out main は線のつながった in を key ごとに持つ object）
+const DERIVED_KINDS = new Set(["wait", "human", "end", "start", "join"]);
 // in を接続鏡映（sticky）するノード：接続元 out が具体型のときだけ上書き
 const MIRROR_KINDS = new Set(["program", "ai"]);
 const isDerivedPort = (kind, port) => DERIVED_KINDS.has(kind) &&
@@ -331,6 +343,30 @@ export const resolvePortSchemas = (nodes, connections, options) => {
                 }
                 continue;
             }
+            // join：各 in を自分の上流から導出（end と同じ）。out main は線のつながった in を
+            // key ごとに持つ object（「両方」を1段入れて持つ。中身を平らに混ぜると key が
+            // ぶつかる）。待つのは線のつながった in だけなので、未接続の in は出口に出さない
+            if (node.kind === "join") {
+                const properties = {};
+                for (const port of node.ports) {
+                    if (port.io !== "in")
+                        continue;
+                    const srcs = inbound.get(port.id) ?? [];
+                    const schema = mergeInboundSchemas(srcs.map((id) => resolved.get(id) ?? UNDECLARED_SCHEMA));
+                    assign(port.id, schema);
+                    if (srcs.length > 0) {
+                        properties[port.key] = { ...schema, title: port.name };
+                    }
+                }
+                const outMain = node.ports.find((p) => p.io === "out" && p.key === "main");
+                const keys = Object.keys(properties);
+                if (outMain) {
+                    assign(outMain.id, keys.length > 0
+                        ? { type: "object", properties, required: keys }
+                        : UNDECLARED_SCHEMA);
+                }
+                continue;
+            }
             const isMirror = MIRROR_KINDS.has(node.kind);
             if (!DERIVED_KINDS.has(node.kind) && !isMirror)
                 continue;

package/docs/development.md

@@ -49,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 }` の形
@@ -91,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.33.0",
+  "version": "0.35.0",
   "description": "mawaru 実行 repo の開発 SDK。契約スキーマ（config.json 規約・ループ graph API）の正 ＋ typegen / validate CLI",
   "type": "module",
   "bin": {

package/skills/create-loop/SKILL.md

@@ -73,7 +73,10 @@ repo との矛盾・使用中ノードの削除は 409。**graph PUT は冪等
 
 ## 手順
 
-1. **設計**：要件から必要なノード（program / ai / human / wait）と流れを決め、ユーザーに一言で確認する。
+1. **設計**：要件から必要なノード（program / ai / human / wait / join）と流れを決め、ユーザーに一言で確認する。
+   1つの出口から複数の線を引くと枝が並行に走る（fan-out）。枝の結果を待ち合わせるときは
+   合流（`join`）を置く：線のつながった入口が全部揃うまで待ち、`{ [入口の key]: 値 }` にまとめて
+   `main` から流す。並行した枝を合流させずに同じノード（待機など）へ戻すと、枝の数だけ走り続ける。
 2. **repo 側の準備**：足りない program / ai は `nodes/program/<dir>/` / `nodes/ai/<dir>/` に作る
    （config.json → `npx mawaru typegen` → main.ts 実装 → `npx mawaru validate`）。
    **AI ノードの決定論的な処理は prompt ではなく `setup.sh` に書く**（下記）。
@@ -84,7 +87,8 @@ repo との矛盾・使用中ノードの削除は 409。**graph PUT は冪等
    - node / port の `id` はクライアント採番（`uuidgen` などで UUID を作る）
    - program / ai ノードの ports は repo の config.json の inputs / outputs をそのまま写す
      （in ポート key は `in`、out ポートは outputs の各 key）
-   - kind 別の固定ポート構成（human / wait / ai）は `port-spec.ts` の `kindPortsViolation` に従う
+   - kind 別の固定ポート構成（human / wait / ai / join）は `port-spec.ts` の `kindPortsViolation` に従う。
+     join は in を枝の数だけ（key 自由。例 `in_1`, `in_2`）＋ out `main`。出口の型は自動で決まる
    - ループ変数（refs＝run 全体で読める key→値 の袋）が要るならトップレベルの `refs` に入れる。
      ノード単位の宣言やバインドは無い。handler は実行時に `refs.json` で全量を受け取り、
      `end` の `refs` パッチで値を更新できる（config.json の `refs` はループ定義からの転写＝生成物）。