@mawaru/sdk 0.23.0 → 0.24.0

package/_schemas/graph.ts

@@ -199,6 +199,9 @@ export type HumanConfig = z.infer<typeof humanConfigSchema>
 // （docs/tasks/done/コンポーネント（ループの部品化と再利用）.md）
 export const componentConfigSchema = z.object({
   component_loop_id: z.uuid(),
+  // 親が pin する子の版。省略＝子の最新 published（グループは owner の draft と対）。
+  // 版管理（draftとpublish）.md
+  component_loop_version_id: z.uuid().optional(),
   // 配置の設定値：子 loop の refs 定義（default/required）への上書き。
   // 子 run 起動時の起動時指定として渡る（省略＝上書きなし。検証は保存 API と
   // 起動時の mergeRefs が行う。コンポーネントの設定値（refs）と1ノードのコンポーネント化.md）
@@ -259,7 +262,10 @@ export const NODE_ICON_PRESETS = [
 export type NodeIconPresetKey = (typeof NODE_ICON_PRESETS)[number]["key"]
 
 export const graphNodeSchema = z.object({
+  // 版の行 id（新規ノードは client 採番）。既存ノードの突き合わせは node_key で行う
   id: z.uuid(),
+  // 版を跨いだ「同一ノード」の識別子。省略＝新規ノード（サーバーが発行）
+  node_key: z.uuid().optional(),
   kind: graphNodeKindSchema,
   name: z.string().min(1),
   ports: z.array(graphPortSchema),

package/dist/_schemas/graph.d.ts

@@ -64,6 +64,7 @@ export declare const humanConfigSchema: z.ZodObject<{
 export type HumanConfig = z.infer<typeof humanConfigSchema>;
 export declare const componentConfigSchema: z.ZodObject<{
     component_loop_id: z.ZodUUID;
+    component_loop_version_id: z.ZodOptional<z.ZodUUID>;
     refs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
 export type ComponentConfig = z.infer<typeof componentConfigSchema>;
@@ -126,6 +127,7 @@ export declare const NODE_ICON_PRESETS: readonly [{
 export type NodeIconPresetKey = (typeof NODE_ICON_PRESETS)[number]["key"];
 export declare const graphNodeSchema: z.ZodObject<{
     id: z.ZodUUID;
+    node_key: z.ZodOptional<z.ZodUUID>;
     kind: z.ZodEnum<{
         start: "start";
         ai: "ai";
@@ -202,6 +204,7 @@ export declare const graphNodeSchema: z.ZodObject<{
     }, z.core.$strip>>;
     component: z.ZodOptional<z.ZodObject<{
         component_loop_id: z.ZodUUID;
+        component_loop_version_id: z.ZodOptional<z.ZodUUID>;
         refs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
@@ -223,6 +226,7 @@ export type GraphConnection = z.infer<typeof graphConnectionSchema>;
 export declare const saveGraphBodySchema: z.ZodObject<{
     nodes: z.ZodArray<z.ZodObject<{
         id: z.ZodUUID;
+        node_key: z.ZodOptional<z.ZodUUID>;
         kind: z.ZodEnum<{
             start: "start";
             ai: "ai";
@@ -299,6 +303,7 @@ export declare const saveGraphBodySchema: z.ZodObject<{
         }, z.core.$strip>>;
         component: z.ZodOptional<z.ZodObject<{
             component_loop_id: z.ZodUUID;
+            component_loop_version_id: z.ZodOptional<z.ZodUUID>;
             refs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;

package/dist/_schemas/graph.js

@@ -154,6 +154,9 @@ export const humanConfigSchema = z.object({
 // （docs/tasks/done/コンポーネント（ループの部品化と再利用）.md）
 export const componentConfigSchema = z.object({
     component_loop_id: z.uuid(),
+    // 親が pin する子の版。省略＝子の最新 published（グループは owner の draft と対）。
+    // 版管理（draftとpublish）.md
+    component_loop_version_id: z.uuid().optional(),
     // 配置の設定値：子 loop の refs 定義（default/required）への上書き。
     // 子 run 起動時の起動時指定として渡る（省略＝上書きなし。検証は保存 API と
     // 起動時の mergeRefs が行う。コンポーネントの設定値（refs）と1ノードのコンポーネント化.md）
@@ -203,7 +206,10 @@ export const NODE_ICON_PRESETS = [
     { key: "sentry", name: "Sentry" },
 ];
 export const graphNodeSchema = z.object({
+    // 版の行 id（新規ノードは client 採番）。既存ノードの突き合わせは node_key で行う
     id: z.uuid(),
+    // 版を跨いだ「同一ノード」の識別子。省略＝新規ノード（サーバーが発行）
+    node_key: z.uuid().optional(),
     kind: graphNodeKindSchema,
     name: z.string().min(1),
     ports: z.array(graphPortSchema),

package/package.json

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