@oomol-lab/open-connector 1.9.0 → 1.9.1

package/assets/open-connector/catalog/apps/kaonavi.json

@@ -0,0 +1,1723 @@
+{
+  "service": "kaonavi",
+  "displayName": "Kaonavi",
+  "homepageUrl": "https://www.kaonavi.jp/",
+  "categories": [
+    "Productivity"
+  ],
+  "authTypes": [
+    "custom_credential"
+  ],
+  "auth": [
+    {
+      "type": "custom_credential",
+      "fields": [
+        {
+          "key": "consumerKey",
+          "label": "Consumer Key",
+          "inputType": "text",
+          "secret": false,
+          "required": true,
+          "description": "Find the Consumer Key under Administrator Functions > Public API v2 Information > Authentication Information. Enable the required resource operations: https://developer.kaonavi.jp/api/v2.0/index.html"
+        },
+        {
+          "key": "consumerSecret",
+          "label": "Consumer Secret",
+          "inputType": "password",
+          "secret": true,
+          "required": true,
+          "description": "Copy the paired Consumer Secret from Public API v2 Information. Temporary tokens are obtained automatically: https://developer.kaonavi.jp/api/v2.0/index.html"
+        }
+      ]
+    }
+  ],
+  "actions": [
+    {
+      "id": "kaonavi.append_sheet_records",
+      "service": "kaonavi",
+      "name": "append_sheet_records",
+      "description": "Append records to a multiple-record personnel sheet. Single-record sheets are not supported.",
+      "operationType": "write",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "sheetId": {
+            "type": "integer",
+            "description": "Sheet identifier."
+          },
+          "members": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "code": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Employee code."
+                },
+                "records": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "custom_fields": {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "properties": {
+                            "id": {
+                              "type": "integer",
+                              "description": "Custom field identifier."
+                            },
+                            "values": {
+                              "type": "array",
+                              "items": {
+                                "type": "string",
+                                "description": "Field value."
+                              },
+                              "description": "Field values; multiple values are supported only for checkboxes. Use an empty string to clear a value."
+                            }
+                          },
+                          "additionalProperties": false,
+                          "required": [
+                            "id",
+                            "values"
+                          ],
+                          "description": "Custom field value."
+                        },
+                        "description": "Custom field values; consult the field layout for types and allowed values."
+                      }
+                    },
+                    "additionalProperties": false,
+                    "description": "Sheet record."
+                  },
+                  "description": "Ordered records. For a multiple-record sheet update, provide the complete replacement set for this employee; append uses only the new records."
+                }
+              },
+              "additionalProperties": false,
+              "required": [
+                "code",
+                "records"
+              ],
+              "description": "Sheet records for an employee."
+            },
+            "description": "Employee sheet records.",
+            "minItems": 1
+          },
+          "dryRun": {
+            "type": "boolean",
+            "description": "Validate without changing data. Defaults to false."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "sheetId",
+          "members"
+        ],
+        "description": "Personnel sheet mutation request."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "task_id": {
+            "type": "integer",
+            "description": "Submitted task identifier."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Submitted asynchronous task; use get_task to check completion. A successful submission does not mean the mutation has completed."
+      },
+      "asyncLifecycle": {
+        "startActionId": "kaonavi.append_sheet_records",
+        "statusActionId": "kaonavi.get_task"
+      }
+    },
+    {
+      "id": "kaonavi.create_members",
+      "service": "kaonavi",
+      "name": "create_members",
+      "description": "Create employees with their basic fields and department assignments. Consult get_member_layout for required fields.",
+      "operationType": "write",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "members": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "code": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Employee code."
+                },
+                "name": {
+                  "type": "string",
+                  "description": "Employee name."
+                },
+                "name_kana": {
+                  "type": "string",
+                  "description": "Phonetic employee name."
+                },
+                "mail": {
+                  "type": "string",
+                  "description": "Employee email address."
+                },
+                "entered_date": {
+                  "type": "string",
+                  "description": "Employment start date, or an empty string to clear it."
+                },
+                "retired_date": {
+                  "type": "string",
+                  "description": "Employment end date, or an empty string to clear it."
+                },
+                "gender": {
+                  "type": "string",
+                  "description": "Gender value from the employee layout."
+                },
+                "birthday": {
+                  "type": "string",
+                  "description": "Birth date, or an empty string to clear it."
+                },
+                "department": {
+                  "type": "object",
+                  "properties": {
+                    "code": {
+                      "type": "string",
+                      "description": "Department code; an empty string clears the assignment."
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "code"
+                  ],
+                  "description": "Department assignment; use a code from list_departments."
+                },
+                "sub_departments": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "code": {
+                        "type": "string",
+                        "description": "Department code; an empty string clears the assignment."
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "code"
+                    ],
+                    "description": "Department assignment; use a code from list_departments."
+                  },
+                  "description": "Secondary department assignments."
+                },
+                "custom_fields": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "integer",
+                        "description": "Custom field identifier."
+                      },
+                      "values": {
+                        "type": "array",
+                        "items": {
+                          "type": "string",
+                          "description": "Field value."
+                        },
+                        "description": "Field values; multiple values are supported only for checkboxes. Use an empty string to clear a value."
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "id",
+                      "values"
+                    ],
+                    "description": "Custom field value."
+                  },
+                  "description": "Custom field values; consult the field layout for types and allowed values."
+                }
+              },
+              "additionalProperties": false,
+              "required": [
+                "code"
+              ],
+              "description": "Employee fields; required fields and allowed values depend on get_member_layout. Omitted fields remain unchanged during updates."
+            },
+            "description": "Employees to create or update.",
+            "minItems": 1
+          },
+          "dryRun": {
+            "type": "boolean",
+            "description": "Validate without changing data. Defaults to false."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "members"
+        ],
+        "description": "Employee mutation request."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "task_id": {
+            "type": "integer",
+            "description": "Submitted task identifier."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Submitted asynchronous task; use get_task to check completion. A successful submission does not mean the mutation has completed."
+      },
+      "asyncLifecycle": {
+        "startActionId": "kaonavi.create_members",
+        "statusActionId": "kaonavi.get_task"
+      }
+    },
+    {
+      "id": "kaonavi.create_user",
+      "service": "kaonavi",
+      "name": "create_user",
+      "description": "Create a Kaonavi login user linked to an employee.",
+      "operationType": "write",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "user": {
+            "type": "object",
+            "properties": {
+              "email": {
+                "type": "string",
+                "description": "Login email address."
+              },
+              "member_code": {
+                "type": "string",
+                "description": "Linked employee code."
+              },
+              "password": {
+                "type": "string",
+                "description": "Login password."
+              },
+              "role": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "integer",
+                    "description": "Role identifier from list_roles."
+                  }
+                },
+                "additionalProperties": false,
+                "required": [
+                  "id"
+                ],
+                "description": "User role."
+              },
+              "is_active": {
+                "type": "boolean",
+                "description": "Whether the account is enabled; false disables login."
+              },
+              "password_locked": {
+                "type": "boolean",
+                "description": "Whether password login is locked."
+              },
+              "use_smartphone": {
+                "type": "boolean",
+                "description": "Whether smartphone browser access is enabled."
+              },
+              "use_native_app": {
+                "type": "boolean",
+                "description": "Whether native mobile app access is enabled."
+              }
+            },
+            "additionalProperties": false,
+            "required": [
+              "email",
+              "member_code",
+              "password",
+              "role"
+            ],
+            "description": "New login user. Unspecified account settings use Kaonavi defaults; secure access cannot be configured through this API."
+          },
+          "dryRun": {
+            "type": "boolean",
+            "description": "Validate without changing data. Defaults to false."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "user"
+        ],
+        "description": "User creation request."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "description": "User identifier."
+          },
+          "email": {
+            "type": "string",
+            "description": "Login email address."
+          },
+          "member_code": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "Linked employee code, or null."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Linked employee code, or null."
+          },
+          "role": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "integer",
+                "description": "Role identifier."
+              },
+              "name": {
+                "type": "string",
+                "description": "Role name."
+              },
+              "type": {
+                "type": "string",
+                "description": "Role type."
+              }
+            },
+            "additionalProperties": true,
+            "description": "Assigned role."
+          },
+          "is_active": {
+            "type": "boolean",
+            "description": "Whether the account is enabled."
+          },
+          "password_locked": {
+            "type": "boolean",
+            "description": "Whether password login is locked."
+          },
+          "use_smartphone": {
+            "type": "boolean",
+            "description": "Whether smartphone browser access is enabled."
+          },
+          "use_native_app": {
+            "type": "boolean",
+            "description": "Whether native mobile app access is enabled."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Created or updated login user."
+      }
+    },
+    {
+      "id": "kaonavi.create_users",
+      "service": "kaonavi",
+      "name": "create_users",
+      "description": "Create multiple Kaonavi login users asynchronously.",
+      "operationType": "write",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "users": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "email": {
+                  "type": "string",
+                  "description": "Login email address."
+                },
+                "member_code": {
+                  "type": "string",
+                  "description": "Linked employee code."
+                },
+                "password": {
+                  "type": "string",
+                  "description": "Login password."
+                },
+                "role": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "integer",
+                      "description": "Role identifier from list_roles."
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "id"
+                  ],
+                  "description": "User role."
+                },
+                "is_active": {
+                  "type": "boolean",
+                  "description": "Whether the account is enabled; false disables login."
+                },
+                "password_locked": {
+                  "type": "boolean",
+                  "description": "Whether password login is locked."
+                },
+                "use_smartphone": {
+                  "type": "boolean",
+                  "description": "Whether smartphone browser access is enabled."
+                },
+                "use_native_app": {
+                  "type": "boolean",
+                  "description": "Whether native mobile app access is enabled."
+                }
+              },
+              "additionalProperties": false,
+              "required": [
+                "email",
+                "member_code",
+                "password",
+                "role"
+              ],
+              "description": "New login user. Unspecified account settings use Kaonavi defaults; secure access cannot be configured through this API."
+            },
+            "description": "Users to create.",
+            "minItems": 1
+          },
+          "dryRun": {
+            "type": "boolean",
+            "description": "Validate without changing data. Defaults to false."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "users"
+        ],
+        "description": "Bulk user creation request."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "task_id": {
+            "type": "integer",
+            "description": "Submitted task identifier."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Submitted asynchronous task; use get_task to check completion. A successful submission does not mean the mutation has completed."
+      },
+      "asyncLifecycle": {
+        "startActionId": "kaonavi.create_users",
+        "statusActionId": "kaonavi.get_task"
+      }
+    },
+    {
+      "id": "kaonavi.delete_user",
+      "service": "kaonavi",
+      "name": "delete_user",
+      "description": "Delete a Kaonavi login user.",
+      "operationType": "destructive",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "userId": {
+            "type": "integer",
+            "description": "User identifier."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "userId"
+        ],
+        "description": "User deletion request."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "success": {
+            "type": "boolean",
+            "description": "Whether the user was deleted."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "success"
+        ],
+        "description": "Deletion result."
+      }
+    },
+    {
+      "id": "kaonavi.get_enum_options",
+      "service": "kaonavi",
+      "name": "get_enum_options",
+      "description": "Get master options for one custom field.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "customFieldId": {
+            "type": "integer",
+            "description": "Custom field identifier."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "customFieldId"
+        ],
+        "description": "Custom field lookup."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "description": "Custom field identifier."
+          },
+          "name": {
+            "type": "string",
+            "description": "Custom field name."
+          },
+          "sheet_name": {
+            "type": "string",
+            "description": "Sheet name."
+          },
+          "enum_option_data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "Provider-defined record fields."
+            },
+            "description": "Master options."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Master options for a custom field."
+      }
+    },
+    {
+      "id": "kaonavi.get_member_layout",
+      "service": "kaonavi",
+      "name": "get_member_layout",
+      "description": "Get employee field definitions and required-field settings.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "getCalcType": {
+            "type": "boolean",
+            "description": "Include calculation field types. Defaults to false."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Layout query options."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "custom_fields": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "Provider-defined record fields."
+            },
+            "description": "Custom employee field definitions."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Employee field layout, keyed by native field names."
+      }
+    },
+    {
+      "id": "kaonavi.get_sheet",
+      "service": "kaonavi",
+      "name": "get_sheet",
+      "description": "Get personnel sheet records, optionally filtered by member update date.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "sheetId": {
+            "type": "integer",
+            "description": "Sheet identifier."
+          },
+          "updatedSince": {
+            "type": "string",
+            "description": "Only records updated on or after this date (YYYY-MM-DD).",
+            "format": "date"
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "sheetId"
+        ],
+        "description": "Sheet data query."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "description": "Sheet identifier."
+          },
+          "name": {
+            "type": "string",
+            "description": "Sheet name."
+          },
+          "record_type": {
+            "type": "integer",
+            "description": "Zero for single-record sheets; one for multiple-record sheets."
+          },
+          "updated_at": {
+            "type": "string",
+            "description": "Last update timestamp."
+          },
+          "member_data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "Provider-defined record fields."
+            },
+            "description": "Employee sheet records and custom field values."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Personnel sheet data."
+      }
+    },
+    {
+      "id": "kaonavi.get_sheet_layout",
+      "service": "kaonavi",
+      "name": "get_sheet_layout",
+      "description": "Get the field layout of a personnel sheet.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "sheetId": {
+            "type": "integer",
+            "description": "Sheet identifier."
+          },
+          "getCalcType": {
+            "type": "boolean",
+            "description": "Include calculation field types. Defaults to false."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "sheetId"
+        ],
+        "description": "Sheet layout query."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "description": "Sheet identifier."
+          },
+          "name": {
+            "type": "string",
+            "description": "Sheet name."
+          },
+          "record_type": {
+            "type": "integer",
+            "description": "Zero for single-record sheets; one for multiple-record sheets."
+          },
+          "custom_fields": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "Provider-defined record fields."
+            },
+            "description": "Custom field definitions."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Sheet layout and custom field definitions."
+      }
+    },
+    {
+      "id": "kaonavi.get_task",
+      "service": "kaonavi",
+      "name": "get_task",
+      "description": "Get the status and messages of an asynchronous Kaonavi task.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "taskId": {
+            "type": "integer",
+            "description": "Task identifier."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "taskId"
+        ],
+        "description": "Task lookup."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "description": "Task identifier."
+          },
+          "status": {
+            "type": "string",
+            "description": "Task status: OK, NG, ERROR, WAITING, or RUNNING."
+          },
+          "messages": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "description": "Task message."
+            },
+            "description": "Task validation or execution messages."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Asynchronous task status."
+      }
+    },
+    {
+      "id": "kaonavi.get_user",
+      "service": "kaonavi",
+      "name": "get_user",
+      "description": "Get a Kaonavi login user by ID.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "userId": {
+            "type": "integer",
+            "description": "User identifier."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "userId"
+        ],
+        "description": "User lookup."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "description": "User identifier."
+          },
+          "email": {
+            "type": "string",
+            "description": "Login email address."
+          },
+          "member_code": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "Linked employee code, or null."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Linked employee code, or null."
+          },
+          "last_login_at": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "Last login timestamp, or null."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Last login timestamp, or null."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Login user and account settings."
+      }
+    },
+    {
+      "id": "kaonavi.list_departments",
+      "service": "kaonavi",
+      "name": "list_departments",
+      "description": "List organizational departments and their parent relationships.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false,
+        "description": "No input fields are required."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "department_data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "Provider-defined record fields."
+            },
+            "description": "Returned records."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Organization tree records."
+      }
+    },
+    {
+      "id": "kaonavi.list_enum_options",
+      "service": "kaonavi",
+      "name": "list_enum_options",
+      "description": "List master options for custom fields.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false,
+        "description": "No input fields are required."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "custom_field_data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "Provider-defined record fields."
+            },
+            "description": "Returned records."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Custom fields and their master options."
+      }
+    },
+    {
+      "id": "kaonavi.list_member_photo_urls",
+      "service": "kaonavi",
+      "name": "list_member_photo_urls",
+      "description": "Get employee photo download URLs. Links expire after 15 minutes; request new URLs when needed.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "updatedSince": {
+            "type": "string",
+            "description": "Only files updated on or after this date (YYYY-MM-DD).",
+            "format": "date"
+          }
+        },
+        "additionalProperties": false,
+        "description": "Employee photo query."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "member_data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "code": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Employee code."
+                },
+                "file_name": {
+                  "type": "string",
+                  "description": "File name."
+                },
+                "download_url": {
+                  "type": "string",
+                  "description": "Signed download URL, valid for 15 minutes after issuance."
+                },
+                "updated_at": {
+                  "type": "string",
+                  "description": "Last file update timestamp."
+                }
+              },
+              "additionalProperties": true,
+              "description": "Employee photo."
+            },
+            "description": "Employee photos."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Employee photo download links."
+      }
+    },
+    {
+      "id": "kaonavi.list_members",
+      "service": "kaonavi",
+      "name": "list_members",
+      "description": "List employee records, optionally filtered by update date.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "updatedSince": {
+            "type": "string",
+            "description": "Only records updated on or after this date (YYYY-MM-DD).",
+            "format": "date"
+          }
+        },
+        "additionalProperties": false,
+        "description": "Member query options."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "updated_at": {
+            "type": "string",
+            "description": "Last update timestamp."
+          },
+          "member_data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "Provider-defined record fields."
+            },
+            "description": "Employee records, including custom fields."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Employee records and last update time."
+      }
+    },
+    {
+      "id": "kaonavi.list_roles",
+      "service": "kaonavi",
+      "name": "list_roles",
+      "description": "List available Kaonavi user roles.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false,
+        "description": "No input fields are required."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "role_data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "Provider-defined record fields."
+            },
+            "description": "Returned records."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Available user roles."
+      }
+    },
+    {
+      "id": "kaonavi.list_sheet_file_urls",
+      "service": "kaonavi",
+      "name": "list_sheet_file_urls",
+      "description": "Get download URLs for files in a sheet attachment field. Only records containing files are returned. Links expire after 15 minutes.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "sheetId": {
+            "type": "integer",
+            "description": "Sheet identifier."
+          },
+          "customFieldId": {
+            "type": "integer",
+            "description": "Custom field identifier."
+          },
+          "updatedSince": {
+            "type": "string",
+            "description": "Only files updated on or after this date (YYYY-MM-DD).",
+            "format": "date"
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "sheetId",
+          "customFieldId"
+        ],
+        "description": "Sheet attachment query."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "member_data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "code": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Employee code."
+                },
+                "records": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "file_name": {
+                        "type": "string",
+                        "description": "File name."
+                      },
+                      "download_url": {
+                        "type": "string",
+                        "description": "Signed download URL, valid for 15 minutes after issuance."
+                      },
+                      "updated_at": {
+                        "type": "string",
+                        "description": "Last file update timestamp."
+                      }
+                    },
+                    "additionalProperties": true,
+                    "description": "Attached file."
+                  },
+                  "description": "Attached files."
+                }
+              },
+              "additionalProperties": true,
+              "description": "Employee attachment records."
+            },
+            "description": "Employee attachments."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Sheet attachment download links."
+      }
+    },
+    {
+      "id": "kaonavi.list_sheet_layouts",
+      "service": "kaonavi",
+      "name": "list_sheet_layouts",
+      "description": "List accessible personnel sheet layouts and custom field definitions.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "getCalcType": {
+            "type": "boolean",
+            "description": "Include calculation field types. Defaults to false."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Layout query options."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "sheets": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "integer",
+                  "description": "Sheet identifier."
+                },
+                "name": {
+                  "type": "string",
+                  "description": "Sheet name."
+                },
+                "record_type": {
+                  "type": "integer",
+                  "description": "Zero for single-record sheets; one for multiple-record sheets."
+                },
+                "custom_fields": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {},
+                    "additionalProperties": true,
+                    "description": "Provider-defined record fields."
+                  },
+                  "description": "Custom field definitions."
+                }
+              },
+              "additionalProperties": true,
+              "description": "Sheet layout and custom field definitions."
+            },
+            "description": "Sheet layouts."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Available sheet layouts."
+      }
+    },
+    {
+      "id": "kaonavi.list_users",
+      "service": "kaonavi",
+      "name": "list_users",
+      "description": "List Kaonavi login users and account settings.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false,
+        "description": "No input fields are required."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "user_data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "Provider-defined record fields."
+            },
+            "description": "Returned records."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Login user records."
+      }
+    },
+    {
+      "id": "kaonavi.update_members",
+      "service": "kaonavi",
+      "name": "update_members",
+      "description": "Update only the supplied employee fields. Omitted fields remain unchanged; use an empty string to clear a value.",
+      "operationType": "write",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "members": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "code": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Employee code."
+                },
+                "name": {
+                  "type": "string",
+                  "description": "Employee name."
+                },
+                "name_kana": {
+                  "type": "string",
+                  "description": "Phonetic employee name."
+                },
+                "mail": {
+                  "type": "string",
+                  "description": "Employee email address."
+                },
+                "entered_date": {
+                  "type": "string",
+                  "description": "Employment start date, or an empty string to clear it."
+                },
+                "retired_date": {
+                  "type": "string",
+                  "description": "Employment end date, or an empty string to clear it."
+                },
+                "gender": {
+                  "type": "string",
+                  "description": "Gender value from the employee layout."
+                },
+                "birthday": {
+                  "type": "string",
+                  "description": "Birth date, or an empty string to clear it."
+                },
+                "department": {
+                  "type": "object",
+                  "properties": {
+                    "code": {
+                      "type": "string",
+                      "description": "Department code; an empty string clears the assignment."
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "code"
+                  ],
+                  "description": "Department assignment; use a code from list_departments."
+                },
+                "sub_departments": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "code": {
+                        "type": "string",
+                        "description": "Department code; an empty string clears the assignment."
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "code"
+                    ],
+                    "description": "Department assignment; use a code from list_departments."
+                  },
+                  "description": "Secondary department assignments."
+                },
+                "custom_fields": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "id": {
+                        "type": "integer",
+                        "description": "Custom field identifier."
+                      },
+                      "values": {
+                        "type": "array",
+                        "items": {
+                          "type": "string",
+                          "description": "Field value."
+                        },
+                        "description": "Field values; multiple values are supported only for checkboxes. Use an empty string to clear a value."
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "id",
+                      "values"
+                    ],
+                    "description": "Custom field value."
+                  },
+                  "description": "Custom field values; consult the field layout for types and allowed values."
+                }
+              },
+              "additionalProperties": false,
+              "required": [
+                "code"
+              ],
+              "description": "Employee fields; required fields and allowed values depend on get_member_layout. Omitted fields remain unchanged during updates."
+            },
+            "description": "Employees to create or update.",
+            "minItems": 1
+          },
+          "dryRun": {
+            "type": "boolean",
+            "description": "Validate without changing data. Defaults to false."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "members"
+        ],
+        "description": "Employee mutation request."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "task_id": {
+            "type": "integer",
+            "description": "Submitted task identifier."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Submitted asynchronous task; use get_task to check completion. A successful submission does not mean the mutation has completed."
+      },
+      "asyncLifecycle": {
+        "startActionId": "kaonavi.update_members",
+        "statusActionId": "kaonavi.get_task"
+      }
+    },
+    {
+      "id": "kaonavi.update_sheet",
+      "service": "kaonavi",
+      "name": "update_sheet",
+      "description": "Update a personnel sheet. Single-record sheets preserve omitted fields; multiple-record sheets replace the entire record set for each supplied employee. Other employees remain unchanged.",
+      "operationType": "write",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "sheetId": {
+            "type": "integer",
+            "description": "Sheet identifier."
+          },
+          "members": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "code": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Employee code."
+                },
+                "records": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "custom_fields": {
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "properties": {
+                            "id": {
+                              "type": "integer",
+                              "description": "Custom field identifier."
+                            },
+                            "values": {
+                              "type": "array",
+                              "items": {
+                                "type": "string",
+                                "description": "Field value."
+                              },
+                              "description": "Field values; multiple values are supported only for checkboxes. Use an empty string to clear a value."
+                            }
+                          },
+                          "additionalProperties": false,
+                          "required": [
+                            "id",
+                            "values"
+                          ],
+                          "description": "Custom field value."
+                        },
+                        "description": "Custom field values; consult the field layout for types and allowed values."
+                      }
+                    },
+                    "additionalProperties": false,
+                    "description": "Sheet record."
+                  },
+                  "description": "Ordered records. For a multiple-record sheet update, provide the complete replacement set for this employee; append uses only the new records."
+                }
+              },
+              "additionalProperties": false,
+              "required": [
+                "code",
+                "records"
+              ],
+              "description": "Sheet records for an employee."
+            },
+            "description": "Employee sheet records.",
+            "minItems": 1
+          },
+          "dryRun": {
+            "type": "boolean",
+            "description": "Validate without changing data. Defaults to false."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "sheetId",
+          "members"
+        ],
+        "description": "Personnel sheet mutation request."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "task_id": {
+            "type": "integer",
+            "description": "Submitted task identifier."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Submitted asynchronous task; use get_task to check completion. A successful submission does not mean the mutation has completed."
+      },
+      "asyncLifecycle": {
+        "startActionId": "kaonavi.update_sheet",
+        "statusActionId": "kaonavi.get_task"
+      }
+    },
+    {
+      "id": "kaonavi.update_user",
+      "service": "kaonavi",
+      "name": "update_user",
+      "description": "Update a login user, including role, password, access settings, or disabling the account. Omitted fields remain unchanged.",
+      "operationType": "destructive",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "userId": {
+            "type": "integer",
+            "description": "User identifier."
+          },
+          "user": {
+            "type": "object",
+            "properties": {
+              "email": {
+                "type": "string",
+                "description": "Login email address."
+              },
+              "member_code": {
+                "type": "string",
+                "description": "Linked employee code."
+              },
+              "password": {
+                "type": "string",
+                "description": "Login password."
+              },
+              "role": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "integer",
+                    "description": "Role identifier from list_roles."
+                  }
+                },
+                "additionalProperties": false,
+                "required": [
+                  "id"
+                ],
+                "description": "User role."
+              },
+              "is_active": {
+                "type": "boolean",
+                "description": "Whether the account is enabled; false disables login."
+              },
+              "password_locked": {
+                "type": "boolean",
+                "description": "Whether password login is locked."
+              },
+              "use_smartphone": {
+                "type": "boolean",
+                "description": "Whether smartphone browser access is enabled."
+              },
+              "use_native_app": {
+                "type": "boolean",
+                "description": "Whether native mobile app access is enabled."
+              }
+            },
+            "additionalProperties": false,
+            "description": "User fields to update; omitted fields remain unchanged. Secure access cannot be changed through this API.",
+            "minProperties": 1
+          },
+          "dryRun": {
+            "type": "boolean",
+            "description": "Validate without changing data. Defaults to false."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "userId",
+          "user"
+        ],
+        "description": "User update request."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "description": "User identifier."
+          },
+          "email": {
+            "type": "string",
+            "description": "Login email address."
+          },
+          "member_code": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "Linked employee code, or null."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Linked employee code, or null."
+          },
+          "role": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "integer",
+                "description": "Role identifier."
+              },
+              "name": {
+                "type": "string",
+                "description": "Role name."
+              },
+              "type": {
+                "type": "string",
+                "description": "Role type."
+              }
+            },
+            "additionalProperties": true,
+            "description": "Assigned role."
+          },
+          "is_active": {
+            "type": "boolean",
+            "description": "Whether the account is enabled."
+          },
+          "password_locked": {
+            "type": "boolean",
+            "description": "Whether password login is locked."
+          },
+          "use_smartphone": {
+            "type": "boolean",
+            "description": "Whether smartphone browser access is enabled."
+          },
+          "use_native_app": {
+            "type": "boolean",
+            "description": "Whether native mobile app access is enabled."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Created or updated login user."
+      }
+    },
+    {
+      "id": "kaonavi.update_users",
+      "service": "kaonavi",
+      "name": "update_users",
+      "description": "Update multiple login users asynchronously, including disabling accounts. Omitted fields remain unchanged.",
+      "operationType": "destructive",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "users": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "integer",
+                  "description": "User identifier."
+                },
+                "email": {
+                  "type": "string",
+                  "description": "Login email address."
+                },
+                "member_code": {
+                  "type": "string",
+                  "description": "Linked employee code."
+                },
+                "password": {
+                  "type": "string",
+                  "description": "Login password."
+                },
+                "role": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "integer",
+                      "description": "Role identifier from list_roles."
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "id"
+                  ],
+                  "description": "User role."
+                },
+                "is_active": {
+                  "type": "boolean",
+                  "description": "Whether the account is enabled; false disables login."
+                },
+                "password_locked": {
+                  "type": "boolean",
+                  "description": "Whether password login is locked."
+                },
+                "use_smartphone": {
+                  "type": "boolean",
+                  "description": "Whether smartphone browser access is enabled."
+                },
+                "use_native_app": {
+                  "type": "boolean",
+                  "description": "Whether native mobile app access is enabled."
+                }
+              },
+              "additionalProperties": false,
+              "required": [
+                "id"
+              ],
+              "description": "User update fields."
+            },
+            "description": "Users to update, identified by user ID.",
+            "minItems": 1
+          },
+          "dryRun": {
+            "type": "boolean",
+            "description": "Validate without changing data. Defaults to false."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "users"
+        ],
+        "description": "Bulk user update request."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "task_id": {
+            "type": "integer",
+            "description": "Submitted task identifier."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Submitted asynchronous task; use get_task to check completion. A successful submission does not mean the mutation has completed."
+      },
+      "asyncLifecycle": {
+        "startActionId": "kaonavi.update_users",
+        "statusActionId": "kaonavi.get_task"
+      }
+    }
+  ]
+}