@mawaru/sdk 0.5.0

package/_schemas/ai-manifest.test.ts

@@ -0,0 +1,135 @@
+import { describe, expect, it } from "vitest"
+import { aiManifestSchema } from "./ai-manifest.js"
+import { envelopeSchemaOf } from "./port-spec.js"
+
+const envelope = envelopeSchemaOf({ type: "string" })
+
+const valid = {
+  name: "返信下書き",
+  description: "問い合わせに FAQ を根拠に返信下書きを作る",
+  prompt: "問い合わせ内容を読み、FAQ を根拠に返信の下書きを作ってください。",
+  model: "claude-opus-4-8",
+  skills: ["answer-faq"],
+  env: ["ANTHROPIC_API_KEY"],
+  inputs: { in: {} },
+  outputs: { main: envelope },
+}
+
+describe("aiManifestSchema", () => {
+  it("フル指定の manifest を受け付ける", () => {
+    const manifest = aiManifestSchema.parse(valid)
+    expect(manifest.name).toBe("返信下書き")
+    expect(manifest.prompt).toContain("下書き")
+    expect(manifest.model).toBe("claude-opus-4-8")
+    expect(manifest.skills).toEqual(["answer-faq"])
+    expect(manifest.env).toEqual(["ANTHROPIC_API_KEY"])
+  })
+
+  it("name / description / model / skills / env は省略できる（既定値が補われる）", () => {
+    const manifest = aiManifestSchema.parse({
+      prompt: valid.prompt,
+      inputs: { in: {} },
+      outputs: { main: envelope },
+    })
+    expect(manifest.name).toBeUndefined()
+    expect(manifest.model).toBe("claude-opus-4-8")
+    expect(manifest.skills).toEqual([])
+    expect(manifest.env).toEqual([])
+  })
+
+  it("prompt は必須・非空（repo に置く時点で完成品）", () => {
+    expect(() => aiManifestSchema.parse({ ...valid, prompt: "" })).toThrow()
+    const { prompt: _prompt, ...rest } = valid
+    expect(() => aiManifestSchema.parse(rest)).toThrow()
+  })
+
+  it("選択肢にないモデルを拒否する", () => {
+    expect(() =>
+      aiManifestSchema.parse({ ...valid, model: "gpt-4o" }),
+    ).toThrow()
+  })
+
+  it('inputs は "in" の1件だけ', () => {
+    expect(() => aiManifestSchema.parse({ ...valid, inputs: {} })).toThrow()
+    expect(() =>
+      aiManifestSchema.parse({ ...valid, inputs: { data: {} } }),
+    ).toThrow()
+    expect(() =>
+      aiManifestSchema.parse({ ...valid, inputs: { in: {}, extra: {} } }),
+    ).toThrow()
+  })
+
+  it("outputs は1件以上・key 自由（AI の複数出口＝分岐）", () => {
+    expect(() => aiManifestSchema.parse({ ...valid, outputs: {} })).toThrow()
+    expect(() =>
+      aiManifestSchema.parse({ ...valid, outputs: { draft: envelope } }),
+    ).not.toThrow()
+    expect(() =>
+      aiManifestSchema.parse({
+        ...valid,
+        outputs: { spam: envelope, sales: envelope, support: envelope },
+      }),
+    ).not.toThrow()
+  })
+
+  it("outputs は全出口に封筒型 { data, description } を強制する（data は任意の型）", () => {
+    for (const schema of [
+      {}, // any
+      { type: "string" },
+      { type: "object", properties: { text: { type: "string" } } }, // data キーなし
+      {
+        type: "object",
+        properties: { data: { type: "string" } }, // description なし
+        required: ["data"],
+      },
+      {
+        type: "object",
+        properties: {
+          data: { type: "string" },
+          description: { type: "string" }, // description が optional
+        },
+        required: ["data"],
+      },
+    ]) {
+      expect(() =>
+        aiManifestSchema.parse({ ...valid, outputs: { main: schema } }),
+      ).toThrow()
+      // 妥当な出口に混ざっていても、封筒型でない出口があれば弾く
+      expect(() =>
+        aiManifestSchema.parse({
+          ...valid,
+          outputs: { main: envelope, other: schema },
+        }),
+      ).toThrow()
+    }
+    // data が任意の構造（カタログ外の object）でも通る
+    expect(() =>
+      aiManifestSchema.parse({
+        ...valid,
+        outputs: {
+          main: envelopeSchemaOf({
+            type: "object",
+            properties: {
+              title: { type: "string" },
+              count: { type: "number" },
+            },
+            required: ["title"],
+          }),
+        },
+      }),
+    ).not.toThrow()
+  })
+
+  it("ディレクトリ名として不正な skill 名を拒否する", () => {
+    for (const skill of ["", "../etc", ".hidden", "a/b", "a b"]) {
+      expect(() =>
+        aiManifestSchema.parse({ ...valid, skills: [skill] }),
+      ).toThrow()
+    }
+  })
+
+  it("env は非空文字列の配列", () => {
+    expect(() => aiManifestSchema.parse({ ...valid, env: [""] })).toThrow()
+    expect(() => aiManifestSchema.parse({ ...valid, env: "X" })).toThrow()
+  })
+})

package/_schemas/ai-manifest.ts

@@ -0,0 +1,76 @@
+import { z } from "zod"
+import { jsonSchemaSchema } from "./node.js"
+import { isAiEnvelopeSchema } from "./port-spec.js"
+
+// AI ノードのモデル選択肢（既定は Opus：下書き品質が価値の中心。費用はユーザー持ち）
+export const AI_MODELS = [
+  "claude-opus-4-8",
+  "claude-sonnet-5",
+  "claude-haiku-4-5",
+] as const
+export const aiModelSchema = z.enum(AI_MODELS)
+export type AiModel = z.infer<typeof aiModelSchema>
+export const DEFAULT_AI_MODEL = "claude-opus-4-8" satisfies AiModel
+
+// nodes/ai/<dir>/config.json（実行repoの構造見直し）。AI ノードの定義（prompt/model/skills/
+// 入出力スキーマ/env）は repo 側が正で、エディタが取り込んで ports を自動生成する
+// （実行時の正は ports テーブルのまま。プログラム規約 v2 と同じ関係）。
+// env は実行に必要な secret 名の宣言（runner が宣言分だけを子プロセスへ渡す）
+export const aiManifestSchema = z
+  .object({
+    // 表示名（省略時はディレクトリ名）
+    name: z.string().min(1).optional(),
+    description: z.string().optional(),
+    // repo に置く時点で完成品なので必須（DB 時代の「書きかけ空文字」は廃止）
+    prompt: z.string().min(1),
+    model: aiModelSchema.default(DEFAULT_AI_MODEL),
+    // 同 repo のトップレベル skills/ 配下のディレクトリ名
+    skills: z
+      .array(
+        z
+          .string()
+          .regex(
+            /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/,
+            "skill 名はディレクトリ名（英数字始まり）で指定してください",
+          ),
+      )
+      .default([]),
+    env: z.array(z.string().min(1)).default([]),
+    // 実行中の経過（発話・ツール呼び出し）を Actions ログへ逐次出すデバッグフラグ。
+    // 通常時は config.json にキーを書かない（インスペクタも false ならキーを消す）
+    verbose: z.boolean().optional(),
+    inputs: z.record(z.string(), jsonSchemaSchema),
+    outputs: z.record(z.string(), jsonSchemaSchema),
+  })
+  .superRefine((manifest, ctx) => {
+    // グラフ側の既存制約（in ちょうど1つ・key "in"）に整合させる
+    const inKeys = Object.keys(manifest.inputs)
+    if (inKeys.length !== 1 || inKeys[0] !== "in") {
+      ctx.addIssue({
+        code: "custom",
+        path: ["inputs"],
+        message: 'inputs は "in" の1件だけ宣言してください（join 導入まで）',
+      })
+    }
+    // outputs は1件以上・key 自由（複数出口＝分岐。AIノードの複数出口（分岐）.md）
+    if (Object.keys(manifest.outputs).length < 1) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["outputs"],
+        message: "outputs は1件以上宣言してください",
+      })
+    }
+    // Human 承認 UI が依存する封筒型 { data: T, description: string } を全出口に強制
+    // （どの出口も human に接続できる、という AI ノードの不変条件。saveGraph と同じ判定。
+    // data＝T は任意の JSON Schema）
+    for (const [key, schema] of Object.entries(manifest.outputs)) {
+      if (!isAiEnvelopeSchema(schema)) {
+        ctx.addIssue({
+          code: "custom",
+          path: ["outputs", key],
+          message: `outputs.${key} は封筒型 { data, description } で宣言してください（両方必須・description は string）`,
+        })
+      }
+    }
+  })
+export type AiManifest = z.infer<typeof aiManifestSchema>